@hydradb/sdk 2.1.4 → 2.1.6

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,11 @@
+/**
+ * StorageLayout is the physical storage layout the database is created with,
+ * from the request's `type` field. "split" is the two-collection layout every
+ * database uses, and the default. 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 LayoutSplit: "split";
+};
+export type GithubComHydradbHydradbApplicationInternalPlatformStoragelayoutLayout = (typeof GithubComHydradbHydradbApplicationInternalPlatformStoragelayoutLayout)[keyof typeof GithubComHydradbHydradbApplicationInternalPlatformStoragelayoutLayout];

package/dist/api/types/GithubComHydradbHydradbApplicationInternalPlatformStoragelayoutLayout.js

@@ -0,0 +1,14 @@
+"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,
+ * from the request's `type` field. "split" is the two-collection layout every
+ * database uses, and the default. 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 = {
+    LayoutSplit: "split",
+};

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

@@ -7,6 +7,13 @@ export interface GraphRelationEvidence {
     confidence?: number;
     /** Verbatim passage from the source that evidences the relationship. */
     context?: string;
+    /**
+     * Properties are the caller's own properties on a forceful_relation edge,
+     * exactly as declared at ingest (`forceful_relations.properties`). Flat
+     * scalars. Omitted on every other edge and on a forceful relation that
+     * declared none.
+     */
+    properties?: Record<string, unknown>;
     /** As-extracted predicate before normalization. */
     rawPredicate?: string;
     /** Unique identifier for this relationship instance. */

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/HandlerConnectorLimitView.d.ts

@@ -0,0 +1,15 @@
+/**
+ * ConnectorLimit is present when the org has used its plan's connector
+ * allowance (Free: 3) and the caps mode enforces it: creating another
+ * connector is refused with 402. Connectors already past the allowance
+ * keep syncing; the limit applies to creating one. Absent otherwise, and
+ * sent with the health rollups only.
+ */
+export interface HandlerConnectorLimitView {
+    /** Total number of items returned. */
+    count?: number;
+    limit?: number;
+    /** Human-readable result message. */
+    message?: string;
+    plan?: string;
+}

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

@@ -1,11 +1,16 @@
 import type * as HydraDB from "../index.js";
 export interface HandlerConnectorListResponse {
+    connectorLimit?: HydraDB.HandlerConnectorLimitView;
     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/HandlerEnvelopeSearchV2RetrievalResult.d.ts

@@ -1,6 +1,7 @@
 import type * as HydraDB from "../index.js";
 export interface HandlerEnvelopeSearchV2RetrievalResult {
-    data?: HydraDB.SearchV2RetrievalResult;
+    /** The response body, in the shape the database answers with: the v2 body (chunks, graph_context, sources and related fields), or the four-key body (chunks, graph, forceful_relations, llm_prompt). */
+    data?: HydraDB.HandlerEnvelopeSearchV2RetrievalResultData;
     /** Error message, empty string on success. */
     error?: HydraDB.HandlerApiError;
     meta?: HydraDB.HandlerResponseMeta;

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

@@ -0,0 +1,5 @@
+import type * as HydraDB from "../index.js";
+/**
+ * The response body, in the shape the database answers with: the v2 body (chunks, graph_context, sources and related fields), or the four-key body (chunks, graph, forceful_relations, llm_prompt).
+ */
+export type HandlerEnvelopeSearchV2RetrievalResultData = HydraDB.SearchV2RetrievalResult | HydraDB.SearchQueryResult;

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

@@ -0,0 +1,8 @@
+export interface IngestionGraphEntity {
+    identifier?: string;
+    /** Human-readable label for this resource. */
+    name?: string;
+    /** Namespace grouping for the entity (e.g. `organization`, `person`). */
+    namespace?: string;
+    type?: string;
+}

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

@@ -0,0 +1,5 @@
+import type * as HydraDB from "../index.js";
+export interface IngestionGraphPayload {
+    entities?: Record<string, HydraDB.IngestionGraphEntity>;
+    relations?: HydraDB.IngestionGraphRelation[];
+}

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

@@ -0,0 +1,9 @@
+export interface IngestionGraphRelation {
+    /** Verbatim passage from the source that evidences the relationship. */
+    context?: string;
+    predicate?: string;
+    source?: string;
+    target?: string;
+    /** Temporal context extracted alongside the relationship (e.g. `since 2024`). Serialized as null rather than omitted. */
+    temporalDetails?: string;
+}

package/dist/api/types/IngestionGraphRelation.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

@@ -35,6 +35,14 @@ export interface ListV2MemoryItem {
      */
     comments?: Record<string, unknown>[];
     commentsTruncated?: boolean;
+    /**
+     * ContextCategory is the context category the caller pinned on ingest:
+     * one of user_preference, business_knowledge or decision_trace, written
+     * onto the source row by the ingestion pipeline (PRO-1618). Absent when no
+     * category was pinned, on rows ingested before the category existed, and
+     * on every split-database row, which carries no category.
+     */
+    contextCategory?: string;
     /** Database is the canonical name for the scope this row was listed from. */
     database: string;
     /** Human-readable description of the source. */

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

@@ -38,6 +38,14 @@ export interface ListV2SourceItem {
     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;
+    /**
+     * ContextCategory is the context category the caller pinned on ingest:
+     * one of user_preference, business_knowledge or decision_trace, written
+     * onto the source row by the ingestion pipeline (PRO-1618). Absent when no
+     * category was pinned, on rows ingested before the category existed, and
+     * on every split-database row, which carries no category.
+     */
+    contextCategory?: string;
     /** Database is the canonical name for the scope this row was listed from. */
     database: string;
     /** Human-readable description of the source. */

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

@@ -0,0 +1,5 @@
+export interface MemoriesConversationTurn {
+    /** Extracted text content of the source document. */
+    content?: string;
+    role?: string;
+}