@hydradb/sdk 2.1.0 → 2.1.2

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

@@ -0,0 +1,58 @@
+export interface ConnectorsConnector {
+    /** Authentication method for the provider connection (e.g. `api_token`, `oauth`). */
+    authType?: string;
+    /** Default collection partition for synced objects. Canonical name; mirrors the deprecated `sub_tenant_id` alias. */
+    collection?: string;
+    /** Connector this resource belongs to. */
+    connectorId?: string;
+    /** Internal reference to the stored credential record. */
+    credentialRef?: string;
+    /**
+     * Database/Collection are the canonical v2 names for the deprecated
+     * tenant_id/sub_tenant_id wire fields. They mirror the same values so a v2
+     * client sees the canonical names on responses while a legacy client keeps
+     * reading tenant_id/sub_tenant_id. Not persisted (dynamodbav:"-"): the store
+     * builds items from tenant_id/sub_tenant_id and mirrors these on load. They
+     * are populated at every construction point (toConnector, connectorFromItem)
+     * rather than via MarshalJSON so Temporal's JSON data converter round-trips
+     * Connector activity inputs without spuriously populating them.
+     */
+    database?: string;
+    /** Internal deployment context for this connector. */
+    deploymentId?: string;
+    /** RFC3339 timestamp of the most recent sync attempt (successful or not). */
+    lastAttemptedSyncAt?: string;
+    /** Error message from the most recent failed sync, empty string when no error. */
+    lastError?: string;
+    /** RFC3339 timestamp of the last successful sync completion. */
+    lastSuccessfulSyncAt?: string;
+    /** Human-readable label for this connector. */
+    name?: string;
+    /** RFC3339 timestamp when the next scheduled sync will run. */
+    nextSyncAt?: string;
+    /** Organization that owns this resource. */
+    orgId?: string;
+    /** Subscription plan this connector runs under. */
+    plan?: string;
+    /** External provider being synced (e.g. `slack`, `github`, `linear`, `notion`, `gmail`). */
+    provider?: string;
+    /** Identifier for the external account (e.g. Slack workspace ID, GitHub org name). Must be distinct across connectors for the same provider. */
+    providerAccountScope?: string;
+    /** Lifecycle status of the connector (e.g. `active`, `paused`, `error`). */
+    status?: string;
+    /** Default collection partition for synced objects. Deprecated — use `collection`. */
+    subTenantId?: string;
+    /**
+     * SyncEngine is "classic" (default, empty treated as classic) or "moveit".
+     * See the SyncEngine* constants; the scheduler branches on it.
+     */
+    syncEngine?: string;
+    /** How frequently the scheduler triggers incremental syncs, in seconds. */
+    syncIntervalSeconds?: number;
+    /** Current sync operation state (e.g. `idle`, `running`). */
+    syncStatus?: string;
+    /** Database that receives synced data. Deprecated — use `database`. */
+    tenantId?: string;
+    /** User that created or owns this resource. */
+    userId?: string;
+}

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

@@ -0,0 +1,71 @@
+export interface ConnectorsResource {
+    /**
+     * AdditionalMetadata is merged into the additional_metadata (document
+     * metadata) layer of every object synced from this resource. User-supplied
+     * keys are shallow-merged as the base; provider-generated fields are
+     * applied on top and always win on conflict.
+     */
+    additionalMetadata?: Record<string, unknown>;
+    /**
+     * BackfillChunkIntervalSeconds is the pacing interval persisted at configure
+     * time so the scheduler can thread it into each chunk's workflow input.
+     */
+    backfillChunkIntervalSeconds?: number;
+    /**
+     * BackfillNextChunkAt is the RFC3339 time the next chunk becomes due. The
+     * backfill workflow processes one chunk then sets this to now+interval and
+     * exits; the connector scheduler starts the next chunk once it passes.
+     */
+    backfillNextChunkAt?: string;
+    /**
+     * BackfillOldest is an RFC3339 timestamp marking the oldest boundary remaining
+     * for async historical backfill. Empty means backfill is complete or not needed.
+     */
+    backfillOldest?: string;
+    /**
+     * BackfillStatus gates the sparse ResourcesByBackfillNextChunkAt GSI: it is
+     * set to BackfillStatusActive while a historical backfill is in progress and
+     * removed when it completes, so only actively-backfilling resources appear in
+     * the scheduler's due query. Pacing between chunks is driven by that scheduler
+     * (see BackfillNextChunkAt), not by an in-workflow sleep.
+     */
+    backfillStatus?: string;
+    /** Routes this resource's synced objects into a specific collection, overriding the connector's. Canonical name; mirrors the deprecated `sub_tenant_id_override` alias. */
+    collectionOverride?: string;
+    /** Connector this resource belongs to. */
+    connectorId?: string;
+    /**
+     * DatabaseOverride/CollectionOverride are the canonical v2 names for the
+     * deprecated tenant_id_override/sub_tenant_id_override wire fields. Empty
+     * means the resource inherits the connector's database/collection, exactly
+     * as the deprecated fields do. Not persisted (dynamodbav:"-"): mirrored from
+     * the tenant_id_override/sub_tenant_id_override values at construction time.
+     */
+    databaseOverride?: string;
+    /** Human-readable name for this resource. */
+    displayName?: string;
+    /** Provider-specific filters applied during sync (e.g. `{"lookback_days": 30}`). */
+    filters?: Record<string, unknown>;
+    /**
+     * Metadata is merged into the tenant metadata layer of every object synced
+     * from this resource. User-supplied keys are shallow-merged as the base;
+     * system defaults (connector_id, provider) are applied on top so they
+     * always win on conflict — user keys extend the map but cannot override
+     * system-set fields.
+     */
+    metadata?: Record<string, unknown>;
+    /** Bookmark of the last synced position. Non-empty value confirms the first sync has run. */
+    providerCursor?: string;
+    /** Additional provider-supplied metadata for this resource. */
+    providerMetadata?: Record<string, unknown>;
+    /** Resource identifier from the Discover endpoint. */
+    resourceId?: string;
+    /** Type of resource within the provider (e.g. `channel`, `repo`, `linear_team`). */
+    resourceType?: string;
+    /** Current sync state of this resource (e.g. `active`, `paused`). */
+    status?: string;
+    /** Overrides the connector-level collection for objects synced from this resource. */
+    subTenantIdOverride?: string;
+    /** Overrides the connector-level database for objects synced from this resource. Deprecated. */
+    tenantIdOverride?: string;
+}

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

@@ -1,8 +1,14 @@
 export interface DashboardPaginationMeta {
+    /** Whether a next page exists. */
     hasNext?: boolean;
+    /** Whether a previous page exists. */
     hasPrevious?: boolean;
+    /** Current page number (1-indexed). */
     page?: number;
+    /** Number of items per page. */
     pageSize?: number;
+    /** Total number of items across all pages. */
     total?: number;
+    /** Total number of pages. */
     totalPages?: number;
 }

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

@@ -1,12 +1,22 @@
 export interface FetchV2SourceFetchResponse {
+    /** Extracted text content of the source document. */
     content?: string;
+    /** Base64-encoded binary content, for binary file types. */
     contentBase64?: string;
+    /** MIME type of the source (e.g. `application/pdf`, `text/plain`). */
     contentType?: string;
+    /** Error message, empty string on success. */
     error?: string;
+    /** Unique identifier for this resource. */
     id?: string;
+    /** LLM-generated summary of the source content. */
     inferredContent?: string;
+    /** Human-readable result message. */
     message?: string;
+    /** Time-limited download URL for the original file. */
     presignedUrl?: string;
+    /** File size in bytes. */
     sizeBytes?: number;
+    /** Whether the request succeeded. */
     success?: boolean;
 }

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

@@ -1,13 +1,40 @@
 export interface GithubComHydradbHydradbApplicationInternalServiceMetadataEditResult {
+    /** Additional metadata keys included in the update request. */
     additionalMetadataKeys?: string[];
+    /** Number of MongoDB chunk rows matched by the source update. */
     chunkRowsMatched?: number;
+    /** Number of MongoDB chunk rows modified by the source update. */
     chunkRowsModified?: number;
+    /** 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;
+    /** deprecated: use vector_rows_synced */
     milvusRowsSynced?: number;
+    /**
+     * Deprecated: use vector_sync_required / vector_synced / vector_rows_synced.
+     * Retained as additive aliases for existing clients; carry the same values.
+     */
     milvusSyncRequired?: boolean;
+    /** deprecated: use vector_synced */
     milvusSynced?: boolean;
+    /** Collection that contained the source. */
     subTenantId?: string;
+    /** Owning 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/GraphEntity.d.ts

@@ -1,8 +1,20 @@
 export interface GraphEntity {
+    /** Unique identifier for this entity in the graph. */
     entityId?: string;
     /** NO omitempty — serialize as null */
     identifier?: string;
+    /** Human-readable label for this resource. */
     name?: string;
+    /** Namespace grouping for the entity (e.g. `organization`, `person`). */
     namespace?: string;
+    /**
+     * Provider is the source app the entity's evidence chunk came from (e.g.
+     * "slack", "google", "intercom"), read from the owning Source node's
+     * app_provider. Empty string when the evidence has no app source (plain
+     * document / web ingest). Consumed by the dashboard to render a connector
+     * logo inside the graph node.
+     */
+    provider?: string;
+    /** Entity type label (e.g. `knowledge`, `person`, `organization`). */
     type?: string;
 }

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

@@ -1,9 +1,13 @@
 import type * as HydraDB from "../index.js";
 export interface GraphGraphRelationsResponse {
+    /** Whether the response was truncated due to the result limit. */
     isTruncated?: boolean;
+    /** Human-readable result message. */
     message?: string;
     /** NO omitempty */
     nextCursor?: number;
+    /** Array of triplet groups with evidence for each relationship. */
     relations?: HydraDB.GraphTripletWithEvidence[];
+    /** Whether the request succeeded. */
     success?: boolean;
 }

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

@@ -1,10 +1,15 @@
 export interface GraphRelationEvidence {
+    /** Normalized predicate for the relationship (e.g. `works_at`, `depends_on`). */
     canonicalPredicate?: string;
     /** NO omitempty */
     chunkId?: string;
+    /** Confidence score, from 0 to 1. */
     confidence?: number;
+    /** Verbatim passage from the source that evidences the relationship. */
     context?: string;
+    /** As-extracted predicate before normalization. */
     rawPredicate?: string;
+    /** Unique identifier for this relationship instance. */
     relationshipId?: string;
     /** NO omitempty */
     sourceEntityId?: string;
@@ -12,5 +17,6 @@ export interface GraphRelationEvidence {
     targetEntityId?: string;
     /** NO omitempty */
     temporalDetails?: string;
+    /** RFC3339 timestamp associated with this item. */
     timestamp?: string;
 }

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

@@ -1,6 +1,8 @@
 import type * as HydraDB from "../index.js";
 export interface GraphTripletWithEvidence {
+    /** Chunk that provides evidence for this relation. */
     chunkId?: string;
+    /** Evidence entries for this relationship triplet. */
     relations?: HydraDB.GraphRelationEvidence[];
     source?: HydraDB.GraphEntity;
     target?: HydraDB.GraphEntity;

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

@@ -1,4 +1,6 @@
 export interface HandlerApiError {
+    /** Machine-readable error code (e.g. `DATABASE_NOT_FOUND`). */
     code?: string;
+    /** Human-readable description of the error. */
     message?: string;
 }

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

@@ -1,7 +1,12 @@
 export interface HandlerDeprecationNotice {
+    /** Whether this response concerns a deprecated field or route. */
     deprecated?: boolean;
+    /** The deprecated field name. */
     deprecatedField?: string;
+    /** API version when the field was deprecated. */
     deprecatedSince?: string;
+    /** Migration guidance message. */
     message?: string;
+    /** The canonical replacement for the deprecated field. */
     preferredField?: string;
 }

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

@@ -1,7 +1,9 @@
 import type * as HydraDB from "../index.js";
 export interface HandlerEnvelopeFetchV2SourceFetchResponse {
     data?: HydraDB.FetchV2SourceFetchResponse;
+    /** Error message, empty string on success. */
     error?: HydraDB.HandlerApiError;
     meta?: HydraDB.HandlerResponseMeta;
+    /** Whether the request succeeded. */
     success?: boolean;
 }

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

@@ -1,7 +1,9 @@
 import type * as HydraDB from "../index.js";
 export interface HandlerEnvelopeGithubComHydradbHydradbApplicationInternalServiceMetadataEditResult {
     data?: HydraDB.GithubComHydradbHydradbApplicationInternalServiceMetadataEditResult;
+    /** Error message, empty string on success. */
     error?: HydraDB.HandlerApiError;
     meta?: HydraDB.HandlerResponseMeta;
+    /** Whether the request succeeded. */
     success?: boolean;
 }

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

@@ -1,7 +1,9 @@
 import type * as HydraDB from "../index.js";
 export interface HandlerEnvelopeGraphGraphRelationsResponse {
     data?: HydraDB.GraphGraphRelationsResponse;
+    /** Error message, empty string on success. */
     error?: HydraDB.HandlerApiError;
     meta?: HydraDB.HandlerResponseMeta;
+    /** Whether the request succeeded. */
     success?: boolean;
 }

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

@@ -1,7 +1,9 @@
 import type * as HydraDB from "../index.js";
 export interface HandlerEnvelopeIngestionV2BatchProcessingStatus {
     data?: HydraDB.IngestionV2BatchProcessingStatus;
+    /** Error message, empty string on success. */
     error?: HydraDB.HandlerApiError;
     meta?: HydraDB.HandlerResponseMeta;
+    /** Whether the request succeeded. */
     success?: boolean;
 }

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

@@ -1,7 +1,9 @@
 import type * as HydraDB from "../index.js";
 export interface HandlerEnvelopeIngestionV2SourceUploadResponse {
     data?: HydraDB.IngestionV2SourceUploadResponse;
+    /** Error message, empty string on success. */
     error?: HydraDB.HandlerApiError;
     meta?: HydraDB.HandlerResponseMeta;
+    /** Whether the request succeeded. */
     success?: boolean;
 }

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

@@ -1,7 +1,9 @@
 import type * as HydraDB from "../index.js";
 export interface HandlerEnvelopeListV2SourceListResponse {
     data?: HydraDB.ListV2SourceListResponse;
+    /** Error message, empty string on success. */
     error?: HydraDB.HandlerApiError;
     meta?: HydraDB.HandlerResponseMeta;
+    /** Whether the request succeeded. */
     success?: boolean;
 }

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

@@ -1,7 +1,9 @@
 import type * as HydraDB from "../index.js";
 export interface HandlerEnvelopeSearchV2RetrievalResult {
     data?: HydraDB.SearchV2RetrievalResult;
+    /** Error message, empty string on success. */
     error?: HydraDB.HandlerApiError;
     meta?: HydraDB.HandlerResponseMeta;
+    /** Whether the request succeeded. */
     success?: boolean;
 }

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

@@ -1,7 +1,9 @@
 import type * as HydraDB from "../index.js";
 export interface HandlerEnvelopeSourcesMemoryDeleteResponse {
     data?: HydraDB.SourcesMemoryDeleteResponse;
+    /** Error message, empty string on success. */
     error?: HydraDB.HandlerApiError;
     meta?: HydraDB.HandlerResponseMeta;
+    /** Whether the request succeeded. */
     success?: boolean;
 }

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

@@ -1,7 +1,9 @@
 import type * as HydraDB from "../index.js";
 export interface HandlerEnvelopeTenantsInfraStatusResponseV2 {
     data?: HydraDB.TenantsInfraStatusResponseV2;
+    /** Error message, empty string on success. */
     error?: HydraDB.HandlerApiError;
     meta?: HydraDB.HandlerResponseMeta;
+    /** Whether the request succeeded. */
     success?: boolean;
 }

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

@@ -1,7 +1,9 @@
 import type * as HydraDB from "../index.js";
 export interface HandlerEnvelopeTenantsSubTenantIdsResponse {
     data?: HydraDB.TenantsSubTenantIdsResponse;
+    /** Error message, empty string on success. */
     error?: HydraDB.HandlerApiError;
     meta?: HydraDB.HandlerResponseMeta;
+    /** Whether the request succeeded. */
     success?: boolean;
 }

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

@@ -1,7 +1,9 @@
 import type * as HydraDB from "../index.js";
 export interface HandlerEnvelopeTenantsTenantCreateAcceptedResponse {
     data?: HydraDB.TenantsTenantCreateAcceptedResponse;
+    /** Error message, empty string on success. */
     error?: HydraDB.HandlerApiError;
     meta?: HydraDB.HandlerResponseMeta;
+    /** Whether the request succeeded. */
     success?: boolean;
 }

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

@@ -1,7 +1,9 @@
 import type * as HydraDB from "../index.js";
 export interface HandlerEnvelopeTenantsTenantDeleteResponse {
     data?: HydraDB.TenantsTenantDeleteResponse;
+    /** Error message, empty string on success. */
     error?: HydraDB.HandlerApiError;
     meta?: HydraDB.HandlerResponseMeta;
+    /** Whether the request succeeded. */
     success?: boolean;
 }

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

@@ -1,7 +1,9 @@
 import type * as HydraDB from "../index.js";
 export interface HandlerEnvelopeTenantsTenantIdsResponse {
     data?: HydraDB.TenantsTenantIdsResponse;
+    /** Error message, empty string on success. */
     error?: HydraDB.HandlerApiError;
     meta?: HydraDB.HandlerResponseMeta;
+    /** Whether the request succeeded. */
     success?: boolean;
 }

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

@@ -1,7 +1,9 @@
 import type * as HydraDB from "../index.js";
 export interface HandlerEnvelopeTenantsTenantStatsResponse {
     data?: HydraDB.TenantsTenantStatsResponse;
+    /** Error message, empty string on success. */
     error?: HydraDB.HandlerApiError;
     meta?: HydraDB.HandlerResponseMeta;
+    /** Whether the request succeeded. */
     success?: boolean;
 }

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

@@ -1,7 +1,9 @@
 import type * as HydraDB from "../index.js";
 export interface HandlerEnvelopeWebhooksDeliveryItem {
     data?: HydraDB.WebhooksDeliveryItem;
+    /** Error message, empty string on success. */
     error?: HydraDB.HandlerApiError;
     meta?: HydraDB.HandlerResponseMeta;
+    /** Whether the request succeeded. */
     success?: boolean;
 }

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

@@ -1,7 +1,9 @@
 import type * as HydraDB from "../index.js";
 export interface HandlerEnvelopeWebhooksDeliveryListResponse {
     data?: HydraDB.WebhooksDeliveryListResponse;
+    /** Error message, empty string on success. */
     error?: HydraDB.HandlerApiError;
     meta?: HydraDB.HandlerResponseMeta;
+    /** Whether the request succeeded. */
     success?: boolean;
 }

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

@@ -1,7 +1,9 @@
 import type * as HydraDB from "../index.js";
 export interface HandlerEnvelopeWebhooksRetryResponse {
     data?: HydraDB.WebhooksRetryResponse;
+    /** Error message, empty string on success. */
     error?: HydraDB.HandlerApiError;
     meta?: HydraDB.HandlerResponseMeta;
+    /** Whether the request succeeded. */
     success?: boolean;
 }

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

@@ -1,7 +1,9 @@
 import type * as HydraDB from "../index.js";
 export interface HandlerEnvelopeWebhooksWebhookDeleteResponse {
     data?: HydraDB.WebhooksWebhookDeleteResponse;
+    /** Error message, empty string on success. */
     error?: HydraDB.HandlerApiError;
     meta?: HydraDB.HandlerResponseMeta;
+    /** Whether the request succeeded. */
     success?: boolean;
 }

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

@@ -1,7 +1,9 @@
 import type * as HydraDB from "../index.js";
 export interface HandlerEnvelopeWebhooksWebhookGetResponse {
     data?: HydraDB.WebhooksWebhookGetResponse;
+    /** Error message, empty string on success. */
     error?: HydraDB.HandlerApiError;
     meta?: HydraDB.HandlerResponseMeta;
+    /** Whether the request succeeded. */
     success?: boolean;
 }

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

@@ -1,7 +1,9 @@
 import type * as HydraDB from "../index.js";
 export interface HandlerEnvelopeWebhooksWebhookRegisterResponse {
     data?: HydraDB.WebhooksWebhookRegisterResponse;
+    /** Error message, empty string on success. */
     error?: HydraDB.HandlerApiError;
     meta?: HydraDB.HandlerResponseMeta;
+    /** Whether the request succeeded. */
     success?: boolean;
 }

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

@@ -1,7 +1,9 @@
 import type * as HydraDB from "../index.js";
 export interface HandlerEnvelopeWebhooksWebhookTestResponse {
     data?: HydraDB.WebhooksWebhookTestResponse;
+    /** Error message, empty string on success. */
     error?: HydraDB.HandlerApiError;
     meta?: HydraDB.HandlerResponseMeta;
+    /** Whether the request succeeded. */
     success?: boolean;
 }

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

@@ -1,8 +1,14 @@
 export interface HandlerErrorDetail {
+    /** Whether this response concerns a deprecated field or route. */
     deprecated?: boolean;
+    /** The deprecated field name. */
     deprecatedField?: string;
+    /** Machine-readable error classification code. */
     errorCode?: string;
+    /** Human-readable description of the error. */
     message?: string;
+    /** The canonical replacement for the deprecated field. */
     preferredField?: string;
+    /** Always false for error responses. */
     success?: boolean;
 }

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

@@ -0,0 +1,6 @@
+export interface HandlerErrorMeta {
+    apiVersion?: string;
+    latencyMs?: number;
+    /** Unique identifier for this request, useful for support and tracing. */
+    requestId?: string;
+}

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

@@ -1,4 +1,11 @@
 import type * as HydraDB from "../index.js";
 export interface HandlerErrorResponse {
+    data?: unknown;
+    /** Structured error detail with code, message, and deprecation hints. */
     detail?: HydraDB.HandlerErrorDetail;
+    /** Error message, empty string on success. */
+    error?: HydraDB.HandlerApiError;
+    meta?: HydraDB.HandlerErrorMeta;
+    /** Whether the request succeeded. */
+    success?: boolean;
 }

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

@@ -0,0 +1,7 @@
+export interface HandlerMetadataSchemaUpdateResponse {
+    /** Names of the metadata schema fields successfully added. */
+    addedFields?: string[];
+    /** Owning database. Formerly `tenant_id`; the `tenant_id` alias is still accepted (deprecated). */
+    database?: string;
+    tenantId?: string;
+}

package/dist/api/types/HandlerMetadataSchemaUpdateResponse.js

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