@hydradb/sdk 2.1.1 → 2.1.3

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

@@ -0,0 +1,10 @@
+import type * as HydraDB from "../index.js";
+export interface HandlerErrorEnvelopeSourcesMemoryDeleteResponse {
+    data?: HydraDB.SourcesMemoryDeleteResponse;
+    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/HandlerErrorEnvelopeSourcesMemoryDeleteResponse.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/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,5 +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/HandlerProviderListResponse.d.ts

@@ -0,0 +1,4 @@
+import type * as HydraDB from "../index.js";
+export interface HandlerProviderListResponse {
+    providers?: HydraDB.HandlerCatalogConnector[];
+}

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

@@ -0,0 +1,8 @@
+export interface HandlerResourceDeleteResponse {
+    /** Connector this resource belongs to. */
+    connectorId?: string;
+    /** Whether this specific item was deleted. */
+    deleted?: boolean;
+    /** Resource identifier from the Discover endpoint. */
+    resourceId?: string;
+}

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

@@ -1,3 +1,4 @@
+import type * as HydraDB from "../index.js";
 export interface HandlerResourceMapping {
     /**
      * AdditionalMetadata is merged into the additional_metadata layer of every
@@ -37,6 +38,16 @@ export interface HandlerResourceMapping {
      * collection.
      */
     subTenantId?: string;
+    /**
+     * SyncMode is the per-resource update strategy for taps that support one
+     * (today: attio objects/lists). "rescan" (default) re-reads the full set
+     * every sync — the only way edits are seen on APIs with no updated_at.
+     * "new_only" bounds each scan to the sync window and stops paging at its
+     * floor — cheap, and an explicit opt-in to not seeing edits until
+     * webhooks land. Stored in the resource's filters and carried to the tap
+     * on every window.
+     */
+    syncMode?: HydraDB.HandlerResourceMappingSyncMode;
     /**
      * Optional per-resource tenant override (for "route specific resources to
      * different tenants"). Empty means the resource inherits the connector

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

@@ -0,0 +1,14 @@
+/**
+ * SyncMode is the per-resource update strategy for taps that support one
+ * (today: attio objects/lists). "rescan" (default) re-reads the full set
+ * every sync — the only way edits are seen on APIs with no updated_at.
+ * "new_only" bounds each scan to the sync window and stops paging at its
+ * floor — cheap, and an explicit opt-in to not seeing edits until
+ * webhooks land. Stored in the resource's filters and carried to the tap
+ * on every window.
+ */
+export declare const HandlerResourceMappingSyncMode: {
+    readonly Rescan: "rescan";
+    readonly NewOnly: "new_only";
+};
+export type HandlerResourceMappingSyncMode = (typeof HandlerResourceMappingSyncMode)[keyof typeof HandlerResourceMappingSyncMode];

package/dist/api/types/HandlerResourceMappingSyncMode.js

@@ -0,0 +1,17 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HandlerResourceMappingSyncMode = void 0;
+/**
+ * SyncMode is the per-resource update strategy for taps that support one
+ * (today: attio objects/lists). "rescan" (default) re-reads the full set
+ * every sync — the only way edits are seen on APIs with no updated_at.
+ * "new_only" bounds each scan to the sync window and stops paging at its
+ * floor — cheap, and an explicit opt-in to not seeing edits until
+ * webhooks land. Stored in the resource's filters and carried to the tap
+ * on every window.
+ */
+exports.HandlerResourceMappingSyncMode = {
+    Rescan: "rescan",
+    NewOnly: "new_only",
+};

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

@@ -1,5 +1,12 @@
 import type * as HydraDB from "../index.js";
 export interface HandlerResponseMeta {
+    /**
+     * APIVersion echoes the version of the API that served the request (PRO-1209),
+     * sourced from reqmeta.APIVersion — the same value carried by OpenAPI
+     * info.version and /health — so a client always knows which API version
+     * produced a response. Always present (no omitempty).
+     */
+    apiVersion?: 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;
     /** Owning database. Formerly `tenant_id`; the `tenant_id` alias is still accepted (deprecated). */

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

@@ -0,0 +1,5 @@
+export interface HandlerTableConfigEntry {
+    changeHistory?: string;
+    replicationKey?: string;
+    table?: string;
+}

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

@@ -1,3 +1,7 @@
+/**
+ * Status is the item's initial lifecycle state. Both modes share this
+ * vocabulary — memory mode reuses the same values.
+ */
 export declare const IngestionSourceStatus: {
     readonly Queued: "queued";
     readonly Processing: "processing";

package/dist/api/types/IngestionSourceStatus.js

@@ -2,6 +2,10 @@
 // This file was auto-generated by Fern from our API Definition.
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.IngestionSourceStatus = void 0;
+/**
+ * Status is the item's initial lifecycle state. Both modes share this
+ * vocabulary — memory mode reuses the same values.
+ */
 exports.IngestionSourceStatus = {
     Queued: "queued",
     Processing: "processing",

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

@@ -0,0 +1,21 @@
+import type * as HydraDB from "../index.js";
+export interface IngestionV2IngestResponse {
+    /** Number of uploaded files that failed to queue. */
+    failedCount?: number;
+    /** Human-readable result message. */
+    message?: string;
+    /** Per-item results. */
+    results?: HydraDB.IngestionV2IngestResultItem[];
+    /**
+     * Deprecated for API clients: whether the REQUEST was accepted is the HTTP
+     * status code (202) or equivalently the envelope's top-level `success`.
+     * Whether each SOURCE ingested is per-item — read results[].status and
+     * results[].error, then poll GET /context/status, since a 202 only means
+     * queued. This flag answers neither question independently: it always
+     * mirrors the envelope. Still emitted unchanged for existing clients
+     * (PRO-1208).
+     */
+    success?: boolean;
+    /** Number of files successfully queued for processing. */
+    successCount?: number;
+}

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

@@ -0,0 +1,30 @@
+import type * as HydraDB from "../index.js";
+export interface IngestionV2IngestResultItem {
+    /** Error is the failure message for this item, null on success. Both modes. */
+    error?: string;
+    /**
+     * ErrorCode is the machine-readable failure classification, null on success.
+     * Both modes; always null on the memory path, which produces no per-item code.
+     */
+    errorCode?: string;
+    /** Filename is the original filename as submitted. type=knowledge only. */
+    filename?: string;
+    /** ID is the source identifier assigned to this item. Both modes. */
+    id?: string;
+    /** Infer reports whether the memory was queued for inference. type=memory only. */
+    infer?: boolean;
+    /**
+     * RelationsCreated is the number of graph relations extracted from this file.
+     * type=knowledge only, and only for items that carried a `relations` payload.
+     */
+    relationsCreated?: number;
+    /**
+     * RelationsError is the relation-extraction failure message, if any.
+     * type=knowledge only.
+     */
+    relationsError?: string;
+    /** Current lifecycle or processing state. */
+    status?: HydraDB.IngestionSourceStatus;
+    /** Title is the memory's title. type=memory only. */
+    title?: string;
+}

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

@@ -9,6 +9,14 @@ export interface IngestionV2ProcessingStatus {
     indexingStatus?: string;
     /** Human-readable status description. */
     message?: string;
-    /** Whether the request succeeded. */
+    /**
+     * Deprecated for API clients: this reads like a per-source outcome but is
+     * a constant echo of the envelope's `success` — it is true even for a
+     * source that failed indexing. For the state of THIS source read
+     * indexing_status (and error_code/error_message when it is errored); for
+     * whether the request itself succeeded read the HTTP status code or the
+     * envelope's top-level `success`. Still emitted unchanged for existing
+     * clients (PRO-1208).
+     */
     success?: boolean;
 }

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

@@ -4,8 +4,14 @@ export interface ListContentFilter {
     /** Filters /context/list by tenant/source metadata. Example: {"department": "finance"}. */
     metadata?: Record<string, unknown>;
     /**
-     * SourceFields filters by well-known source fields such as title, type,
-     * description, url, and timestamp.
+     * SourceFields filters by well-known source fields: title, type,
+     * description, url, timestamp, and the app-source keys app_provider,
+     * app_kind, app_external_id, app_parent_id.
+     *
+     * app_external_id and app_parent_id are provider-scoped: a Jira issue key
+     * and a Linear id can collide, so pair either with app_provider in the
+     * same filter to identify one object. Without it a match may span
+     * providers that reuse the same external id.
      */
     sourceFields?: Record<string, unknown>;
 }

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

@@ -0,0 +1,23 @@
+import type * as HydraDB from "../index.js";
+export interface ListV2ListResponse {
+    /** Human-readable result message. */
+    message?: string;
+    pagination?: HydraDB.DashboardPaginationMeta;
+    /** Sources carries the rows when type=knowledge (the default). */
+    sources?: HydraDB.ListV2SourceItem[];
+    /**
+     * 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;
+    /** Total is the total number of matching rows across all pages. */
+    total?: number;
+    /**
+     * UserMemories carries the rows when type=memory. Same item shape as Sources
+     * except each row is keyed by memory_id rather than id.
+     */
+    userMemories?: HydraDB.ListV2MemoryItem[];
+}

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

@@ -0,0 +1,66 @@
+export interface ListV2MemoryItem {
+    /**
+     * AdditionalMetadata is the caller-supplied per-document metadata (stored as
+     * document_metadata).
+     */
+    additionalMetadata?: Record<string, unknown>;
+    /** Provider-assigned identifier for this source (e.g. Slack channel ID). */
+    appExternalId?: string;
+    /** App integration category, populated for connector-synced sources. */
+    appKind?: string;
+    /**
+     * AppParentID is the provider external id of this source's conversational
+     * parent (a Jira comment carries its issue key, a Slack reply its thread
+     * root), and AppThreadID the discussion grouping key. Mirrored from the
+     * ingestion pipeline; absent for sources without a parent/thread.
+     */
+    appParentId?: string;
+    /**
+     * App* carry connector provenance, mirrored onto the source document by the
+     * ingestion pipeline. Null for sources that were not connector-ingested.
+     */
+    appProvider?: string;
+    appRelations?: unknown;
+    appThreadId?: string;
+    /**
+     * Collection is the canonical name for the sub-scope this row was listed
+     * from. Empty string when the row lives in the database's default collection.
+     */
+    collection: string;
+    /**
+     * Comments is the group_threads discussion: the source's comment/message
+     * children as full sibling rows, newest first, capped per parent with
+     * CommentsTruncated marking an overflow. Present (possibly empty) on every
+     * row of a group_threads response; absent otherwise.
+     */
+    comments?: Record<string, unknown>[];
+    commentsTruncated?: boolean;
+    /** Database is the canonical name for the scope this row was listed from. */
+    database: string;
+    /** Human-readable description of the source. */
+    description?: string;
+    /**
+     * MemoryID is the memory identifier — the type=memory spelling of ID, and
+     * present on exactly the same terms.
+     */
+    memoryId: string;
+    /** Metadata is the caller-supplied source metadata (stored as tenant_metadata). */
+    metadata?: Record<string, unknown>;
+    note?: string;
+    /**
+     * Relations/AppRelations are passthrough graph subtrees, returned only when
+     * requested via include_fields. Their internal source_id/source_ids keys are
+     * renamed to id/ids on the way out; the rest of the subtree is unconstrained.
+     */
+    relations?: unknown;
+    /** SubTenantID is the deprecated spelling of Collection, carrying an identical value. */
+    subTenantId: string;
+    /** TenantID is the deprecated spelling of Database, carrying an identical value. */
+    tenantId: string;
+    /** RFC3339 timestamp associated with this item. */
+    timestamp?: string;
+    /** Title or name of the source. */
+    title?: string;
+    /** Type is the source kind, e.g. "knowledge" or "memory". */
+    type?: string;
+}

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

@@ -0,0 +1,70 @@
+export interface ListV2SourceItem {
+    /**
+     * AdditionalMetadata is the caller-supplied per-document metadata (stored as
+     * document_metadata).
+     */
+    additionalMetadata?: Record<string, unknown>;
+    /** Provider-assigned identifier for this source (e.g. Slack channel ID). */
+    appExternalId?: string;
+    /** App integration category, populated for connector-synced sources. */
+    appKind?: string;
+    /**
+     * AppParentID is the provider external id of this source's conversational
+     * parent (a Jira comment carries its issue key, a Slack reply its thread
+     * root), and AppThreadID the discussion grouping key. Mirrored from the
+     * ingestion pipeline; absent for sources without a parent/thread.
+     */
+    appParentId?: string;
+    /**
+     * App* carry connector provenance, mirrored onto the source document by the
+     * ingestion pipeline. Null for sources that were not connector-ingested.
+     */
+    appProvider?: string;
+    /** Connector-derived relations for this source. Present on connector-ingested rows. */
+    appRelations?: unknown;
+    /** Discussion grouping key shared by a thread root and its replies/comments. Absent for unthreaded sources. */
+    appThreadId?: string;
+    /**
+     * Collection is the canonical name for the sub-scope this row was listed
+     * from. Empty string when the row lives in the database's default collection.
+     */
+    collection: string;
+    /**
+     * Comments is the group_threads discussion: the source's comment/message
+     * children as full sibling rows, newest first, capped per parent with
+     * CommentsTruncated marking an overflow. Present (possibly empty) on every
+     * row of a group_threads response; absent otherwise.
+     */
+    comments?: Record<string, unknown>[];
+    /** True when the inline `comments` array hit the per-parent cap and more children exist. Fetch them via `filters.additional_metadata` on the parent's external ID. */
+    commentsTruncated?: boolean;
+    /** Database is the canonical name for the scope this row was listed from. */
+    database: string;
+    /** Human-readable description of the source. */
+    description?: string;
+    /**
+     * ID is the source identifier. Always present: buildProjection pins
+     * source.id as an identity field on every projection path.
+     */
+    id: string;
+    /** Metadata is the caller-supplied source metadata (stored as tenant_metadata). */
+    metadata?: Record<string, unknown>;
+    /** Free-form note attached to the source. */
+    note?: string;
+    /**
+     * Relations/AppRelations are passthrough graph subtrees, returned only when
+     * requested via include_fields. Their internal source_id/source_ids keys are
+     * renamed to id/ids on the way out; the rest of the subtree is unconstrained.
+     */
+    relations?: unknown;
+    /** SubTenantID is the deprecated spelling of Collection, carrying an identical value. */
+    subTenantId: string;
+    /** TenantID is the deprecated spelling of Database, carrying an identical value. */
+    tenantId: string;
+    /** RFC3339 timestamp associated with this item. */
+    timestamp?: string;
+    /** Title or name of the source. */
+    title?: string;
+    /** Type is the source kind, e.g. "knowledge" or "memory". */
+    type?: string;
+}

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

@@ -11,6 +11,4 @@ export interface SearchGraphContext {
     chunkRelations?: HydraDB.SearchScoredPathResponse[];
     /** Scored relation paths ranked by relevance to the query. */
     queryPaths?: HydraDB.SearchScoredPathResponse[];
-    /** LLM-synthesized summary of the most relevant graph entities and relationships. */
-    synthesisContext?: string;
 }

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

@@ -1,4 +1,4 @@
 /**
- * Filters results by source metadata. Top-level keys target tenant metadata (for example department, priority, active, or tags). Nested additional_metadata keys target document metadata. Values are exact-match scalars or arrays for set-equality/list-style filters.
+ * Filters results by source metadata. Top-level keys target tenant metadata (for example department, priority, active, or tags). Nested additional_metadata keys target document metadata. Separate keys are ANDed. A scalar value is an exact match; an array means match ANY one of the listed values (OR) - there is no ALL/AND operator within a single key. Arrays are supported on VARCHAR fields only: an array passed for a declared field of any other type is rejected with 400 VALIDATION_ERROR. Size limits: each list may hold at most 500 values, and the whole metadata_filters object is capped at 64 KiB measured on its compact JSON encoding in UTF-8 bytes (keys and punctuation count). Exceeding either returns 400 naming the offending key or the actual byte count.
  */
 export type SearchMetadataFilters = Record<string, unknown>;

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

@@ -10,6 +10,8 @@ export interface SearchSourceInfo {
     appKind?: string;
     /** Provider name for app-sourced items (e.g. `slack`, `github`). */
     appProvider?: string;
+    /** Collection this source belongs to. Canonical name; mirrors the deprecated `sub_tenant_id` alias. */
+    collection?: string;
     /** Human-readable description of the source. */
     description?: string;
     /** Unique identifier for this resource. */
@@ -19,7 +21,7 @@ export interface SearchSourceInfo {
      * the wire (Python default_factory=dict), unlike chunk metadata which is null.
      */
     metadata?: Record<string, unknown>;
-    /** Collection this source belongs to. */
+    /** deprecated: use collection */
     subTenantId?: string;
     /** RFC3339 timestamp associated with this item. */
     timestamp?: string;

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

@@ -0,0 +1,24 @@
+import type * as HydraDB from "../index.js";
+/**
+ * TemporalDuration is the computed event-duration answer, when resolved.
+ */
+export interface SearchTemporalDuration {
+    /**
+     * Approximate is set when either endpoint's granularity is coarser than a
+     * day (month/year brackets) — the day count is then a floor-to-floor
+     * estimate, not an exact span; consumers should not present it as exact.
+     */
+    approximate?: boolean;
+    days?: number;
+    from?: HydraDB.SearchTemporalFact;
+    fromDate?: string;
+    /**
+     * PairingConfidence is the normalized pair-scorer margin (0..1); low values
+     * mean the endpoints were weakly anchored to the question. Durations whose
+     * endpoints share no entity token with the question are suppressed
+     * entirely (P4: a wrong confident day count misleads answerers).
+     */
+    pairingConfidence?: number;
+    to?: HydraDB.SearchTemporalFact;
+    toDate?: string;
+}

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

@@ -0,0 +1,25 @@
+export interface SearchTemporalFact {
+    /** Chunk that provides evidence for this relation. */
+    chunkId?: string;
+    /**
+     * DatePrecision is the resolution of the resolved dates: "day", "month",
+     * "year" (coarser-than-day dates are floored to bracket starts).
+     */
+    datePrecision?: string;
+    eventEnd?: number;
+    eventStart?: number;
+    /**
+     * EvidencePhrase is the verbatim source phrase the dates were resolved
+     * from (e.g. "today", "two weeks ago").
+     */
+    evidencePhrase?: string;
+    factType?: string;
+    object?: string;
+    relation?: string;
+    /** Unique identifier for this relationship instance. */
+    relationshipId?: string;
+    sourceId?: string;
+    /** Current lifecycle or processing state. */
+    status?: string;
+    subject?: string;
+}

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

@@ -0,0 +1,27 @@
+/**
+ * TemporalFilter reports what the temporal layer did for this request.
+ */
+export interface SearchTemporalFilterInfo {
+    /**
+     * Applied is true when the temporal layer engaged for a classified temporal
+     * query — including when it matched zero dated facts; MatchedFacts carries the
+     * actual count. It is false only when the fact lookup degraded (Degraded).
+     */
+    applied?: boolean;
+    chunkScope?: number;
+    /**
+     * Degraded is true when the fact lookup FAILED (as opposed to matching
+     * nothing) — callers must not read an empty payload as "no temporal facts
+     * exist" when this is set.
+     */
+    degraded?: boolean;
+    matchedFacts?: number;
+    mode?: string;
+    promoted?: number;
+    /**
+     * Scope reports how the chunk scope was applied: "soft" (bounded ranking
+     * promotion) or "" (no scope). Hard scoping was removed after TEMPO.
+     */
+    scope?: string;
+    truncated?: boolean;
+}

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

@@ -0,0 +1,14 @@
+/**
+ * TemporalIntent (EXPERIMENTAL) lets the caller supply the classification
+ * (mode/window/phrases) directly, bypassing the regex classifier — for
+ * agents whose own LLM already understands the query, and for non-English
+ * queries. Invalid overrides fall back to the classifier.
+ */
+export interface SearchTemporalIntentOverride {
+    cutoff?: string;
+    durationToNow?: boolean;
+    eventPhrases?: string[];
+    mode?: string;
+    windowEnd?: string;
+    windowStart?: string;
+}

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

@@ -8,6 +8,8 @@ export interface SearchV2Chunk {
     chunkContent?: string;
     /** Unique identifier for this individual chunk. */
     chunkUuid?: string;
+    /** Collection this chunk belongs to. Canonical name; mirrors the deprecated `sub_tenant_id` alias. */
+    collection?: string;
     /** IDs of adjacent chunks pulled in as surrounding context. */
     extraContextIds?: string[];
     /** Unique identifier for this resource. */
@@ -26,6 +28,6 @@ export interface SearchV2Chunk {
     sourceType?: string;
     /** RFC3339 timestamp when the source was ingested. */
     sourceUploadTime?: string;
-    /** Collection this chunk belongs to. */
+    /** deprecated: use collection */
     subTenantId?: string;
 }

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

@@ -7,4 +7,11 @@ export interface SearchV2RetrievalResult {
     graphContext?: HydraDB.SearchGraphContext;
     /** Deduplicated source-level metadata for all returned chunks. */
     sources?: HydraDB.SearchSourceInfo[];
+    temporalDuration?: HydraDB.SearchTemporalDuration;
+    /**
+     * TemporalFacts surface the matched edge-level temporal facts when
+     * temporal_reasoning was requested; omitted otherwise.
+     */
+    temporalFacts?: HydraDB.SearchTemporalFact[];
+    temporalFilter?: HydraDB.SearchTemporalFilterInfo;
 }