@hydradb/sdk 2.1.4 → 2.1.5

package/dist/api/resources/feedback/client/requests/FeedbackSubmitRequest.d.ts

@@ -0,0 +1,29 @@
+import type * as HydraDB from "../../../../index.js";
+/**
+ * @example
+ *     {
+ *         requestId: "9d13aef4-02f4-4e73-8c62-4c2601d04f9d"
+ *     }
+ */
+export interface FeedbackSubmitRequest {
+    /** Optional collection scope for this feedback. A collection is scoped to a database, so `database` must be sent alongside it; sending `collection` on its own is rejected. */
+    collection?: string;
+    /** Owning database. Formerly `tenant_id`; the `tenant_id` alias is still accepted (deprecated). */
+    database?: string;
+    /** Free-text comment describing what was right or wrong about the results. Required unless `ground_truth` is supplied. */
+    feedback?: string;
+    /** What you already know the right answer to be, when you know it. Supply an expected `answer`, the `source_ids` that contain it, or both — at least one is required if the field is present. Machine-checkable, so it is a stronger signal than a comment: submit it alone and `feedback` becomes optional. */
+    groundTruth?: HydraDB.FeedbackGroundTruth;
+    /** Free-form key-value context stored alongside the feedback (e.g. agent name, conversation or eval-run ID). */
+    metadata?: Record<string, string>;
+    /** Optional overall judgement: `positive`, `negative`, or `neutral`. Omit to send a comment with no rating. */
+    rating?: HydraDB.FeedbackRating;
+    /** The `request_id` from `response.meta` of the query this feedback is about. Required — it is what links the feedback to the query that ran. */
+    requestId: string;
+    /** Who is submitting: `user` (default) or `agent`. */
+    source?: HydraDB.FeedbackSource;
+    /** deprecated: use collection */
+    subTenantId?: string;
+    /** deprecated: use database */
+    tenantId?: string;
+}

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

@@ -0,0 +1 @@
+export type { FeedbackSubmitRequest } from "./FeedbackSubmitRequest.js";

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

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

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

@@ -5,6 +5,7 @@ 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 * from "./feedback/client/requests/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

@@ -44,6 +44,7 @@ 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"));
+__exportStar(require("./feedback/client/requests/index.js"), exports);
 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/types/ConnectorsResource.d.ts

@@ -15,6 +15,19 @@ export interface ConnectorsResource {
      * nothing has been applied yet (first capture-enabled sync).
      */
     aclFingerprint?: string;
+    /**
+     * ACLWarning explains, in the provider's own words, why this resource's
+     * permissions could not be captured. Capture fails OPEN, so the resource
+     * is readable by everyone while this is set; without surfacing it, that
+     * widening would be invisible to the person who turned RBAC on. Cleared
+     * automatically by the next successful capture.
+     */
+    aclWarning?: string;
+    /**
+     * ACLWarningAt is when this warning last CHANGED (RFC3339). An unchanged
+     * warning is not rewritten each cycle, so it reads as "open since".
+     */
+    aclWarningAt?: string;
     /**
      * AdditionalMetadata is merged into the additional_metadata (document
      * metadata) layer of every object synced from this resource. User-supplied
@@ -27,6 +40,26 @@ export interface ConnectorsResource {
      * time so the scheduler can thread it into each chunk's workflow input.
      */
     backfillChunkIntervalSeconds?: number;
+    /**
+     * BackfillFloor is the fixed oldest boundary the historical crawl is working
+     * towards, stamped once at configure time as now-lookback_days.
+     *
+     * It exists because the floor used to be recomputed per chunk from the
+     * workflow's own clock, which made it a *moving* target: every hour the
+     * crawl was delayed, the boundary advanced an hour with it. A connector
+     * paused mid-backfill (PRO-1762) makes that trivially reachable — pause for
+     * longer than the crawl has left and it resumes, finds backfill_oldest
+     * already at or past the recomputed floor, declares itself complete and
+     * clears the marker. The remaining history is never fetched and nothing
+     * reports it missing. Anchoring the boundary is what makes "backfill 30
+     * days" mean 30 days from when it was asked for, however long the crawl
+     * takes.
+     *
+     * Empty on rows configured before this field existed; the workflow falls
+     * back to the old now-relative computation for those, so their behaviour is
+     * unchanged rather than silently altered by a deploy.
+     */
+    backfillFloor?: string;
     /**
      * BackfillNextChunkAt is the RFC3339 time the next chunk becomes due. The
      * backfill workflow processes one chunk then sets this to now+interval and
@@ -78,6 +111,31 @@ export interface ConnectorsResource {
      * system-set fields.
      */
     metadata?: Record<string, unknown>;
+    /**
+     * PageACLWarning is the same signal for SOURCE-level failures inside this
+     * resource: individual pages whose own restrictions could not be resolved
+     * and were therefore opened (Confluence, PRO-1684).
+     *
+     * A SEPARATE field from ACLWarning on purpose. The two are written by
+     * different steps at different points in a sync, and ACLWarning is CLEARED
+     * whenever resource capture succeeds. Sharing one field would let a healthy
+     * space wipe a live page warning every cycle, leaving a window in which the
+     * dashboard reports no problems while pages are still open — a false
+     * all-clear on an access-control surface, which is worse than no surface.
+     */
+    pageAclWarning?: string;
+    /** PageACLWarningAt is when PageACLWarning last CHANGED (RFC3339). */
+    pageAclWarningAt?: string;
+    /**
+     * PageACLWarningRun is the drain run that last observed a page failing open
+     * here. It is what makes the warning self-clearing: the drain settles each
+     * resource at the END of a cycle, and a stored run that is not the current
+     * one means that whole cycle passed with nothing failing, so the warning is
+     * withdrawn. Durable on purpose — the alternative was remembering it in the
+     * worker, which a restart loses and which has no moment that means "all
+     * pages have now been judged".
+     */
+    pageAclWarningRun?: string;
     /** Bookmark of the last synced position. Non-empty value confirms the first sync has run. */
     providerCursor?: string;
     /** Additional provider-supplied metadata for this resource. */

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

@@ -0,0 +1,13 @@
+/**
+ * StorageLayout is the physical storage layout the database is created with
+ * (PRO-1618), from the request's `type` field. Absent or "split" keeps the
+ * two-collection layout every existing database uses; "unified" is the
+ * single-collection layout. Fixed at creation and IMMUTABLE thereafter: the
+ * layout decides how every entity id is hashed, so a database that changed
+ * its mind would orphan everything already stored.
+ */
+export declare const GithubComHydradbHydradbApplicationInternalPlatformStoragelayoutLayout: {
+    readonly Split: "split";
+    readonly Unified: "unified";
+};
+export type GithubComHydradbHydradbApplicationInternalPlatformStoragelayoutLayout = (typeof GithubComHydradbHydradbApplicationInternalPlatformStoragelayoutLayout)[keyof typeof GithubComHydradbHydradbApplicationInternalPlatformStoragelayoutLayout];

package/dist/api/types/GithubComHydradbHydradbApplicationInternalPlatformStoragelayoutLayout.js

@@ -0,0 +1,16 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GithubComHydradbHydradbApplicationInternalPlatformStoragelayoutLayout = void 0;
+/**
+ * StorageLayout is the physical storage layout the database is created with
+ * (PRO-1618), from the request's `type` field. Absent or "split" keeps the
+ * two-collection layout every existing database uses; "unified" is the
+ * single-collection layout. Fixed at creation and IMMUTABLE thereafter: the
+ * layout decides how every entity id is hashed, so a database that changed
+ * its mind would orphan everything already stored.
+ */
+exports.GithubComHydradbHydradbApplicationInternalPlatformStoragelayoutLayout = {
+    Split: "split",
+    Unified: "unified",
+};

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

@@ -75,6 +75,21 @@ export interface HandlerConnectorApiView {
     needsReauthReason?: string;
     /** RFC3339 timestamp when the next scheduled sync will run. */
     nextSyncAt?: string;
+    /**
+     * Paused marks a connector its owner deliberately stopped (PRO-1762). It
+     * parks next_sync_at as SyncBlocked does, but stays a separate field:
+     * blocking clears itself once the cause is fixed, whereas only an explicit
+     * resume lifts a pause. Resources keep their committed provider_cursor, so
+     * resuming continues from where each stream stopped.
+     */
+    paused?: boolean;
+    pausedAt?: string;
+    /**
+     * PausedNextSyncAt preserves the schedule the pause displaced. Resume makes
+     * the connector due immediately, so this is read back only to recover from
+     * a pause applied by mistake.
+     */
+    pausedNextSyncAt?: 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. */

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

@@ -79,6 +79,21 @@ export interface HandlerConnectorCreateResponse {
     needsReauthReason?: string;
     /** RFC3339 timestamp when the next scheduled sync will run. */
     nextSyncAt?: string;
+    /**
+     * Paused marks a connector its owner deliberately stopped (PRO-1762). It
+     * parks next_sync_at as SyncBlocked does, but stays a separate field:
+     * blocking clears itself once the cause is fixed, whereas only an explicit
+     * resume lifts a pause. Resources keep their committed provider_cursor, so
+     * resuming continues from where each stream stopped.
+     */
+    paused?: boolean;
+    pausedAt?: string;
+    /**
+     * PausedNextSyncAt preserves the schedule the pause displaced. Resume makes
+     * the connector due immediately, so this is read back only to recover from
+     * a pause applied by mistake.
+     */
+    pausedNextSyncAt?: 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. */

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

@@ -3,9 +3,13 @@ export interface HandlerConnectorListResponse {
     connectors?: HydraDB.HandlerConnectorApiView[];
     /**
      * Health maps connector_id to its rollup (healthy | degraded | failed |
-     * checking), present only when the caller asks for `?include=health`.
-     * A connector missing from the map has an unknown rollup — its resources
-     * could not be read — which clients must not render as a failure.
+     * checking | capped), present only when the caller asks for
+     * `?include=health`. A connector missing from the map has an unknown
+     * rollup — its resources could not be read — which clients must not
+     * render as a failure. `capped` is not a rollup of the connector: it is
+     * overlaid on a healthy, degraded or checking one when the org is at a
+     * plan cap, and PlanCap says which.
      */
     health?: Record<string, string>;
+    planCap?: HydraDB.HandlerPlanCapView;
 }

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

@@ -0,0 +1,6 @@
+export interface HandlerConnectorPauseResponse {
+    /** Connector this resource belongs to. */
+    connectorId?: string;
+    paused?: boolean;
+    pausedAt?: string;
+}

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

@@ -1,4 +1,20 @@
 export interface HandlerConnectorResourceStatus {
+    /**
+     * ACLWarning explains why permission capture could not read this
+     * resource. Capture fails OPEN, so while this is set the resource is
+     * readable by EVERY caller regardless of the ACL they send. Deliberately
+     * not folded into Status: the resource is syncing fine and its content is
+     * current, so calling it failed would be wrong and would train people to
+     * ignore a red badge. It is a separate signal because it needs a separate
+     * reaction (grant the missing permission, or set an access rule).
+     */
+    aclWarning?: string;
+    /**
+     * ACLWarningAt is when this warning was last CHANGED (RFC3339), not when
+     * the failure was last observed. An unchanged warning is deliberately not
+     * rewritten every cycle, so treat this as "open since", not "checked at".
+     */
+    aclWarningAt?: string;
     /** Action is what the user must do, when there is something they can do. */
     action?: string;
     checkedAt?: string;
@@ -10,6 +26,17 @@ export interface HandlerConnectorResourceStatus {
     lastRowCount?: number;
     /** Message is the provider's own words when Status is failed. */
     message?: string;
+    /**
+     * PageACLWarning reports that individual PAGES inside this resource could
+     * not have their own restrictions resolved and were opened to every caller.
+     * Distinct from ACLWarning above, which is about the resource itself: a
+     * resource can capture perfectly while pages inside it fail, and a healthy
+     * resource capture clears ACLWarning, so sharing one field would blank this
+     * every cycle and report all-clear while pages are still open.
+     */
+    pageAclWarning?: string;
+    /** PageACLWarningAt is when PageACLWarning last CHANGED (RFC3339). */
+    pageAclWarningAt?: string;
     /** Resource identifier from the Discover endpoint. */
     resourceId?: string;
     /**

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

@@ -1,7 +1,8 @@
 /**
- * Error is the connector-level failure, set when Status is failed. Absent
- * when the trouble is confined to individual resources — those carry their
- * own messages below.
+ * Error is the connector-level failure: a rejected credential, a blocked
+ * connector, or a latest sync cycle that failed as a whole. Absent when the
+ * trouble is confined to individual resources — those carry their own
+ * messages below.
  */
 export interface HandlerConnectorStatusError {
     /** Action is what the user must do, when there is something they can do. */

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

@@ -17,6 +17,7 @@ export interface HandlerConnectorStatusResponse {
     lifecycle?: string;
     /** RFC3339 timestamp when the next scheduled sync will run. */
     nextSyncAt?: string;
+    planCap?: HydraDB.HandlerPlanCapView;
     /** External provider being synced (e.g. `slack`, `github`, `linear`, `notion`, `gmail`). */
     provider?: string;
     /**
@@ -25,8 +26,10 @@ export interface HandlerConnectorStatusResponse {
      */
     resources?: HydraDB.HandlerConnectorResourceStatus[];
     /**
-     * Status is the rollup: healthy | degraded | failed | checking. It is the
-     * worst of the credential state and every resource state.
+     * Status is the rollup: healthy | degraded | failed | checking, or capped
+     * when the org is at an enforced plan cap and the rollup was healthy,
+     * degraded or checking (PlanCap then says which cap). It is the worst of
+     * the credential state and every resource state.
      */
     status?: string;
     /**

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

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

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

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

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

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

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

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

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

@@ -0,0 +1,13 @@
+export interface HandlerInstructionsResponse {
+    /** Collections maps collection name to that collection's own instructions. */
+    collections?: Record<string, string>;
+    /** CustomInstructions applies to every document ingested into the database. */
+    customInstructions?: string;
+    /** Owning database. Formerly `tenant_id`; the `tenant_id` alias is still accepted (deprecated). */
+    database?: string;
+    /**
+     * TenantID mirrors Database as a deprecated alias, matching every other v2
+     * tenant response.
+     */
+    tenantId?: string;
+}

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

@@ -0,0 +1,11 @@
+/**
+ * PlanCap is present when the org is at a plan cap the caps mode
+ * enforces; every sync is skipped until the month resets or the plan
+ * changes.
+ */
+export interface HandlerPlanCapView {
+    /** Human-readable result message. */
+    message?: string;
+    meter?: string;
+    plan?: string;
+}

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

@@ -0,0 +1,13 @@
+export interface HandlerVaultCredentialEntry {
+    /** Collection scope. Defaults to the default collection when omitted. Formerly `sub_tenant_id`; the `sub_tenant_id` alias is still accepted (deprecated). */
+    collection?: string;
+    /** Connector this resource belongs to. */
+    connectorId?: string;
+    credentialId?: string;
+    /** Owning database. Formerly `tenant_id`; the `tenant_id` alias is still accepted (deprecated). */
+    database?: string;
+    fields?: string[];
+    label?: string;
+    /** External provider being synced (e.g. `slack`, `github`, `linear`, `notion`, `gmail`). */
+    provider?: string;
+}

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

@@ -0,0 +1,8 @@
+import type * as HydraDB from "../index.js";
+export interface HandlerVaultCredentialListResponse {
+    /** Total number of items returned. */
+    count?: number;
+    /** Provider-specific credentials (typically `{"api_token": "..."}` or `{"access_token": "..."}`). */
+    credentials?: HydraDB.HandlerVaultCredentialEntry[];
+    unavailableCount?: number;
+}

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

@@ -0,0 +1,7 @@
+export interface HandlerVaultCredentialRevealResponse {
+    credentialId?: string;
+    field?: string;
+    /** External provider being synced (e.g. `slack`, `github`, `linear`, `notion`, `gmail`). */
+    provider?: string;
+    value?: unknown;
+}

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

@@ -0,0 +1,5 @@
+export interface HandlerVaultCredentialUpdateResponse {
+    credentialId?: string;
+    /** Whether the source metadata was updated. */
+    updated?: boolean;
+}

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

@@ -0,0 +1,7 @@
+export interface MemoriesConversationTurn {
+    /** Extracted text content of the source document. */
+    content?: string;
+    /** Human-readable label for this resource. */
+    name?: string;
+    role?: string;
+}

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

@@ -0,0 +1,56 @@
+import type * as HydraDB from "../index.js";
+export interface MemoriesIngestItem {
+    /**
+     * ACL is the item's access-control list (PRO-1684), the same contract as
+     * an app_knowledge item's `acl` on a split database: bare emails,
+     * user_email:/group:/domain: principals, or the __public__/__private__
+     * sentinels. Omitted (nil) leaves the context unrestricted; an explicitly
+     * empty list stores __private__. Normalised here, all-or-nothing, so a
+     * malformed principal is a 400 on the request rather than a silently
+     * mis-scoped context. Enforced by every read that takes `acl`.
+     */
+    acl?: string[];
+    attributes?: Record<string, unknown>;
+    /** Extracted text content of the source document. */
+    content?: string;
+    /**
+     * ContextCategory files this context under one of the three buckets
+     * (PRO-1618). Omitted or "auto" leaves it to HydraDB; naming a bucket pins
+     * it and inference will not overwrite it. See
+     * domain/ingestion/context_category.go.
+     */
+    contextCategory?: HydraDB.MemoriesIngestItemContextCategory;
+    contextId?: string;
+    /**
+     * Conversation is the canonical name; `messages` is accepted as an alias.
+     * Both are the shape a developer already builds for OpenAI or Anthropic.
+     */
+    conversation?: HydraDB.MemoriesConversationTurn[];
+    customAttributes?: Record<string, unknown>;
+    customInstructions?: string;
+    enrich?: boolean;
+    happenedAt?: string;
+    /**
+     * IsMarkdown tells the pipeline the text is markdown, so it is chunked on
+     * structure rather than as flat prose. The split memories[] path has always
+     * carried it; a unified database has no other ingest shape, so without it
+     * here a markdown sync has nowhere to say so.
+     */
+    isMarkdown?: boolean;
+    messages?: HydraDB.MemoriesConversationTurn[];
+    /** Text is the canonical name; `content` is accepted as an alias. */
+    text?: string;
+    /**
+     * Title names the context. It becomes the context's document title, and it
+     * is what distinguishes two items whose text is identical: the document id
+     * is generated from the title, so without one they collide.
+     */
+    title?: string;
+    /**
+     * UserName is the speaker identity for a TEXT item. A conversation names
+     * its speaker per turn instead, and that stays authoritative: this field
+     * only fills in when the turns supplied none. Empty ends up as "User",
+     * matching the split path, so the pipeline is never handed a blank.
+     */
+    userName?: string;
+}

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

@@ -0,0 +1,13 @@
+/**
+ * ContextCategory files this context under one of the three buckets
+ * (PRO-1618). Omitted or "auto" leaves it to HydraDB; naming a bucket pins
+ * it and inference will not overwrite it. See
+ * domain/ingestion/context_category.go.
+ */
+export declare const MemoriesIngestItemContextCategory: {
+    readonly Auto: "auto";
+    readonly UserPreference: "user_preference";
+    readonly BusinessKnowledge: "business_knowledge";
+    readonly DecisionTrace: "decision_trace";
+};
+export type MemoriesIngestItemContextCategory = (typeof MemoriesIngestItemContextCategory)[keyof typeof MemoriesIngestItemContextCategory];

package/dist/api/types/MemoriesIngestItemContextCategory.js

@@ -0,0 +1,16 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MemoriesIngestItemContextCategory = void 0;
+/**
+ * ContextCategory files this context under one of the three buckets
+ * (PRO-1618). Omitted or "auto" leaves it to HydraDB; naming a bucket pins
+ * it and inference will not overwrite it. See
+ * domain/ingestion/context_category.go.
+ */
+exports.MemoriesIngestItemContextCategory = {
+    Auto: "auto",
+    UserPreference: "user_preference",
+    BusinessKnowledge: "business_knowledge",
+    DecisionTrace: "decision_trace",
+};

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

@@ -0,0 +1,14 @@
+import type * as HydraDB from "../index.js";
+export interface MemoriesUnifiedIngestRequest {
+    /** Collection scope. Defaults to the default collection when omitted. Formerly `sub_tenant_id`; the `sub_tenant_id` alias is still accepted (deprecated). */
+    collection?: string;
+    contexts?: HydraDB.MemoriesIngestItem[];
+    /** Owning database. Formerly `tenant_id`; the `tenant_id` alias is still accepted (deprecated). */
+    database?: string;
+    /**
+     * Items is the canonical name from the design spec. `contexts` is accepted
+     * as an alias because the field was drafted under that name.
+     */
+    items?: HydraDB.MemoriesIngestItem[];
+    upsert?: boolean;
+}

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

@@ -0,0 +1,4 @@
+export interface SearchAliasExpansionNote {
+    alias?: string;
+    canonical?: string;
+}

package/dist/api/types/SearchAliasExpansionNote.js

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