@hydradb/sdk 2.1.2 → 2.1.4

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

@@ -0,0 +1,40 @@
+import type * as HydraDB from "../index.js";
+export interface GraphSourceSubgraphResponse {
+    /**
+     * AuxiliaryRelations carries the structural graph around the member
+     * sources: Entity->Source presence, Source->Comment/Attachment and
+     * Actor->Source/Comment links. Same item shape as Relations, matching
+     * GraphRelationsResponse so the dashboard renderer works unchanged.
+     */
+    auxiliaryRelations?: HydraDB.GraphTripletWithEvidence[];
+    /**
+     * AuxiliaryTruncated reports that a fetch ceiling clipped the auxiliary
+     * graph, same contract as GraphRelationsResponse.AuxiliaryTruncated.
+     */
+    auxiliaryTruncated?: boolean;
+    /**
+     * IsTruncated reports that the traversal stopped before exhausting the
+     * connected component: the source budget or an edge/expansion fetch cap
+     * was hit, or the depth limit left an unexpanded frontier.
+     */
+    isTruncated?: boolean;
+    /** MaxDepthReached is the deepest BFS level that admitted a member. */
+    maxDepthReached?: number;
+    /** Human-readable result message. */
+    message?: string;
+    /**
+     * Relations holds the Source->Source triplets: every RELATES_TO edge whose
+     * endpoints are both members, plus synthesized same_thread / child_of
+     * provenance edges for members reached through a node property rather than
+     * a stored edge (those carry Synthesized on their evidence).
+     */
+    relations?: HydraDB.GraphTripletWithEvidence[];
+    seedSourceId?: string;
+    /**
+     * Sources is every member of the subgraph in BFS discovery order, seed
+     * first.
+     */
+    sources?: HydraDB.GraphSubgraphSource[];
+    /** Whether the request succeeded. */
+    success?: boolean;
+}

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

@@ -0,0 +1,28 @@
+export interface GraphSubgraphSource {
+    /** Provider-assigned identifier for this source (e.g. Slack channel ID). */
+    appExternalId?: string;
+    /** App integration category, populated for connector-synced sources. */
+    appKind?: string;
+    /** Provider name for app-sourced items (e.g. `slack`, `github`). */
+    appProvider?: string;
+    /** Depth is the BFS distance from the seed (0 for the seed itself). */
+    depth?: number;
+    discoveredRelation?: string;
+    /**
+     * DiscoveredVia and DiscoveredRelation record the traversal provenance:
+     * which already-admitted source this member was first reached from, and
+     * through which mechanism — a RELATES_TO relation_type (reply_to,
+     * child_of, ...), same_thread, parent or child. Empty on the seed.
+     */
+    discoveredVia?: string;
+    /**
+     * Hydration carries the same resolved/stub/placeholder classification
+     * Entity.Hydration documents: a RELATES_TO target may be a MERGE-created
+     * forward reference to a document that has not been ingested yet.
+     */
+    hydration?: string;
+    sourceId?: string;
+    threadId?: string;
+    /** Title or name of the source. */
+    title?: string;
+}

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

@@ -6,4 +6,11 @@ export interface GraphTripletWithEvidence {
     relations?: HydraDB.GraphRelationEvidence[];
     source?: HydraDB.GraphEntity;
     target?: HydraDB.GraphEntity;
+    /**
+     * Truncated is set on auxiliary triplets whose fan-out hit a per-node cap,
+     * so a caller can tell "this source has no more comments" from "we stopped
+     * counting". Omitted (false) on entity relations, which are bounded by the
+     * request's own limit/cursor instead.
+     */
+    truncated?: boolean;
 }

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

@@ -0,0 +1,26 @@
+export interface HandlerCatalogConnector {
+    category?: string;
+    isAlpha?: boolean;
+    isBeta?: boolean;
+    moveitSupport?: boolean;
+    /** External provider being synced (e.g. `slack`, `github`, `linear`, `notion`, `gmail`). */
+    provider?: string;
+    /** Rank is the dashboard display order (lower first); null means unranked. */
+    rank?: number;
+    rbacDescription?: string;
+    /**
+     * RBACSupport reports whether document-level ACL capture (PRO-1684) is
+     * enabled for this provider (the acl_supported control-plane flag), and
+     * RBACDescription says in one sentence WHAT is captured, so the dashboard
+     * can explain the capability instead of showing a bare boolean.
+     */
+    rbacSupport?: boolean;
+    supported?: boolean;
+    /**
+     * WebhookSupport marks a provider fed by an inbound webhook. The dashboard
+     * needs it to pick the credential form: it otherwise reads moveit_support=false
+     * as "classic", and renders the single-token form instead of the provider's
+     * declared credential schema.
+     */
+    webhookSupport?: boolean;
+}

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

@@ -0,0 +1,24 @@
+import type * as HydraDB from "../index.js";
+export interface HandlerConfigureResponse {
+    backfill?: boolean;
+    configured?: number;
+    /** Connector this resource belongs to. */
+    connectorId?: string;
+    /**
+     * FirstSyncAt/Message state the timing expectation: whether the first
+     * sync is already running (configure triggers one) or when the scheduled
+     * one runs, so clients stop inventing their own copy (PRO-1565).
+     */
+    firstSyncAt?: string;
+    /** Human-readable result message. */
+    message?: string;
+    meta?: HydraDB.HandlerConfigureResponseMeta;
+    /**
+     * Warnings names resources that were saved but produced nothing when
+     * probed. They are valid — the user may know a table is empty and expect it
+     * to fill — so they are not rejected, but they are the case that is
+     * otherwise indistinguishable from success at every layer, so they are
+     * never saved silently either.
+     */
+    warnings?: string[];
+}

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

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

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

@@ -0,0 +1,139 @@
+export interface HandlerConnectorApiView {
+    /**
+     * ACLChangesCursor is the provider permission-change feed's persisted
+     * cursor (PRO-1684; e.g. the Drive changes.list page token). Empty means
+     * uninitialized: the next cycle fetches a baseline and starts from now.
+     * Advanced ONLY after every reported change was applied, so a failed
+     * apply replays the same changes next cycle (at-least-once; the writes
+     * are idempotent full replacements).
+     */
+    aclChangesCursor?: string;
+    /**
+     * ActiveResourceCount mirrors the number of non-disabled resource rows so
+     * list responses can distinguish "no resources configured yet"
+     * (pending_setup) without a per-connector resources query.
+     */
+    activeResourceCount?: number;
+    /** Authentication method for the provider connection (e.g. `api_token`, `oauth`). */
+    authType?: 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;
+    /** Connector this resource belongs to. */
+    connectorId?: string;
+    /**
+     * CustomInstructions is optional free-text guidance applied when this
+     * connector's documents are ingested: it steers how content is interpreted
+     * and indexed. Max 4000 characters; changes apply from the next sync cycle.
+     */
+    customInstructions?: 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;
+    /**
+     * DocumentsDispatched is the running total of objects handed to ingestion
+     * across all completed cycles. It is dispatch *activity*, not an indexed
+     * count: upserts count every time they change, deletes are never
+     * subtracted, and an activity retry can double-count. Suitable as an
+     * is-data-moving signal, never as "N documents indexed".
+     */
+    documentsDispatched?: number;
+    /**
+     * FirstDataDispatchedAt is set once, by the first completed cycle that
+     * dispatched more than zero objects. Its presence is what proves the
+     * pipeline end to end; after it is set, an empty cycle is "nothing changed
+     * at the source", not "still ingesting".
+     */
+    firstDataDispatchedAt?: 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;
+    /**
+     * Lifecycle is the derived what-is-it-doing-now field and the one status
+     * clients should read (PRO-1565): reconnect | syncing | pending_setup |
+     * ingesting | active. The embedded `status` field is a scheduler-internal
+     * constant ("active" always) kept only for compatibility, and `sync_status`
+     * is the narrower mid-cycle indicator. Computed at the HTTP boundary from
+     * the connector's stored facts, never persisted, so it cannot disagree
+     * with them.
+     */
+    lifecycle?: string;
+    /** Human-readable label for this resource. */
+    name?: string;
+    needsReauth?: boolean;
+    needsReauthAt?: string;
+    needsReauthReason?: string;
+    /** RFC3339 timestamp when the next scheduled sync will run. */
+    nextSyncAt?: 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;
+    /**
+     * ResourcesPendingFirstSync counts active resources whose provider_cursor
+     * is still empty — resources that have never been successfully pulled.
+     * MOVEIT commits provider_cursor after every successful pull (even a
+     * zero-row one), so this self-clears one cycle after each resource first
+     * syncs. Recomputed by the MOVEIT sync workflow each cycle and by the
+     * resource-mutating handlers, so a resource added to a long-active
+     * connector re-enters the ingesting state.
+     */
+    resourcesPendingFirstSync?: number;
+    /** Current lifecycle or processing state. */
+    status?: string;
+    subTenantId?: string;
+    /**
+     * NeedsReauth is set by MOVEIT's OAuth refresh sweep when the provider has
+     * rejected the connector's refresh token (`invalid_grant` — expired, revoked,
+     * or, for a provider with single-use tokens, already spent).
+     *
+     * It is deliberately distinct from LastError, which records a *sync* failure.
+     * This is the one failure class no amount of retrying resolves: the stored
+     * grant is gone and only the tenant can mint a new one. Surfacing it as its
+     * own field is what lets a client show "reconnect" instead of a generic
+     * "sync failed", and the sweep clears it automatically on the next successful
+     * rotation, so a client can trust the absence of the flag as much as its
+     * presence.
+     *
+     * Only ever set on OAuth-bundle connectors. A connector authenticated with a
+     * static token or with client credentials (X posts: see the `client_id` /
+     * `client_secret` inputs on tap-twitter) has no refresh token and therefore
+     * cannot reach this state at all — which is the reason to prefer that shape
+     * where a provider offers it.
+     * SyncBlocked marks a connector stopped by a terminal failure — one no
+     * retry can fix. The scheduler skips it and next_sync_at is parked a
+     * century out; only a credential or config update clears it. Distinct from
+     * NeedsReauth, which is the OAuth sweep's own narrower signal: this covers
+     * any provider rejection of the stored credentials, including static keys
+     * that have no refresh token to sweep.
+     */
+    syncBlocked?: boolean;
+    syncBlockedAt?: string;
+    syncBlockedReason?: string;
+    /**
+     * SyncCyclesCompleted counts successfully completed sync cycles. Bounded
+     * use only: it lets DeriveLifecycle stop reporting "ingesting" after a few
+     * clean-but-empty cycles on a source that genuinely has nothing to pull.
+     */
+    syncCyclesCompleted?: number;
+    /**
+     * 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. Bounded per provider; send 0 or omit to use the provider default. Change it later with PATCH /connectors/{id}. */
+    syncIntervalSeconds?: number;
+    /** Current sync operation state (e.g. `idle`, `running`). */
+    syncStatus?: string;
+    tenantId?: string;
+}

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

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

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

@@ -0,0 +1,143 @@
+export interface HandlerConnectorCreateResponse {
+    /**
+     * ACLChangesCursor is the provider permission-change feed's persisted
+     * cursor (PRO-1684; e.g. the Drive changes.list page token). Empty means
+     * uninitialized: the next cycle fetches a baseline and starts from now.
+     * Advanced ONLY after every reported change was applied, so a failed
+     * apply replays the same changes next cycle (at-least-once; the writes
+     * are idempotent full replacements).
+     */
+    aclChangesCursor?: string;
+    /**
+     * ActiveResourceCount mirrors the number of non-disabled resource rows so
+     * list responses can distinguish "no resources configured yet"
+     * (pending_setup) without a per-connector resources query.
+     */
+    activeResourceCount?: number;
+    /** Authentication method for the provider connection (e.g. `api_token`, `oauth`). */
+    authType?: 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;
+    /** Connector this resource belongs to. */
+    connectorId?: string;
+    /**
+     * CustomInstructions is optional free-text guidance applied when this
+     * connector's documents are ingested: it steers how content is interpreted
+     * and indexed. Max 4000 characters; changes apply from the next sync cycle.
+     */
+    customInstructions?: 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;
+    /**
+     * DocumentsDispatched is the running total of objects handed to ingestion
+     * across all completed cycles. It is dispatch *activity*, not an indexed
+     * count: upserts count every time they change, deletes are never
+     * subtracted, and an activity retry can double-count. Suitable as an
+     * is-data-moving signal, never as "N documents indexed".
+     */
+    documentsDispatched?: number;
+    /**
+     * FirstDataDispatchedAt is set once, by the first completed cycle that
+     * dispatched more than zero objects. Its presence is what proves the
+     * pipeline end to end; after it is set, an empty cycle is "nothing changed
+     * at the source", not "still ingesting".
+     */
+    firstDataDispatchedAt?: string;
+    /** FirstSyncAt is when the first scheduled sync runs (RFC3339). */
+    firstSyncAt?: 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;
+    /**
+     * Lifecycle is the derived what-is-it-doing-now field and the one status
+     * clients should read (PRO-1565): reconnect | syncing | pending_setup |
+     * ingesting | active. The embedded `status` field is a scheduler-internal
+     * constant ("active" always) kept only for compatibility, and `sync_status`
+     * is the narrower mid-cycle indicator. Computed at the HTTP boundary from
+     * the connector's stored facts, never persisted, so it cannot disagree
+     * with them.
+     */
+    lifecycle?: string;
+    /** Message is a human-readable expectation, safe to show verbatim. */
+    message?: string;
+    /** Human-readable label for this resource. */
+    name?: string;
+    needsReauth?: boolean;
+    needsReauthAt?: string;
+    needsReauthReason?: string;
+    /** RFC3339 timestamp when the next scheduled sync will run. */
+    nextSyncAt?: 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;
+    /**
+     * ResourcesPendingFirstSync counts active resources whose provider_cursor
+     * is still empty — resources that have never been successfully pulled.
+     * MOVEIT commits provider_cursor after every successful pull (even a
+     * zero-row one), so this self-clears one cycle after each resource first
+     * syncs. Recomputed by the MOVEIT sync workflow each cycle and by the
+     * resource-mutating handlers, so a resource added to a long-active
+     * connector re-enters the ingesting state.
+     */
+    resourcesPendingFirstSync?: number;
+    /** Current lifecycle or processing state. */
+    status?: string;
+    subTenantId?: string;
+    /**
+     * NeedsReauth is set by MOVEIT's OAuth refresh sweep when the provider has
+     * rejected the connector's refresh token (`invalid_grant` — expired, revoked,
+     * or, for a provider with single-use tokens, already spent).
+     *
+     * It is deliberately distinct from LastError, which records a *sync* failure.
+     * This is the one failure class no amount of retrying resolves: the stored
+     * grant is gone and only the tenant can mint a new one. Surfacing it as its
+     * own field is what lets a client show "reconnect" instead of a generic
+     * "sync failed", and the sweep clears it automatically on the next successful
+     * rotation, so a client can trust the absence of the flag as much as its
+     * presence.
+     *
+     * Only ever set on OAuth-bundle connectors. A connector authenticated with a
+     * static token or with client credentials (X posts: see the `client_id` /
+     * `client_secret` inputs on tap-twitter) has no refresh token and therefore
+     * cannot reach this state at all — which is the reason to prefer that shape
+     * where a provider offers it.
+     * SyncBlocked marks a connector stopped by a terminal failure — one no
+     * retry can fix. The scheduler skips it and next_sync_at is parked a
+     * century out; only a credential or config update clears it. Distinct from
+     * NeedsReauth, which is the OAuth sweep's own narrower signal: this covers
+     * any provider rejection of the stored credentials, including static keys
+     * that have no refresh token to sweep.
+     */
+    syncBlocked?: boolean;
+    syncBlockedAt?: string;
+    syncBlockedReason?: string;
+    /**
+     * SyncCyclesCompleted counts successfully completed sync cycles. Bounded
+     * use only: it lets DeriveLifecycle stop reporting "ingesting" after a few
+     * clean-but-empty cycles on a source that genuinely has nothing to pull.
+     */
+    syncCyclesCompleted?: number;
+    /**
+     * 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. Bounded per provider; send 0 or omit to use the provider default. Change it later with PATCH /connectors/{id}. */
+    syncIntervalSeconds?: number;
+    /** Current sync operation state (e.g. `idle`, `running`). */
+    syncStatus?: string;
+    tenantId?: string;
+}

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

@@ -0,0 +1,6 @@
+export interface HandlerConnectorDeleteResponse {
+    /** Connector this resource belongs to. */
+    connectorId?: string;
+    /** Whether this specific item was deleted. */
+    deleted?: boolean;
+}

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

@@ -0,0 +1,11 @@
+import type * as HydraDB from "../index.js";
+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.
+     */
+    health?: Record<string, string>;
+}

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

@@ -0,0 +1,37 @@
+export interface HandlerConnectorResourceStatus {
+    /** Action is what the user must do, when there is something they can do. */
+    action?: string;
+    checkedAt?: string;
+    /** Human-readable name for this resource. */
+    displayName?: string;
+    /** HTTPStatus is the provider's response code when one was reported. */
+    httpStatus?: number;
+    /** LastRowCount is the rows produced by the last sync. */
+    lastRowCount?: number;
+    /** Message is the provider's own words when Status is failed. */
+    message?: string;
+    /** Resource identifier from the Discover endpoint. */
+    resourceId?: string;
+    /**
+     * Retryable is set only for a failed resource: false for a provider
+     * rejection the user must fix (403, 404, a misconfigured table), true for
+     * something that may clear on its own.
+     */
+    retryable?: boolean;
+    /** Status is one of ok | empty | failed | checking | unknown. */
+    status?: string;
+    /**
+     * SyncBlocked reports that this resource has stopped syncing. Distinct from
+     * a failed status: a resource can fail a cycle and be retried, and the
+     * difference between "failing" and "given up on" is the one a user needs to
+     * act on.
+     */
+    syncBlocked?: boolean;
+    /** SyncBlockedAt is when it stopped (RFC3339). */
+    syncBlockedAt?: string;
+    /**
+     * SyncBlockedReason is why it stopped, preserved from the failure that
+     * stopped it so it survives later syncs overwriting the health block.
+     */
+    syncBlockedReason?: string;
+}

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

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

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

@@ -0,0 +1,19 @@
+/**
+ * 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.
+ */
+export interface HandlerConnectorStatusError {
+    /** Action is what the user must do, when there is something they can do. */
+    action?: string;
+    /** DetectedAt is when the failure was observed (RFC3339). */
+    detectedAt?: string;
+    /** Human-readable result message. */
+    message?: string;
+    /**
+     * Retryable reports whether waiting can fix this. False means only the user
+     * can: a rejected credential is not a transient error, and telling someone
+     * to retry a dead OAuth grant wastes their time.
+     */
+    retryable?: boolean;
+}

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

@@ -0,0 +1,37 @@
+import type * as HydraDB from "../index.js";
+export interface HandlerConnectorStatusResponse {
+    /** Connector this resource belongs to. */
+    connectorId?: string;
+    /** Error message, empty string on success. */
+    error?: HydraDB.HandlerConnectorStatusError;
+    /** RFC3339 timestamp of the most recent sync attempt (successful or not). */
+    lastAttemptedSyncAt?: string;
+    /** RFC3339 timestamp of the last successful sync completion. */
+    lastSuccessfulSyncAt?: string;
+    /**
+     * Lifecycle is the derived what-is-it-doing-now field (PRO-1565):
+     * reconnect | syncing | pending_setup | ingesting | active. Orthogonal to
+     * the health rollup above — a connector can be ingesting and healthy, or
+     * active and degraded.
+     */
+    lifecycle?: string;
+    /** RFC3339 timestamp when the next scheduled sync will run. */
+    nextSyncAt?: string;
+    /** External provider being synced (e.g. `slack`, `github`, `linear`, `notion`, `gmail`). */
+    provider?: string;
+    /**
+     * Resources is one entry per configured resource, always non-nil so it
+     * serialises as [] rather than null.
+     */
+    resources?: HydraDB.HandlerConnectorResourceStatus[];
+    /**
+     * Status is the rollup: healthy | degraded | failed | checking. It is the
+     * worst of the credential state and every resource state.
+     */
+    status?: string;
+    /**
+     * SyncStatus is the in-progress indicator ("syncing"/"idle"), orthogonal to
+     * Status — a connector can be mid-sync and degraded at the same time.
+     */
+    syncStatus?: string;
+}

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

@@ -0,0 +1,4 @@
+export interface HandlerConnectorSyncResponse {
+    runId?: string;
+    workflowId?: string;
+}

package/dist/api/types/HandlerConnectorSyncResponse.js

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