@hydradb/sdk 2.1.1 → 2.1.3

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

@@ -0,0 +1,129 @@
+"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.FeedbackClient = 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 FeedbackClient {
+    constructor(options = {}) {
+        this._options = (0, BaseClient_js_1.normalizeClientOptionsWithAuth)(options);
+    }
+    /**
+     * Record feedback about a query that already ran, correlated by the `request_id` returned in that query's `response.meta.request_id`. Accepts a free-text comment plus an optional positive/negative/neutral rating, and is intended for both end users and agents (`source`). Feeds internal retrieval-quality validation; it does not change the result of the original query.
+     *
+     * @param {HydraDB.FeedbackSubmitRequest} request
+     * @param {FeedbackClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link HydraDB.BadRequestError}
+     * @throws {@link HydraDB.NotFoundError}
+     * @throws {@link HydraDB.InternalServerError}
+     *
+     * @example
+     *     await client.feedback.submit({
+     *         feedback: {
+     *             "key": "value"
+     *         }
+     *     })
+     */
+    submit(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__submit(request, requestOptions));
+    }
+    async __submit(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.Default, "feedback"),
+            method: "POST",
+            headers: _headers,
+            contentType: "application/json",
+            queryString: core.url.queryBuilder().mergeAdditional(requestOptions?.queryParams).build(),
+            requestType: "json",
+            body: serializers.FeedbackSubmitRequest.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.HandlerEnvelopeFeedbackSubmitResponse.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(serializers.HandlerErrorResponse.parseOrThrow(_response.error.body, {
+                        unrecognizedObjectKeys: "passthrough",
+                        allowUnrecognizedUnionMembers: true,
+                        allowUnrecognizedEnumValues: true,
+                        skipValidation: true,
+                        breadcrumbsPrefix: ["response"],
+                    }), _response.rawResponse);
+                case 404:
+                    throw new HydraDB.NotFoundError(_response.error.body, _response.rawResponse);
+                case 500:
+                    throw new HydraDB.InternalServerError(_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", "/feedback");
+    }
+}
+exports.FeedbackClient = FeedbackClient;

package/dist/api/resources/feedback/client/index.d.ts

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

package/dist/api/resources/feedback/client/index.js

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

package/dist/api/resources/feedback/exports.d.ts

@@ -0,0 +1,2 @@
+export { FeedbackClient } from "./client/Client.js";
+export * from "./client/index.js";

package/dist/api/resources/feedback/exports.js

@@ -0,0 +1,21 @@
+"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 __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 });
+exports.FeedbackClient = void 0;
+var Client_js_1 = require("./client/Client.js");
+Object.defineProperty(exports, "FeedbackClient", { enumerable: true, get: function () { return Client_js_1.FeedbackClient; } });
+__exportStar(require("./client/index.js"), exports);

package/dist/api/resources/feedback/index.d.ts

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

package/dist/api/resources/feedback/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/api/resources/index.d.ts

@@ -5,5 +5,6 @@ export * as context from "./context/index.js";
 export * from "./context/types/index.js";
 export * from "./databases/client/requests/index.js";
 export * as databases from "./databases/index.js";
+export * as feedback from "./feedback/index.js";
 export * from "./webhooks/client/requests/index.js";
 export * as webhooks from "./webhooks/index.js";

package/dist/api/resources/index.js

@@ -36,7 +36,7 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.webhooks = exports.databases = exports.context = exports.connectors = void 0;
+exports.webhooks = exports.feedback = exports.databases = exports.context = exports.connectors = void 0;
 __exportStar(require("./connectors/client/requests/index.js"), exports);
 exports.connectors = __importStar(require("./connectors/index.js"));
 __exportStar(require("./context/client/requests/index.js"), exports);
@@ -44,5 +44,6 @@ exports.context = __importStar(require("./context/index.js"));
 __exportStar(require("./context/types/index.js"), exports);
 __exportStar(require("./databases/client/requests/index.js"), exports);
 exports.databases = __importStar(require("./databases/index.js"));
+exports.feedback = __importStar(require("./feedback/index.js"));
 __exportStar(require("./webhooks/client/requests/index.js"), exports);
 exports.webhooks = __importStar(require("./webhooks/index.js"));

package/dist/api/resources/webhooks/client/Client.d.ts

@@ -21,7 +21,7 @@ export declare class WebhooksClient {
     get(requestOptions?: WebhooksClient.RequestOptions): core.HttpResponsePromise<HydraDB.HandlerEnvelopeWebhooksWebhookGetResponse>;
     private __get;
     /**
-     * Register the indexing webhook for this API key's org.
+     * Register the indexing webhook for this API key's org. Set `generate_signing_secret` to register and enable signing in one request; the secret is returned once on the response. Omitting `signing_secret` preserves any secret already configured - to disable signing, call DELETE /webhooks/indexing/signing-secret.
      *
      * @param {HydraDB.WebhooksWebhookRegisterRequest} request
      * @param {WebhooksClient.RequestOptions} requestOptions - Request-specific configuration.
@@ -86,6 +86,32 @@ export declare class WebhooksClient {
      */
     retryDelivery(request: HydraDB.RetryDeliveryWebhooksRequest, requestOptions?: WebhooksClient.RequestOptions): core.HttpResponsePromise<HydraDB.HandlerEnvelopeWebhooksRetryResponse>;
     private __retryDelivery;
+    /**
+     * Generates a signing secret, or stores one you supply. The plaintext is returned exactly once and cannot be retrieved afterwards. Takes effect immediately, so rotate only once your receiver accepts the new secret.
+     *
+     * @param {HydraDB.WebhooksSigningSecretRequest} request
+     * @param {WebhooksClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link HydraDB.NotFoundError}
+     * @throws {@link HydraDB.UnprocessableEntityError}
+     *
+     * @example
+     *     await client.webhooks.setSigningSecret()
+     */
+    setSigningSecret(request?: HydraDB.WebhooksSigningSecretRequest, requestOptions?: WebhooksClient.RequestOptions): core.HttpResponsePromise<HydraDB.HandlerEnvelopeWebhooksSigningSecretResponse>;
+    private __setSigningSecret;
+    /**
+     * Removes the stored signing secret. Deliveries stop carrying the X-HydraDB-Signature header. This is the only way to disable signing - editing a registration never clears the secret.
+     *
+     * @param {WebhooksClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link HydraDB.NotFoundError}
+     *
+     * @example
+     *     await client.webhooks.clearSigningSecret()
+     */
+    clearSigningSecret(requestOptions?: WebhooksClient.RequestOptions): core.HttpResponsePromise<HydraDB.HandlerEnvelopeWebhooksWebhookRegisterResponse>;
+    private __clearSigningSecret;
     /**
      * Send a test webhook event to the registered endpoint to verify connectivity.
      *

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

@@ -96,7 +96,7 @@ class WebhooksClient {
         return (0, handleNonStatusCodeError_js_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "GET", "/webhooks/indexing");
     }
     /**
-     * Register the indexing webhook for this API key's org.
+     * Register the indexing webhook for this API key's org. Set `generate_signing_secret` to register and enable signing in one request; the secret is returned once on the response. Omitting `signing_secret` preserves any secret already configured - to disable signing, call DELETE /webhooks/indexing/signing-secret.
      *
      * @param {HydraDB.WebhooksWebhookRegisterRequest} request
      * @param {WebhooksClient.RequestOptions} requestOptions - Request-specific configuration.
@@ -395,6 +395,132 @@ class WebhooksClient {
         }
         return (0, handleNonStatusCodeError_js_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "POST", "/webhooks/indexing/deliveries/{delivery_id}/retry");
     }
+    /**
+     * Generates a signing secret, or stores one you supply. The plaintext is returned exactly once and cannot be retrieved afterwards. Takes effect immediately, so rotate only once your receiver accepts the new secret.
+     *
+     * @param {HydraDB.WebhooksSigningSecretRequest} request
+     * @param {WebhooksClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link HydraDB.NotFoundError}
+     * @throws {@link HydraDB.UnprocessableEntityError}
+     *
+     * @example
+     *     await client.webhooks.setSigningSecret()
+     */
+    setSigningSecret(request = {}, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__setSigningSecret(request, requestOptions));
+    }
+    async __setSigningSecret(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.Default, "webhooks/indexing/signing-secret"),
+            method: "POST",
+            headers: _headers,
+            contentType: "application/json",
+            queryString: core.url.queryBuilder().mergeAdditional(requestOptions?.queryParams).build(),
+            requestType: "json",
+            body: serializers.WebhooksSigningSecretRequest.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.HandlerEnvelopeWebhooksSigningSecretResponse.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 404:
+                    throw new HydraDB.NotFoundError(_response.error.body, _response.rawResponse);
+                case 422:
+                    throw new HydraDB.UnprocessableEntityError(serializers.HandlerErrorResponse.parseOrThrow(_response.error.body, {
+                        unrecognizedObjectKeys: "passthrough",
+                        allowUnrecognizedUnionMembers: true,
+                        allowUnrecognizedEnumValues: true,
+                        skipValidation: true,
+                        breadcrumbsPrefix: ["response"],
+                    }), _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", "/webhooks/indexing/signing-secret");
+    }
+    /**
+     * Removes the stored signing secret. Deliveries stop carrying the X-HydraDB-Signature header. This is the only way to disable signing - editing a registration never clears the secret.
+     *
+     * @param {WebhooksClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link HydraDB.NotFoundError}
+     *
+     * @example
+     *     await client.webhooks.clearSigningSecret()
+     */
+    clearSigningSecret(requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__clearSigningSecret(requestOptions));
+    }
+    async __clearSigningSecret(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.Default, "webhooks/indexing/signing-secret"),
+            method: "DELETE",
+            headers: _headers,
+            queryString: core.url.queryBuilder().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.HandlerEnvelopeWebhooksWebhookRegisterResponse.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 404:
+                    throw new HydraDB.NotFoundError(_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", "/webhooks/indexing/signing-secret");
+    }
     /**
      * Send a test webhook event to the registered endpoint to verify connectivity.
      *

package/dist/api/resources/webhooks/client/requests/WebhooksSigningSecretRequest.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @example
+ *     {}
+ */
+export interface WebhooksSigningSecretRequest {
+    /** Secret used to sign webhook payloads. Deliveries carry `X-HydraDB-Signature: sha256=<hex>`, the HMAC-SHA256 of the raw request body keyed by this secret. Minimum 16 characters when you supply your own; omit it and one is generated for you. On registration, omitting this field preserves any existing secret - to disable signing, call DELETE /webhooks/indexing/signing-secret. */
+    signingSecret?: string;
+}

package/dist/api/resources/webhooks/client/requests/WebhooksWebhookRegisterRequest.d.ts

@@ -5,7 +5,9 @@
 export interface WebhooksWebhookRegisterRequest {
     /** Event types to subscribe to (e.g. `["indexing.status_changed"]`). */
     eventTypes?: string[];
-    /** Optional secret used to sign webhook payloads for verification. Minimum 32 characters. */
+    /** Generate a signing secret as part of this request, so registering and enabling signing are one atomic operation. The secret is returned once on the response and cannot be retrieved later. Mutually exclusive with `signing_secret`. */
+    generateSigningSecret?: boolean;
+    /** Secret used to sign webhook payloads. Deliveries carry `X-HydraDB-Signature: sha256=<hex>`, the HMAC-SHA256 of the raw request body keyed by this secret. Minimum 16 characters when you supply your own; omit it and one is generated for you. On registration, omitting this field preserves any existing secret - to disable signing, call DELETE /webhooks/indexing/signing-secret. */
     signingSecret?: string;
     /** Endpoint URL to deliver webhook events to. */
     url?: string;

package/dist/api/resources/webhooks/client/requests/index.d.ts

@@ -1,4 +1,5 @@
 export type { GetDeliveryWebhooksRequest } from "./GetDeliveryWebhooksRequest.js";
 export type { ListDeliveriesWebhooksRequest } from "./ListDeliveriesWebhooksRequest.js";
 export type { RetryDeliveryWebhooksRequest } from "./RetryDeliveryWebhooksRequest.js";
+export type { WebhooksSigningSecretRequest } from "./WebhooksSigningSecretRequest.js";
 export type { WebhooksWebhookRegisterRequest } from "./WebhooksWebhookRegisterRequest.js";

package/dist/api/types/FeedbackGroundTruth.d.ts

@@ -0,0 +1,12 @@
+export interface FeedbackGroundTruth {
+    /**
+     * Answer is the response the caller expected — the text a correct system
+     * would have produced from the retrieved context.
+     */
+    answer?: string;
+    /**
+     * SourceIDs are the ingested source IDs that actually contain the answer,
+     * as returned in query results and accepted by /context endpoints.
+     */
+    sourceIds?: string[];
+}

package/dist/api/types/FeedbackRating.d.ts

@@ -0,0 +1,6 @@
+export declare const FeedbackRating: {
+    readonly Positive: "positive";
+    readonly Negative: "negative";
+    readonly Neutral: "neutral";
+};
+export type FeedbackRating = (typeof FeedbackRating)[keyof typeof FeedbackRating];

package/dist/api/types/FeedbackRating.js

@@ -0,0 +1,9 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FeedbackRating = void 0;
+exports.FeedbackRating = {
+    Positive: "positive",
+    Negative: "negative",
+    Neutral: "neutral",
+};

package/dist/api/types/FeedbackSource.d.ts

@@ -0,0 +1,5 @@
+export declare const FeedbackSource: {
+    readonly User: "user";
+    readonly Agent: "agent";
+};
+export type FeedbackSource = (typeof FeedbackSource)[keyof typeof FeedbackSource];

package/dist/api/types/FeedbackSource.js

@@ -0,0 +1,8 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FeedbackSource = void 0;
+exports.FeedbackSource = {
+    User: "user",
+    Agent: "agent",
+};

package/dist/api/types/FeedbackSubmitRequest.d.ts

@@ -0,0 +1,2 @@
+import type * as HydraDB from "../index.js";
+export type FeedbackSubmitRequest = HydraDB.FeedbackSubmitRequestFeedback | HydraDB.FeedbackSubmitRequestGroundTruth;

package/dist/api/types/FeedbackSubmitRequestFeedback.d.ts

@@ -0,0 +1,3 @@
+export interface FeedbackSubmitRequestFeedback {
+    feedback?: unknown;
+}

package/dist/api/types/FeedbackSubmitRequestGroundTruth.d.ts

@@ -0,0 +1,4 @@
+import type * as HydraDB from "../index.js";
+export interface FeedbackSubmitRequestGroundTruth {
+    groundTruth: HydraDB.FeedbackSubmitRequestGroundTruthGroundTruth;
+}

package/dist/api/types/FeedbackSubmitRequestGroundTruth.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/api/types/FeedbackSubmitRequestGroundTruthGroundTruth.d.ts

@@ -0,0 +1,2 @@
+import type * as HydraDB from "../index.js";
+export type FeedbackSubmitRequestGroundTruthGroundTruth = HydraDB.FeedbackSubmitRequestGroundTruthGroundTruthAnswer | HydraDB.FeedbackSubmitRequestGroundTruthGroundTruthSourceIds;

package/dist/api/types/FeedbackSubmitRequestGroundTruthGroundTruth.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/api/types/FeedbackSubmitRequestGroundTruthGroundTruthAnswer.d.ts

@@ -0,0 +1,3 @@
+export interface FeedbackSubmitRequestGroundTruthGroundTruthAnswer {
+    answer?: unknown;
+}

package/dist/api/types/FeedbackSubmitRequestGroundTruthGroundTruthAnswer.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/api/types/FeedbackSubmitRequestGroundTruthGroundTruthSourceIds.d.ts

@@ -0,0 +1,3 @@
+export interface FeedbackSubmitRequestGroundTruthGroundTruthSourceIds {
+    sourceIds?: unknown;
+}

package/dist/api/types/FeedbackSubmitRequestGroundTruthGroundTruthSourceIds.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/api/types/FeedbackSubmitResponse.d.ts

@@ -0,0 +1,12 @@
+export interface FeedbackSubmitResponse {
+    /** RFC3339 timestamp when the feedback was recorded. */
+    createdAt?: string;
+    /** Unique identifier assigned to this feedback submission. */
+    feedbackId?: string;
+    /** Human-readable result message. */
+    message?: string;
+    /** Whether the feedback was durably stored. */
+    recorded?: boolean;
+    /** The query request ID this feedback was recorded against. */
+    requestId?: string;
+}

package/dist/api/types/FeedbackSubmitResponse.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/api/types/FetchV2SourceFetchResponse.d.ts

@@ -17,6 +17,12 @@ export interface FetchV2SourceFetchResponse {
     presignedUrl?: string;
     /** File size in bytes. */
     sizeBytes?: number;
-    /** Whether the request succeeded. */
+    /**
+     * Deprecated for API clients: to decide whether the request succeeded,
+     * check the HTTP status code — 2xx is success — or equivalently the
+     * envelope's top-level `success`. This nested copy always carries the same
+     * value as that flag and never carries independent information. Still
+     * emitted unchanged for existing clients (PRO-1208).
+     */
     success?: boolean;
 }

package/dist/api/types/GithubComHydradbHydradbApplicationInternalServiceMetadataEditResult.d.ts

@@ -5,22 +5,40 @@ export interface GithubComHydradbHydradbApplicationInternalServiceMetadataEditRe
     chunkRowsMatched?: number;
     /** Number of MongoDB chunk rows modified by the source update. */
     chunkRowsModified?: number;
+    /** Collection that contained the source. Canonical name; mirrors the deprecated `sub_tenant_id` alias. */
+    collection?: string;
+    /** Owning database. Canonical name; mirrors the deprecated `tenant_id` alias. */
+    database?: string;
     /** Database metadata keys included in the update request. Canonical name; `tenant_metadata_keys` is a deprecated alias. */
     databaseMetadataKeys?: string[];
     /** Unique identifier for this resource. */
     id?: string;
-    /** Number of chunk rows synced to Milvus when sync was required. */
+    /** deprecated: use vector_rows_synced */
     milvusRowsSynced?: number;
-    /** Whether at least one changed database metadata field has dense or sparse embedding enabled. */
+    /**
+     * Deprecated: use vector_sync_required / vector_synced / vector_rows_synced.
+     * Retained as additive aliases for existing clients; carry the same values.
+     */
     milvusSyncRequired?: boolean;
-    /** Whether the Milvus metadata sync completed. Present when sync was required. */
+    /** deprecated: use vector_synced */
     milvusSynced?: boolean;
-    /** Collection that contained the source. */
+    /** deprecated: use collection */
     subTenantId?: string;
-    /** Owning database. */
+    /** deprecated: use database */
     tenantId?: string;
     /** deprecated: use database_metadata_keys */
     tenantMetadataKeys?: string[];
     /** Whether the source metadata was updated. */
     updated?: boolean;
+    /** Number of chunk rows synced to the vector store when sync was required. */
+    vectorRowsSynced?: number;
+    /**
+     * Vendor-neutral vector-sync signal (PRO-1185): the canonical field must not
+     * name the vector store. The milvus_* fields below are deprecated aliases kept
+     * for backward compatibility (additive change, not a rename) and carry the same
+     * values; they are slated for removal in a future major version.
+     */
+    vectorSyncRequired?: boolean;
+    /** Whether the vector store metadata sync completed. Present when sync was required. */
+    vectorSynced?: boolean;
 }

package/dist/api/types/GraphGraphRelationsResponse.d.ts

@@ -8,6 +8,12 @@ export interface GraphGraphRelationsResponse {
     nextCursor?: number;
     /** Array of triplet groups with evidence for each relationship. */
     relations?: HydraDB.GraphTripletWithEvidence[];
-    /** Whether the request succeeded. */
+    /**
+     * Deprecated for API clients: to decide whether the request succeeded,
+     * check the HTTP status code — 2xx is success — or equivalently the
+     * envelope's top-level `success`. This nested copy always carries the same
+     * value and never carries independent information. Still emitted unchanged
+     * for existing clients (PRO-1208).
+     */
     success?: boolean;
 }

package/dist/api/types/HandlerCatalogConnector.d.ts

@@ -0,0 +1,11 @@
+export interface HandlerCatalogConnector {
+    category?: string;
+    isAlpha?: boolean;
+    isBeta?: boolean;
+    moveitSupport?: boolean;
+    /** External provider being synced (e.g. `slack`, `github`, `linear`, `notion`, `gmail`). */
+    provider?: string;
+    /** Rank is the dashboard display order (lower first); null means unranked. */
+    rank?: number;
+    supported?: boolean;
+}

package/dist/api/types/HandlerCatalogConnector.js

@@ -0,0 +1,3 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });