@hydradb/sdk 2.1.2 → 2.1.4

package/dist/api/resources/connectors/client/requests/UpdateResourceAclConnectorsRequest.d.ts

@@ -0,0 +1,17 @@
+/**
+ * @example
+ *     {
+ *         id: "HydraDoc1234",
+ *         resourceId: "C0123456789",
+ *         body: {
+ *             "key": "value"
+ *         }
+ *     }
+ */
+export interface UpdateResourceAclConnectorsRequest {
+    /** Connector ID */
+    id: string;
+    /** Resource ID */
+    resourceId: string;
+    body: Record<string, unknown>;
+}

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

@@ -4,9 +4,12 @@ export type { DiscoverConnectorsRequest } from "./DiscoverConnectorsRequest.js";
 export type { GetConnectorsRequest } from "./GetConnectorsRequest.js";
 export type { HandlerConfigureReq } from "./HandlerConfigureReq.js";
 export type { HandlerConnectorCreateReq } from "./HandlerConnectorCreateReq.js";
+export type { HandlerConnectorUpdateReq } from "./HandlerConnectorUpdateReq.js";
 export type { HandlerDiscoverPreviewReq } from "./HandlerDiscoverPreviewReq.js";
 export type { HandlerResourceCreateReq } from "./HandlerResourceCreateReq.js";
 export type { ListConnectorsRequest } from "./ListConnectorsRequest.js";
 export type { ListResourcesConnectorsRequest } from "./ListResourcesConnectorsRequest.js";
 export type { PatchConnectorsIdCredentialsRequest } from "./PatchConnectorsIdCredentialsRequest.js";
+export type { StatusConnectorsRequest } from "./StatusConnectorsRequest.js";
 export type { SyncConnectorsRequest } from "./SyncConnectorsRequest.js";
+export type { UpdateResourceAclConnectorsRequest } from "./UpdateResourceAclConnectorsRequest.js";

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

@@ -13,10 +13,27 @@ export declare class ContextClient {
     /**
      * Delete one or more knowledge sources or memories by ID.
      *
+     * By default this endpoint answers 200 for every outcome, including a delete
+     * that removed nothing — check `data.deleted_count` and `data.results` rather
+     * than the status code.
+     *
+     * Send `X-HydraDB-Delete-Status: strict` to opt in to honest status codes: a
+     * delete that did not happen then answers 404/409/500 and never 200. This is
+     * the recommended mode for new integrations. On those failures the response
+     * `data` still carries the same `results` / `deleted_count` payload a 200
+     * carries, so per-id outcomes stay readable either way.
+     *
+     * The default is expected to become strict in a future release, at which
+     * point `X-HydraDB-Delete-Status: legacy` keeps the unconditional 200 for a
+     * caller that is not ready.
+     *
      * @param {HydraDB.SourcesV2SourceDeleteRequest} request
      * @param {ContextClient.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link HydraDB.BadRequestError}
+     * @throws {@link HydraDB.NotFoundError}
+     * @throws {@link HydraDB.ConflictError}
+     * @throws {@link HydraDB.InternalServerError}
      *
      * @example
      *     await client.context.delete()
@@ -40,7 +57,7 @@ export declare class ContextClient {
      *         database: "database"
      *     })
      */
-    ingest(request: HydraDB.IngestContextRequest, requestOptions?: ContextClient.RequestOptions): core.HttpResponsePromise<HydraDB.HandlerEnvelopeIngestionV2SourceUploadResponse>;
+    ingest(request: HydraDB.IngestContextRequest, requestOptions?: ContextClient.RequestOptions): core.HttpResponsePromise<HydraDB.HandlerEnvelopeIngestionV2IngestResponse>;
     private __ingest;
     /**
      * Fetch a previously ingested source's content, inferred content, and a downloadable URL.
@@ -74,7 +91,7 @@ export declare class ContextClient {
      * @example
      *     await client.context.list()
      */
-    list(request?: HydraDB.ListV2ListContentRequest, requestOptions?: ContextClient.RequestOptions): core.HttpResponsePromise<HydraDB.HandlerEnvelopeListV2SourceListResponse>;
+    list(request?: HydraDB.ListV2ListContentRequest, requestOptions?: ContextClient.RequestOptions): core.HttpResponsePromise<HydraDB.HandlerEnvelopeListV2ListResponse>;
     private __list;
     /**
      * Return knowledge-graph relations for a tenant or a single source.
@@ -114,6 +131,25 @@ export declare class ContextClient {
      */
     status(request: HydraDB.StatusContextRequest, requestOptions?: ContextClient.RequestOptions): core.HttpResponsePromise<HydraDB.HandlerEnvelopeIngestionV2BatchProcessingStatus>;
     private __status;
+    /**
+     * Return the connected subgraph of a source: every source reachable from it through source-level relations (RELATES_TO edges, shared thread, parent/child hierarchy, traversed BFS), the relations among them, and the auxiliary graph around them (entities, comments, attachments, actors). Chunk-level entity relations are not included.
+     *
+     * @param {HydraDB.SubgraphContextRequest} request
+     * @param {ContextClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link HydraDB.BadRequestError}
+     *
+     * @example
+     *     await client.context.subgraph({
+     *         database: "acme_corp",
+     *         collection: "team_docs",
+     *         tenantId: "tenant_1234",
+     *         subTenantId: "sub_tenant_4567",
+     *         id: "HydraDoc1234"
+     *     })
+     */
+    subgraph(request: HydraDB.SubgraphContextRequest, requestOptions?: ContextClient.RequestOptions): core.HttpResponsePromise<HydraDB.HandlerEnvelopeGraphSourceSubgraphResponse>;
+    private __subgraph;
     /**
      * Merge/upsert database_metadata and additional_metadata for one source. collection is required.
      *

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

@@ -50,10 +50,27 @@ class ContextClient {
     /**
      * Delete one or more knowledge sources or memories by ID.
      *
+     * By default this endpoint answers 200 for every outcome, including a delete
+     * that removed nothing — check `data.deleted_count` and `data.results` rather
+     * than the status code.
+     *
+     * Send `X-HydraDB-Delete-Status: strict` to opt in to honest status codes: a
+     * delete that did not happen then answers 404/409/500 and never 200. This is
+     * the recommended mode for new integrations. On those failures the response
+     * `data` still carries the same `results` / `deleted_count` payload a 200
+     * carries, so per-id outcomes stay readable either way.
+     *
+     * The default is expected to become strict in a future release, at which
+     * point `X-HydraDB-Delete-Status: legacy` keeps the unconditional 200 for a
+     * caller that is not ready.
+     *
      * @param {HydraDB.SourcesV2SourceDeleteRequest} request
      * @param {ContextClient.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link HydraDB.BadRequestError}
+     * @throws {@link HydraDB.NotFoundError}
+     * @throws {@link HydraDB.ConflictError}
+     * @throws {@link HydraDB.InternalServerError}
      *
      * @example
      *     await client.context.delete()
@@ -62,8 +79,12 @@ class ContextClient {
         return core.HttpResponsePromise.fromPromise(this.__delete(request, requestOptions));
     }
     async __delete(request = {}, requestOptions) {
+        const { hydraDbDeleteStatus, ..._body } = request;
         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 _headers = (0, headers_js_1.mergeHeaders)(_authRequest.headers, this._options?.headers, (0, headers_js_1.mergeOnlyDefinedHeaders)({
+            "X-HydraDB-Delete-Status": hydraDbDeleteStatus,
+            "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)) ??
@@ -73,7 +94,7 @@ class ContextClient {
             contentType: "application/json",
             queryString: core.url.queryBuilder().mergeAdditional(requestOptions?.queryParams).build(),
             requestType: "json",
-            body: serializers.SourcesV2SourceDeleteRequest.jsonOrThrow(request, {
+            body: serializers.SourcesV2SourceDeleteRequest.jsonOrThrow(_body, {
                 unrecognizedObjectKeys: "strip",
                 omitUndefined: true,
             }),
@@ -105,6 +126,12 @@ class ContextClient {
                         skipValidation: true,
                         breadcrumbsPrefix: ["response"],
                     }), _response.rawResponse);
+                case 404:
+                    throw new HydraDB.NotFoundError(_response.error.body, _response.rawResponse);
+                case 409:
+                    throw new HydraDB.ConflictError(_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,
@@ -195,7 +222,7 @@ class ContextClient {
         });
         if (_response.ok) {
             return {
-                data: serializers.HandlerEnvelopeIngestionV2SourceUploadResponse.parseOrThrow(_response.body, {
+                data: serializers.HandlerEnvelopeIngestionV2IngestResponse.parseOrThrow(_response.body, {
                     unrecognizedObjectKeys: "passthrough",
                     allowUnrecognizedUnionMembers: true,
                     allowUnrecognizedEnumValues: true,
@@ -272,7 +299,7 @@ class ContextClient {
         return core.HttpResponsePromise.fromPromise(this.__inspect(request, requestOptions));
     }
     async __inspect(request, requestOptions) {
-        const { id, database, collection, tenantId, subTenantId, expirySeconds, mode } = request;
+        const { id, database, collection, tenantId, subTenantId, expirySeconds, mode, acl } = request;
         const _queryParams = {
             id,
             database,
@@ -281,6 +308,7 @@ class ContextClient {
             sub_tenant_id: subTenantId,
             expiry_seconds: expirySeconds,
             mode,
+            acl,
         };
         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);
@@ -373,7 +401,7 @@ class ContextClient {
         });
         if (_response.ok) {
             return {
-                data: serializers.HandlerEnvelopeListV2SourceListResponse.parseOrThrow(_response.body, {
+                data: serializers.HandlerEnvelopeListV2ListResponse.parseOrThrow(_response.body, {
                     unrecognizedObjectKeys: "passthrough",
                     allowUnrecognizedUnionMembers: true,
                     allowUnrecognizedEnumValues: true,
@@ -424,7 +452,7 @@ class ContextClient {
         return core.HttpResponsePromise.fromPromise(this.__relations(request, requestOptions));
     }
     async __relations(request, requestOptions) {
-        const { database, collection, tenantId, subTenantId, id, type: type_, limit, cursor } = request;
+        const { database, collection, tenantId, subTenantId, id, type: type_, limit, cursor, acl } = request;
         const _queryParams = {
             database,
             collection,
@@ -439,6 +467,7 @@ class ContextClient {
                 : undefined,
             limit,
             cursor,
+            acl,
         };
         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);
@@ -572,6 +601,95 @@ class ContextClient {
         }
         return (0, handleNonStatusCodeError_js_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "GET", "/context/status");
     }
+    /**
+     * Return the connected subgraph of a source: every source reachable from it through source-level relations (RELATES_TO edges, shared thread, parent/child hierarchy, traversed BFS), the relations among them, and the auxiliary graph around them (entities, comments, attachments, actors). Chunk-level entity relations are not included.
+     *
+     * @param {HydraDB.SubgraphContextRequest} request
+     * @param {ContextClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link HydraDB.BadRequestError}
+     *
+     * @example
+     *     await client.context.subgraph({
+     *         database: "acme_corp",
+     *         collection: "team_docs",
+     *         tenantId: "tenant_1234",
+     *         subTenantId: "sub_tenant_4567",
+     *         id: "HydraDoc1234"
+     *     })
+     */
+    subgraph(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__subgraph(request, requestOptions));
+    }
+    async __subgraph(request, requestOptions) {
+        const { database, collection, tenantId, subTenantId, id, type: type_, depth, maxSources, acl } = request;
+        const _queryParams = {
+            database,
+            collection,
+            tenant_id: tenantId,
+            sub_tenant_id: subTenantId,
+            id,
+            type: type_ != null
+                ? serializers.SubgraphContextRequestType.jsonOrThrow(type_, {
+                    unrecognizedObjectKeys: "strip",
+                    omitUndefined: true,
+                })
+                : undefined,
+            depth,
+            max_sources: maxSources,
+            acl,
+        };
+        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, "context/subgraph"),
+            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.HandlerEnvelopeGraphSourceSubgraphResponse.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);
+                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/subgraph");
+    }
     /**
      * Merge/upsert database_metadata and additional_metadata for one source. collection is required.
      *
@@ -638,13 +756,7 @@ class ContextClient {
                 case 404:
                     throw new HydraDB.NotFoundError(_response.error.body, _response.rawResponse);
                 case 500:
-                    throw new HydraDB.InternalServerError(serializers.HandlerErrorResponse.parseOrThrow(_response.error.body, {
-                        unrecognizedObjectKeys: "passthrough",
-                        allowUnrecognizedUnionMembers: true,
-                        allowUnrecognizedEnumValues: true,
-                        skipValidation: true,
-                        breadcrumbsPrefix: ["response"],
-                    }), _response.rawResponse);
+                    throw new HydraDB.InternalServerError(_response.error.body, _response.rawResponse);
                 default:
                     throw new errors.HydraDBError({
                         statusCode: _response.error.statusCode,

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

@@ -7,7 +7,21 @@
 export interface HandlerContextMetadataUpdateRequest {
     /** Source ID */
     id: string;
-    /** Free-form key-value pairs to merge into the source's `additional_metadata`. */
+    /**
+     * ACL, when present, REPLACES the source's access-control list without
+     * re-ingestion (PRO-1684): pass the COMPLETE new allow-list (adding a
+     * third user means sending all three), an empty list to make the source
+     * private, or ["__public__"] to open it to every identified caller. A
+     * pointer so omitted (nil, ACL untouched) is distinguishable from an
+     * explicit empty list (private).
+     * ACL uses RawMessage so the handler can tell three wire states apart:
+     * absent (leave the stored ACL untouched), explicit null (revoke to
+     * nobody, JSON-merge-patch semantics), and a list (replace). A plain
+     * *[]string cannot: encoding/json leaves the pointer nil for BOTH
+     * absent and null, which silently ignored an explicit null revocation.
+     */
+    acl?: string[];
+    /** Free-form key-value pairs to merge into the source's `additional_metadata`. The only accepted spelling for document metadata on this endpoint. Capped at 1 KiB, measured on the compact JSON encoding of the whole map in UTF-8 bytes — keys, quotes, commas and braces count toward the budget. Over-cap returns 400 with the actual byte count. */
     additionalMetadata?: Record<string, unknown>;
     /** Collection scope. Defaults to the default collection when omitted. Formerly `sub_tenant_id`; the `sub_tenant_id` alias is still accepted (deprecated). */
     collection?: string;
@@ -17,14 +31,14 @@ export interface HandlerContextMetadataUpdateRequest {
      * the request body before binding, so the handler reads TenantID/SubTenantID.
      */
     database?: string;
-    /** Schema-backed metadata fields to merge into the source's `metadata` (database metadata). Canonical name; `tenant_metadata` is a deprecated alias. */
+    /** Schema-backed metadata fields to merge into the source's `metadata` (database metadata). Canonical name; `tenant_metadata` is a deprecated alias. Capped at 16 KiB, measured on the compact JSON encoding of the whole map in UTF-8 bytes — keys, quotes, commas and braces count toward the budget. Over-cap returns 400 with the actual byte count. */
     databaseMetadata?: Record<string, unknown>;
-    /** Deprecated alias for `additional_metadata`. */
+    /** Not accepted on this endpoint. Sending any non-null value returns 400 (`document_metadata is not accepted; use additional_metadata`), regardless of size. Use `additional_metadata` instead. Accepted as an alias on /context/ingest only. */
     documentMetadata?: Record<string, unknown>;
     /** deprecated: use collection */
     subTenantId?: string;
     /** deprecated: use database */
     tenantId?: string;
-    /** deprecated: use database_metadata */
+    /** Deprecated alias for `database_metadata`, still accepted here; `database_metadata` wins when both are sent. Capped at 16 KiB, measured on the compact JSON encoding of the whole map in UTF-8 bytes — keys, quotes, commas and braces count toward the budget. Over-cap returns 400 with the actual byte count. */
     tenantMetadata?: Record<string, unknown>;
 }

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

@@ -7,12 +7,15 @@ import type * as HydraDB from "../../../../index.js";
  *     }
  */
 export interface IngestContextRequest {
+    /** App-knowledge items as a JSON array (type=knowledge). Per item, `metadata` is capped at 16 KiB and `additional_metadata` at 1 KiB, measured on the compact JSON encoding of the whole map in UTF-8 bytes (keys and punctuation count). The deprecated `tenant_metadata` / `document_metadata` spellings are accepted here and held to the same caps. Over-cap returns 400 with the actual byte count. Each item may also carry `acl`, a list of principals (`user_email:<email>`, a bare email, `group:<provider>:<id>`, `domain:<domain>`, or `__public__`) restricting who may retrieve it; omit it to leave the document unrestricted, and send an empty list to restrict it to nobody. A malformed principal rejects the whole request with 400. */
     appKnowledge?: string;
     collection?: string;
     database: string;
+    /** Per-document metadata as a JSON array (type=knowledge). Per item, `metadata` is capped at 16 KiB and `additional_metadata` at 1 KiB. Both caps are measured on the compact JSON encoding of the whole map in UTF-8 bytes, so keys, quotes, commas and braces count toward the budget. Over-cap returns 400 with the actual byte count. */
     documentMetadata?: string;
     documents?: core.file.Uploadable | undefined;
     graphPayload?: string;
+    /** Memory items as a JSON array (type=memory). Per item, `metadata` is capped at 16 KiB and `additional_metadata` at 1 KiB, measured on the compact JSON encoding of the whole map in UTF-8 bytes (keys and punctuation count). Over-cap returns 400 with the actual byte count. */
     memories?: string;
     subTenantId?: string;
     tenantId?: string;

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

@@ -24,4 +24,6 @@ export interface InspectContextRequest {
     expirySeconds?: number;
     /** Fetch mode */
     mode?: string;
+    /** Principals to answer as (PRO-1684 document ACLs): the source must be visible to them, or the response is 404. Repeated (acl=a&acl=b) or comma-separated. Omit for no ACL scoping. */
+    acl?: string | string[];
 }

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

@@ -4,6 +4,8 @@ import type * as HydraDB from "../../../../index.js";
  *     {}
  */
 export interface ListV2ListContentRequest {
+    /** ACL: see ListContentRequest.ACL (PRO-1684 document ACLs). */
+    acl?: string[];
     /** Collection scope. Defaults to the default collection when omitted. Formerly `sub_tenant_id`; the `sub_tenant_id` alias is still accepted (deprecated). */
     collection?: string;
     /**
@@ -13,6 +15,14 @@ export interface ListV2ListContentRequest {
      */
     database?: string;
     filters?: HydraDB.ListContentFilter;
+    /**
+     * GroupThreads (type=knowledge only) folds each ticket's/thread root's
+     * discussion (comment and message app sources carrying an app_parent_id)
+     * under the parent row as `comments`, newest first, instead of listing them
+     * as separate top-level rows. Off by default: the flat shape is the
+     * existing contract.
+     */
+    groupThreads?: boolean;
     /** When provided, only items with these IDs are returned. Pagination and filters still apply. */
     ids?: string[];
     /** Field projection — only the listed fields plus id, database, collection are returned. Only applies to type=knowledge. */

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

@@ -26,4 +26,6 @@ export interface RelationsContextRequest {
     limit?: number;
     /** Pagination cursor */
     cursor?: number;
+    /** Principals to answer as (PRO-1684 document ACLs): only relations attributable to sources they may see are returned. Repeated (acl=a&acl=b) or comma-separated. Omit for no ACL scoping. */
+    acl?: string | string[];
 }

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

@@ -4,6 +4,8 @@ import type * as HydraDB from "../../../../index.js";
  *     {}
  */
 export interface SourcesV2SourceDeleteRequest {
+    /** Selects the status behaviour for this request. `strict` opts in to honest 404/409/500 codes when the delete did not happen; `legacy` forces the unconditional 200. Omitted, the server default applies — currently `legacy`. */
+    hydraDbDeleteStatus?: HydraDB.DeleteContextRequestXHydraDbDeleteStatus;
     /** Collection scope. Defaults to the default collection when omitted. Formerly `sub_tenant_id`; the `sub_tenant_id` alias is still accepted (deprecated). */
     collection?: string;
     /**

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

@@ -0,0 +1,31 @@
+import type * as HydraDB from "../../../../index.js";
+/**
+ * @example
+ *     {
+ *         database: "acme_corp",
+ *         collection: "team_docs",
+ *         tenantId: "tenant_1234",
+ *         subTenantId: "sub_tenant_4567",
+ *         id: "HydraDoc1234"
+ *     }
+ */
+export interface SubgraphContextRequest {
+    /** Database (canonical name for the tenant scope) */
+    database: string;
+    /** Collection (canonical name for the sub-tenant scope) */
+    collection?: string;
+    /** Deprecated alias for database */
+    tenantId?: string;
+    /** Deprecated alias for collection */
+    subTenantId?: string;
+    /** Seed source ID */
+    id: string;
+    /** Corpus type: 'knowledge' or 'memory' */
+    type?: HydraDB.SubgraphContextRequestType;
+    /** Max BFS depth */
+    depth?: number;
+    /** Max subgraph members */
+    maxSources?: number;
+    /** Principals to answer as (PRO-1684 document ACLs): the subgraph contains only sources they may see, filtered at every hop. Repeated (acl=a&acl=b) or comma-separated. Omit for no ACL scoping. */
+    acl?: string | string[];
+}

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

@@ -5,3 +5,4 @@ export type { ListV2ListContentRequest } from "./ListV2ListContentRequest.js";
 export type { RelationsContextRequest } from "./RelationsContextRequest.js";
 export type { SourcesV2SourceDeleteRequest } from "./SourcesV2SourceDeleteRequest.js";
 export type { StatusContextRequest } from "./StatusContextRequest.js";
+export type { SubgraphContextRequest } from "./SubgraphContextRequest.js";

package/dist/api/resources/context/types/DeleteContextRequestXHydraDbDeleteStatus.d.ts

@@ -0,0 +1,5 @@
+export declare const DeleteContextRequestXHydraDbDeleteStatus: {
+    readonly Strict: "strict";
+    readonly Legacy: "legacy";
+};
+export type DeleteContextRequestXHydraDbDeleteStatus = (typeof DeleteContextRequestXHydraDbDeleteStatus)[keyof typeof DeleteContextRequestXHydraDbDeleteStatus];

package/dist/api/resources/context/types/DeleteContextRequestXHydraDbDeleteStatus.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.DeleteContextRequestXHydraDbDeleteStatus = void 0;
+exports.DeleteContextRequestXHydraDbDeleteStatus = {
+    Strict: "strict",
+    Legacy: "legacy",
+};

package/dist/api/resources/context/types/SubgraphContextRequestType.d.ts

@@ -0,0 +1,5 @@
+export declare const SubgraphContextRequestType: {
+    readonly Knowledge: "knowledge";
+    readonly Memory: "memory";
+};
+export type SubgraphContextRequestType = (typeof SubgraphContextRequestType)[keyof typeof SubgraphContextRequestType];

package/dist/api/resources/context/types/SubgraphContextRequestType.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.SubgraphContextRequestType = void 0;
+exports.SubgraphContextRequestType = {
+    Knowledge: "knowledge",
+    Memory: "memory",
+};

package/dist/api/resources/context/types/index.d.ts

@@ -1,4 +1,6 @@
+export * from "./DeleteContextRequestXHydraDbDeleteStatus.js";
 export * from "./IngestContextRequestType.js";
 export * from "./ListV2ListContentRequestType.js";
 export * from "./RelationsContextRequestType.js";
 export * from "./SourcesV2SourceDeleteRequestType.js";
+export * from "./SubgraphContextRequestType.js";

package/dist/api/resources/context/types/index.js

@@ -14,7 +14,9 @@ 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("./DeleteContextRequestXHydraDbDeleteStatus.js"), exports);
 __exportStar(require("./IngestContextRequestType.js"), exports);
 __exportStar(require("./ListV2ListContentRequestType.js"), exports);
 __exportStar(require("./RelationsContextRequestType.js"), exports);
 __exportStar(require("./SourcesV2SourceDeleteRequestType.js"), exports);
+__exportStar(require("./SubgraphContextRequestType.js"), exports);

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

@@ -106,6 +106,23 @@ export declare class DatabasesClient {
      */
     status(request: HydraDB.StatusDatabasesRequest, requestOptions?: DatabasesClient.RequestOptions): core.HttpResponsePromise<HydraDB.HandlerEnvelopeTenantsInfraStatusResponseV2>;
     private __status;
+    /**
+     * Read the database's declared metadata schema fields. Returns the same field shape accepted by database creation and by Update Metadata Schema, so the response round-trips into add_fields.
+     *
+     * @param {HydraDB.GetMetadataSchemaDatabasesRequest} request
+     * @param {DatabasesClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link HydraDB.BadRequestError}
+     * @throws {@link HydraDB.NotFoundError}
+     * @throws {@link HydraDB.InternalServerError}
+     *
+     * @example
+     *     await client.databases.getMetadataSchema({
+     *         database: "acme_corp"
+     *     })
+     */
+    getMetadataSchema(request: HydraDB.GetMetadataSchemaDatabasesRequest, requestOptions?: DatabasesClient.RequestOptions): core.HttpResponsePromise<HydraDB.HandlerEnvelopeTenantsTenantMetadataSchemaResponse>;
+    private __getMetadataSchema;
     /**
      * Add new metadata schema fields to an existing database. Additive only — existing fields cannot be deleted or retyped.
      *