@secondlayer/shared 13.3.0 → 13.5.0

package/dist/src/db/queries/sync-scope.d.ts

@@ -369,8 +369,55 @@ interface SubgraphHealthSnapshotsTable {
 	total_processed: number;
 	total_errors: number;
 	last_processed_block: number | null;
+	chain_tip: string | number | null;
+	rows_written_total: string | number | null;
+	storage_bytes: string | number | null;
 	captured_at: Generated<Date>;
 }
+/** Handler errors grouped by fingerprint. Cap 50/subgraph. */
+interface SubgraphErrorGroupsTable {
+	id: Generated<string>;
+	subgraph_name: string;
+	fingerprint: string;
+	source_name: string;
+	event_type: string | null;
+	message: string;
+	frame: string | null;
+	count: Generated<string | number>;
+	sample_tx_id: string | null;
+	sample_block_height: string | number | null;
+	first_seen: Generated<Date>;
+	last_seen: Generated<Date>;
+}
+/**
+* One ranked dashboard insight. `account_id` is NULL on tenant and self-host
+* databases. `severity` is never "recovered": that is derived on read from
+* `resolved_at`.
+*/
+interface InsightsTable {
+	id: Generated<string>;
+	account_id: string | null;
+	resource_kind: string;
+	resource_id: string;
+	rule: string;
+	severity: string;
+	impact: Generated<number>;
+	/** resource, line, meta, lead, body, evidence, handoff, how. */
+	payload: unknown;
+	first_seen_at: Generated<Date>;
+	last_seen_at: Generated<Date>;
+	clear_streak: Generated<number>;
+	resolved_at: Date | null;
+	dismissed_at: Date | null;
+}
+/** "Expected": mutes one rule for one resource until removed. */
+interface InsightMutesTable {
+	account_id: string | null;
+	resource_kind: string;
+	resource_id: string;
+	rule: string;
+	created_at: Generated<Date>;
+}
 interface ProcessedStripeEventsTable {
 	event_id: string;
 	event_type: string;
@@ -847,6 +894,7 @@ interface Database {
 	subgraph_processing_stats: SubgraphProcessingStatsTable;
 	subgraph_gaps: SubgraphGapsTable;
 	subgraph_violations: SubgraphViolationsTable;
+	subgraph_error_groups: SubgraphErrorGroupsTable;
 	subgraph_operations: SubgraphOperationsTable;
 	processed_stripe_events: ProcessedStripeEventsTable;
 	account_spend_caps: AccountSpendCapsTable;
@@ -891,6 +939,8 @@ interface Database {
 	contact_requests: ContactRequestsTable;
 	api_failed_requests: ApiFailedRequestsTable;
 	api_request_log: ApiRequestLogTable;
+	insights: InsightsTable;
+	insight_mutes: InsightMutesTable;
 	feedback_tickets: FeedbackTicketsTable;
 }
 interface ServiceHeartbeatsTable {

package/dist/src/db/queries/webhooks.d.ts

@@ -359,8 +359,55 @@ interface SubgraphHealthSnapshotsTable {
 	total_processed: number;
 	total_errors: number;
 	last_processed_block: number | null;
+	chain_tip: string | number | null;
+	rows_written_total: string | number | null;
+	storage_bytes: string | number | null;
 	captured_at: Generated<Date>;
 }
+/** Handler errors grouped by fingerprint. Cap 50/subgraph. */
+interface SubgraphErrorGroupsTable {
+	id: Generated<string>;
+	subgraph_name: string;
+	fingerprint: string;
+	source_name: string;
+	event_type: string | null;
+	message: string;
+	frame: string | null;
+	count: Generated<string | number>;
+	sample_tx_id: string | null;
+	sample_block_height: string | number | null;
+	first_seen: Generated<Date>;
+	last_seen: Generated<Date>;
+}
+/**
+* One ranked dashboard insight. `account_id` is NULL on tenant and self-host
+* databases. `severity` is never "recovered": that is derived on read from
+* `resolved_at`.
+*/
+interface InsightsTable {
+	id: Generated<string>;
+	account_id: string | null;
+	resource_kind: string;
+	resource_id: string;
+	rule: string;
+	severity: string;
+	impact: Generated<number>;
+	/** resource, line, meta, lead, body, evidence, handoff, how. */
+	payload: unknown;
+	first_seen_at: Generated<Date>;
+	last_seen_at: Generated<Date>;
+	clear_streak: Generated<number>;
+	resolved_at: Date | null;
+	dismissed_at: Date | null;
+}
+/** "Expected": mutes one rule for one resource until removed. */
+interface InsightMutesTable {
+	account_id: string | null;
+	resource_kind: string;
+	resource_id: string;
+	rule: string;
+	created_at: Generated<Date>;
+}
 interface ProcessedStripeEventsTable {
 	event_id: string;
 	event_type: string;
@@ -837,6 +884,7 @@ interface Database {
 	subgraph_processing_stats: SubgraphProcessingStatsTable;
 	subgraph_gaps: SubgraphGapsTable;
 	subgraph_violations: SubgraphViolationsTable;
+	subgraph_error_groups: SubgraphErrorGroupsTable;
 	subgraph_operations: SubgraphOperationsTable;
 	processed_stripe_events: ProcessedStripeEventsTable;
 	account_spend_caps: AccountSpendCapsTable;
@@ -881,6 +929,8 @@ interface Database {
 	contact_requests: ContactRequestsTable;
 	api_failed_requests: ApiFailedRequestsTable;
 	api_request_log: ApiRequestLogTable;
+	insights: InsightsTable;
+	insight_mutes: InsightMutesTable;
 	feedback_tickets: FeedbackTicketsTable;
 }
 interface ServiceHeartbeatsTable {

package/dist/src/db/schema.d.ts

@@ -358,8 +358,55 @@ interface SubgraphHealthSnapshotsTable {
 	total_processed: number;
 	total_errors: number;
 	last_processed_block: number | null;
+	chain_tip: string | number | null;
+	rows_written_total: string | number | null;
+	storage_bytes: string | number | null;
 	captured_at: Generated<Date>;
 }
+/** Handler errors grouped by fingerprint. Cap 50/subgraph. */
+interface SubgraphErrorGroupsTable {
+	id: Generated<string>;
+	subgraph_name: string;
+	fingerprint: string;
+	source_name: string;
+	event_type: string | null;
+	message: string;
+	frame: string | null;
+	count: Generated<string | number>;
+	sample_tx_id: string | null;
+	sample_block_height: string | number | null;
+	first_seen: Generated<Date>;
+	last_seen: Generated<Date>;
+}
+/**
+* One ranked dashboard insight. `account_id` is NULL on tenant and self-host
+* databases. `severity` is never "recovered": that is derived on read from
+* `resolved_at`.
+*/
+interface InsightsTable {
+	id: Generated<string>;
+	account_id: string | null;
+	resource_kind: string;
+	resource_id: string;
+	rule: string;
+	severity: string;
+	impact: Generated<number>;
+	/** resource, line, meta, lead, body, evidence, handoff, how. */
+	payload: unknown;
+	first_seen_at: Generated<Date>;
+	last_seen_at: Generated<Date>;
+	clear_streak: Generated<number>;
+	resolved_at: Date | null;
+	dismissed_at: Date | null;
+}
+/** "Expected": mutes one rule for one resource until removed. */
+interface InsightMutesTable {
+	account_id: string | null;
+	resource_kind: string;
+	resource_id: string;
+	rule: string;
+	created_at: Generated<Date>;
+}
 interface ProcessedStripeEventsTable {
 	event_id: string;
 	event_type: string;
@@ -836,6 +883,7 @@ interface Database {
 	subgraph_processing_stats: SubgraphProcessingStatsTable;
 	subgraph_gaps: SubgraphGapsTable;
 	subgraph_violations: SubgraphViolationsTable;
+	subgraph_error_groups: SubgraphErrorGroupsTable;
 	subgraph_operations: SubgraphOperationsTable;
 	processed_stripe_events: ProcessedStripeEventsTable;
 	account_spend_caps: AccountSpendCapsTable;
@@ -880,6 +928,8 @@ interface Database {
 	contact_requests: ContactRequestsTable;
 	api_failed_requests: ApiFailedRequestsTable;
 	api_request_log: ApiRequestLogTable;
+	insights: InsightsTable;
+	insight_mutes: InsightMutesTable;
 	feedback_tickets: FeedbackTicketsTable;
 }
 interface ServiceHeartbeatsTable {
@@ -1234,4 +1284,4 @@ type WaitlistSignup = Selectable<WaitlistSignupsTable>;
 type InsertWaitlistSignup = Insertable<WaitlistSignupsTable>;
 type ContactRequest = Selectable<ContactRequestsTable>;
 type InsertContactRequest = Insertable<ContactRequestsTable>;
-export { Account, AccountBalanceAlerts, AccountBalanceAlertsTable, AccountCredits, AccountCreditsTable, AccountSpendCap, AccountSpendCapsTable, AccountsTable, ApiFailedRequest, ApiFailedRequestsTable, ApiKey, ApiKeysTable, ApiRequestLogRow, ApiRequestLogTable, ArchiveFetch, ArchiveFetchesTable, Block, BlocksTable, BnsMarketplaceAction, BnsMarketplaceEventsTable, BnsNameEventTopic, BnsNameEventsTable, BnsNamesTable, BnsNamespaceEventStatus, BnsNamespaceEventsTable, BnsNamespacesTable, BurnBlockRewardSlotsTable, BurnBlockRewardsTable, ChainReadCacheTable, ChainReorgsTable, ContactRequest, ContactRequestsTable, Contract, ContractsTable, CoverageSegmentsTable, Database, DeadLetterEventsTable, DecodedEventsTable, DecoderCheckpointsTable, Event, EventsArchiveTable, EventsTable, FailureClass, FailureUnit, FeedbackTicket, FeedbackTicketsTable, IndexProgress, IndexProgressTable, InsertAccount, InsertAccountBalanceAlerts, InsertAccountCredits, InsertAccountSpendCap, InsertApiFailedRequest, InsertApiKey, InsertApiRequestLogRow, InsertArchiveFetch, InsertBlock, InsertContactRequest, InsertContract, InsertEvent, InsertFeedbackTicket, InsertIndexProgress, InsertMagicLink, InsertMempoolTransaction, InsertSession, InsertStateWrite, InsertSubgraph, InsertSubgraphGap, InsertSubgraphHealthSnapshot, InsertSubgraphOperation, InsertTransaction, InsertUsageLedgerRow, InsertVmEvent, InsertWaitlistSignup, InsertWebhook, InsertWebhookDelivery, InsertWebhookOutbox, InstancesTable, MagicLink, MagicLinksTable, MempoolTransaction, MempoolTransactionsTable, NativeClock, ObserverJournalStatus, ObserverJournalTable, OutboxStatus, PendingForkBlocksTable, Pox4CallsTable, Pox4FunctionName, Pox5CycleSignersTable, Pox5CyclesTable, Pox5EventTopic, Pox5EventsTable, ProcessedStripeEventsTable, RepairMode, RetryState, RunStatus, SbtcEventTopic, SbtcEventsTable, SbtcSettlementsTable, SbtcTokenEventType, SbtcTokenEventsTable, SentinelAccount, SentinelAccountsTable, ServiceHeartbeatsTable, Session, SessionsTable, StageBlockReceiptsTable, StageFailuresTable, StageKind, StageRegistryTable, StageRunsTable, StateWrite, StateWritesArchiveTable, StateWritesTable, Subgraph, SubgraphGap, SubgraphGapsTable, SubgraphHealthSnapshot, SubgraphHealthSnapshotsTable, SubgraphOperation, SubgraphOperationKind, SubgraphOperationStatus, SubgraphOperationsTable, SubgraphProcessingStatsTable, SubgraphViolationsTable, SubgraphsTable, SyncScopesTable, Transaction, TransactionsArchiveTable, TransactionsTable, TriggerEvaluatorState, TriggerEvaluatorStateTable, UpdateAccountBalanceAlerts, UpdateAccountCredits, UpdateAccountSpendCap, UpdateApiKey, UpdateArchiveFetch, UpdateBlock, UpdateContract, UpdateEvent, UpdateIndexProgress, UpdateSubgraph, UpdateSubgraphOperation, UpdateTransaction, UpdateUsageLedgerRow, UpdateVmEvent, UpdateWebhook, UpdateWebhookOutbox, UsageLedgerRow, UsageLedgerTable, VmEvent, VmEventsArchiveTable, VmEventsTable, Waitlist, WaitlistSignup, WaitlistSignupsTable, WaitlistsTable, Webhook, WebhookDeliveriesTable, WebhookDelivery, WebhookFormat, WebhookKind, WebhookOutbox, WebhookOutboxTable, WebhookStatus, WebhooksTable };
+export { Account, AccountBalanceAlerts, AccountBalanceAlertsTable, AccountCredits, AccountCreditsTable, AccountSpendCap, AccountSpendCapsTable, AccountsTable, ApiFailedRequest, ApiFailedRequestsTable, ApiKey, ApiKeysTable, ApiRequestLogRow, ApiRequestLogTable, ArchiveFetch, ArchiveFetchesTable, Block, BlocksTable, BnsMarketplaceAction, BnsMarketplaceEventsTable, BnsNameEventTopic, BnsNameEventsTable, BnsNamesTable, BnsNamespaceEventStatus, BnsNamespaceEventsTable, BnsNamespacesTable, BurnBlockRewardSlotsTable, BurnBlockRewardsTable, ChainReadCacheTable, ChainReorgsTable, ContactRequest, ContactRequestsTable, Contract, ContractsTable, CoverageSegmentsTable, Database, DeadLetterEventsTable, DecodedEventsTable, DecoderCheckpointsTable, Event, EventsArchiveTable, EventsTable, FailureClass, FailureUnit, FeedbackTicket, FeedbackTicketsTable, IndexProgress, IndexProgressTable, InsertAccount, InsertAccountBalanceAlerts, InsertAccountCredits, InsertAccountSpendCap, InsertApiFailedRequest, InsertApiKey, InsertApiRequestLogRow, InsertArchiveFetch, InsertBlock, InsertContactRequest, InsertContract, InsertEvent, InsertFeedbackTicket, InsertIndexProgress, InsertMagicLink, InsertMempoolTransaction, InsertSession, InsertStateWrite, InsertSubgraph, InsertSubgraphGap, InsertSubgraphHealthSnapshot, InsertSubgraphOperation, InsertTransaction, InsertUsageLedgerRow, InsertVmEvent, InsertWaitlistSignup, InsertWebhook, InsertWebhookDelivery, InsertWebhookOutbox, InsightMutesTable, InsightsTable, InstancesTable, MagicLink, MagicLinksTable, MempoolTransaction, MempoolTransactionsTable, NativeClock, ObserverJournalStatus, ObserverJournalTable, OutboxStatus, PendingForkBlocksTable, Pox4CallsTable, Pox4FunctionName, Pox5CycleSignersTable, Pox5CyclesTable, Pox5EventTopic, Pox5EventsTable, ProcessedStripeEventsTable, RepairMode, RetryState, RunStatus, SbtcEventTopic, SbtcEventsTable, SbtcSettlementsTable, SbtcTokenEventType, SbtcTokenEventsTable, SentinelAccount, SentinelAccountsTable, ServiceHeartbeatsTable, Session, SessionsTable, StageBlockReceiptsTable, StageFailuresTable, StageKind, StageRegistryTable, StageRunsTable, StateWrite, StateWritesArchiveTable, StateWritesTable, Subgraph, SubgraphErrorGroupsTable, SubgraphGap, SubgraphGapsTable, SubgraphHealthSnapshot, SubgraphHealthSnapshotsTable, SubgraphOperation, SubgraphOperationKind, SubgraphOperationStatus, SubgraphOperationsTable, SubgraphProcessingStatsTable, SubgraphViolationsTable, SubgraphsTable, SyncScopesTable, Transaction, TransactionsArchiveTable, TransactionsTable, TriggerEvaluatorState, TriggerEvaluatorStateTable, UpdateAccountBalanceAlerts, UpdateAccountCredits, UpdateAccountSpendCap, UpdateApiKey, UpdateArchiveFetch, UpdateBlock, UpdateContract, UpdateEvent, UpdateIndexProgress, UpdateSubgraph, UpdateSubgraphOperation, UpdateTransaction, UpdateUsageLedgerRow, UpdateVmEvent, UpdateWebhook, UpdateWebhookOutbox, UsageLedgerRow, UsageLedgerTable, VmEvent, VmEventsArchiveTable, VmEventsTable, Waitlist, WaitlistSignup, WaitlistSignupsTable, WaitlistsTable, Webhook, WebhookDeliveriesTable, WebhookDelivery, WebhookFormat, WebhookKind, WebhookOutbox, WebhookOutboxTable, WebhookStatus, WebhooksTable };

package/dist/src/index.d.ts

@@ -577,8 +577,55 @@ interface SubgraphHealthSnapshotsTable {
 	total_processed: number;
 	total_errors: number;
 	last_processed_block: number | null;
+	chain_tip: string | number | null;
+	rows_written_total: string | number | null;
+	storage_bytes: string | number | null;
 	captured_at: Generated<Date>;
 }
+/** Handler errors grouped by fingerprint. Cap 50/subgraph. */
+interface SubgraphErrorGroupsTable {
+	id: Generated<string>;
+	subgraph_name: string;
+	fingerprint: string;
+	source_name: string;
+	event_type: string | null;
+	message: string;
+	frame: string | null;
+	count: Generated<string | number>;
+	sample_tx_id: string | null;
+	sample_block_height: string | number | null;
+	first_seen: Generated<Date>;
+	last_seen: Generated<Date>;
+}
+/**
+* One ranked dashboard insight. `account_id` is NULL on tenant and self-host
+* databases. `severity` is never "recovered": that is derived on read from
+* `resolved_at`.
+*/
+interface InsightsTable {
+	id: Generated<string>;
+	account_id: string | null;
+	resource_kind: string;
+	resource_id: string;
+	rule: string;
+	severity: string;
+	impact: Generated<number>;
+	/** resource, line, meta, lead, body, evidence, handoff, how. */
+	payload: unknown;
+	first_seen_at: Generated<Date>;
+	last_seen_at: Generated<Date>;
+	clear_streak: Generated<number>;
+	resolved_at: Date | null;
+	dismissed_at: Date | null;
+}
+/** "Expected": mutes one rule for one resource until removed. */
+interface InsightMutesTable {
+	account_id: string | null;
+	resource_kind: string;
+	resource_id: string;
+	rule: string;
+	created_at: Generated<Date>;
+}
 interface ProcessedStripeEventsTable {
 	event_id: string;
 	event_type: string;
@@ -1055,6 +1102,7 @@ interface Database {
 	subgraph_processing_stats: SubgraphProcessingStatsTable;
 	subgraph_gaps: SubgraphGapsTable;
 	subgraph_violations: SubgraphViolationsTable;
+	subgraph_error_groups: SubgraphErrorGroupsTable;
 	subgraph_operations: SubgraphOperationsTable;
 	processed_stripe_events: ProcessedStripeEventsTable;
 	account_spend_caps: AccountSpendCapsTable;
@@ -1099,6 +1147,8 @@ interface Database {
 	contact_requests: ContactRequestsTable;
 	api_failed_requests: ApiFailedRequestsTable;
 	api_request_log: ApiRequestLogTable;
+	insights: InsightsTable;
+	insight_mutes: InsightMutesTable;
 	feedback_tickets: FeedbackTicketsTable;
 }
 interface ServiceHeartbeatsTable {
@@ -2475,6 +2525,7 @@ declare const TABLE_TO_DB: {
 	subgraph_health_snapshots: string
 	subgraph_gaps: string
 	subgraph_violations: string
+	subgraph_error_groups: string
 	subgraph_processing_stats: string
 	account_credits: string
 	archive_fetches: string
@@ -2486,6 +2537,8 @@ declare const TABLE_TO_DB: {
 	contact_requests: string
 	api_failed_requests: string
 	api_request_log: string
+	insights: string
+	insight_mutes: string
 	feedback_tickets: string
 	service_heartbeats: string
 };
@@ -2733,10 +2786,98 @@ declare class Logger {
 }
 declare const logger: Logger;
 import { z as z3 } from "zod";
+/**
+* The insight contract. The tenant (`/api/insights`) and platform
+* (`/api/accounts/insights`) routes serve `Insight` verbatim. The web app keeps
+* a field-for-field copy in `apps/web/src/lib/insights.ts`; change both
+* together.
+*
+* The types are written out and the schemas annotated with them, rather than
+* inferred: the bundled `.d.ts` loses inferred zod types (they come out as
+* `unknown`), the same reason `schemas/webhooks.ts` annotates its schemas.
+*/
+declare const INSIGHT_SEVERITIES: readonly ["losing", "will_fail", "costs", "recovered"];
+type InsightSeverity = (typeof INSIGHT_SEVERITIES)[number];
+type InsightResourceKind = "webhook" | "subgraph" | "account";
+type InsightEvidence = {
+	kind: "series"
+	title: string
+	series: {
+		name: string
+		role: "a" | "context" | "mark"
+		points: number[]
+	}[]
+	labels: [number, string][]
+	unit?: string
+} | {
+	kind: "table"
+	title: string
+	columns: string[]
+	rows: (string | number)[][]
+	markRow?: number
+} | {
+	kind: "shapes"
+	title: string
+	shapes: {
+		code: string
+		body: string
+		count: number
+		isNew: boolean
+	}[]
+} | {
+	kind: "timeline"
+	title: string
+	steps: {
+		what: string
+		at: string
+		note?: string
+		failed: boolean
+	}[]
+};
+interface Insight {
+	id: string;
+	rule: string;
+	severity: InsightSeverity;
+	impact: number;
+	resource: {
+		kind: InsightResourceKind
+		id: string
+		name: string
+	};
+	line: string;
+	meta?: string;
+	lead: string;
+	body: string;
+	evidence: InsightEvidence[];
+	handoff: {
+		prompt: string
+		commands: string[]
+	};
+	how: {
+		detector: string
+		facts: [string, string][]
+		label?: {
+			cause: string
+			confidence: number
+		}
+	};
+	createdAt: string;
+	resolvedAt?: string | null;
+}
+interface InsightListResponse {
+	data: Insight[];
+}
+declare const InsightSeveritySchema: z3.ZodType<InsightSeverity>;
+declare const InsightResourceKindSchema: z3.ZodType<InsightResourceKind>;
+declare const InsightEvidenceSchema: z3.ZodType<InsightEvidence>;
+declare const InsightSchema: z3.ZodType<Insight>;
+declare const InsightListResponseSchema: z3.ZodType<InsightListResponse>;
+declare const SEVERITY_ORDER: Record<InsightSeverity, number>;
+import { z as z4 } from "zod";
 declare const WEBHOOK_FORMATS: readonly ["standard-webhooks", "inngest", "trigger", "cloudflare", "cloudevents", "raw"];
 declare const WEBHOOK_STATUSES: readonly ["active", "paused", "error"];
-declare const WebhookStatusSchema: z3.ZodType<WebhookStatus2>;
-declare const WebhookFormatSchema: z3.ZodType<WebhookFormat2>;
+declare const WebhookStatusSchema: z4.ZodType<WebhookStatus2>;
+declare const WebhookFormatSchema: z4.ZodType<WebhookFormat2>;
 declare const CHAIN_TRIGGER_TYPES: readonly ["stx_transfer", "stx_mint", "stx_burn", "stx_lock", "ft_transfer", "ft_mint", "ft_burn", "nft_transfer", "nft_mint", "nft_burn", "contract_call", "contract_deploy", "print_event", "nested_contract_call", "var_set", "map_set", "map_insert", "map_delete", "sbtc_deposit", "sbtc_withdrawal_create", "sbtc_withdrawal_accept", "sbtc_withdrawal_reject", "sbtc_withdrawal_swept_confirmed", "rune_etch", "rune_mint", "rune_transfer", "rune_burn"];
 /**
 * Per-type accepted filter fields for chain triggers, DERIVED from
@@ -2744,9 +2885,9 @@ declare const CHAIN_TRIGGER_TYPES: readonly ["stx_transfer", "stx_mint", "stx_bu
 * the validator. `{ stx_transfer: ["sender","recipient","minAmount","maxAmount"], ... }`.
 */
 declare const CHAIN_TRIGGER_FIELDS: Record<string, string[]>;
-declare const CreateWebhookRequestSchema: z3.ZodType<ParsedCreateWebhookRequest>;
-declare const UpdateWebhookRequestSchema: z3.ZodType<UpdateWebhookRequest>;
-declare const ReplayWebhookRequestSchema: z3.ZodType<ReplayWebhookRequest>;
+declare const CreateWebhookRequestSchema: z4.ZodType<ParsedCreateWebhookRequest>;
+declare const UpdateWebhookRequestSchema: z4.ZodType<UpdateWebhookRequest>;
+declare const ReplayWebhookRequestSchema: z4.ZodType<ReplayWebhookRequest>;
 type WebhookStatus2 = (typeof WEBHOOK_STATUSES)[number];
 /** Webhook kind (mirrors db/types `WebhookKind`). Chain events only. */
 type WebhookKind2 = "chain";
@@ -3020,7 +3161,7 @@ interface DeadRow {
 	failedAt: string | null;
 	createdAt: string;
 }
-declare function formatWebhookSchemaErrors(error: z3.ZodError): string[];
+declare function formatWebhookSchemaErrors(error: z4.ZodError): string[];
 type SubgraphSpecFormat = "openapi" | "agent" | "markdown";
 /** Options for generating a subgraph's agent schema. */
 interface SubgraphSpecOptions {
@@ -3066,6 +3207,27 @@ declare function generateSubgraphAgentSchema(detail: SubgraphDetail, options?: S
 declare function generateSubgraphOpenApi(detail: SubgraphDetail, options?: SubgraphSpecOptions): Record<string, unknown>;
 declare function generateSubgraphMarkdown(detail: SubgraphDetail, options?: SubgraphSpecOptions): string;
 declare function generateSubgraphSpec(detail: SubgraphDetail, format: SubgraphSpecFormat, options?: SubgraphSpecOptions): Record<string, unknown> | SubgraphAgentSchema | string;
+interface HealthSnapshotPoint {
+	captured_at: Date | string;
+	chain_tip: string | number | null;
+	last_processed_block: string | number | null;
+	rows_written_total: string | number | null;
+	total_errors: string | number;
+	total_processed: string | number;
+}
+interface HealthHour {
+	hour: string;
+	lagBlocks: number | null;
+	rowsWritten: number;
+	errors: number;
+	eventsHandled: number;
+}
+/**
+* Bucket snapshots into the last `hours` UTC hours (oldest first, ending with
+* the hour containing `now`). The delta for an hour also spans the boundary
+* from the previous hour's last snapshot, so no growth falls between buckets.
+*/
+declare function bucketHourly(snapshots: HealthSnapshotPoint[], hours: number, now?: number): HealthHour[];
 /** The etch a `rune_etch` event created — everything a consumer needs to
 *  render a fresh rune without a second lookup, minus what the envelope
 *  already carries (`rune_id`). Mirrors 058's `RuneEntry` shape
@@ -3456,4 +3618,4 @@ declare function publicKeyPemFromPrivate(privateKeyPem: string): string;
 declare function ed25519KeyId(publicKeyPem: string): string;
 declare function signEd25519(payload: string, privateKey: KeyObject): string;
 declare function verifyEd25519(payload: string, signatureBase64: string, publicKey: KeyObject): boolean;
-export { Account, AccountBalanceAlerts, AccountBalanceAlertsTable, AccountCredits, AccountCreditsTable, AccountSpendCap, AccountSpendCapsTable, AccountsTable, ApiFailedRequest, ApiFailedRequestsTable, ApiKey, ApiKeysTable, ApiRequestLogRow, ApiRequestLogTable, ArchiveFetch, ArchiveFetchesTable, AuthenticationError, AuthorizationError, BILLING_PAUSED_PREFIX, Block, BlocksTable, BnsMarketplaceAction, BnsMarketplaceEventsTable, BnsNameEventTopic, BnsNameEventsTable, BnsNamesTable, BnsNamespaceEventStatus, BnsNamespaceEventsTable, BnsNamespacesTable, BurnBlockRewardSlotsTable, BurnBlockRewardsTable, CHAIN_TRIGGER_FIELDS, CHAIN_TRIGGER_TYPES, CODE_TO_STATUS, ChainApplyDeliveryOf, ChainApplyEnvelope, ChainApplyEnvelopeOf, ChainEventEnvelope, ChainFtBurnData, ChainFtMintData, ChainFtTransferData, ChainNftBurnData, ChainNftMintData, ChainNftTransferData, ChainPrintEventData, ChainReadCacheTable, ChainReorgOrphanedEntry, ChainReorgRollbackDelivery, ChainReorgRollbackEnvelope, ChainReorgsTable, ChainStxBurnData, ChainStxLockData, ChainStxMintData, ChainStxTransferData, ChainTestDelivery, ChainTxLevelEvent, ChainWebhookDelivery, ChainWebhookEnvelope, ContactRequest, ContactRequestsTable, Contract, ContractsTable, CoverageSegmentsTable, CreateWebhookRequest, CreateWebhookRequestSchema, CreateWebhookResponse, DB_TO_STREAMS_EVENT_TYPE, DECODED_EVENT_TYPES2 as DECODED_EVENT_TYPES, DEFAULT_BTC_CONFIRMATIONS, Database, DatabaseError, DbPlane, DbReadRow, DbSplitStatus, DeadLetterEventsTable, DeadRow, DecodedEventType2 as DecodedEventType, DecodedEventsTable, DecoderCheckpointsTable, DeliveryRow, DeploySubgraphRequest, DeploySubgraphRequestSchema, DeploySubgraphResponse, EMPTY_RANGE_EVENT_INDEX_SENTINEL, Env, ErrorCode, ErrorCodes, Event, EventsArchiveTable, EventsTable, FailureClass, FailureUnit, FeedbackTicket, FeedbackTicketsTable, ForbiddenError, IndexColumn, IndexColumnType, IndexPrimaryKey, IndexProgress, IndexProgressTable, InsertAccount, InsertAccountBalanceAlerts, InsertAccountCredits, InsertAccountSpendCap, InsertApiFailedRequest, InsertApiKey, InsertApiRequestLogRow, InsertArchiveFetch, InsertBlock, InsertContactRequest, InsertContract, InsertEvent, InsertFeedbackTicket, InsertIndexProgress, InsertMagicLink, InsertMempoolTransaction, InsertSession, InsertStateWrite, InsertSubgraph, InsertSubgraphGap, InsertSubgraphHealthSnapshot, InsertSubgraphOperation, InsertTransaction, InsertUsageLedgerRow, InsertVmEvent, InsertWaitlistSignup, InsertWebhook, InsertWebhookDelivery, InsertWebhookOutbox, InstancesTable, KeyRotatedError, MagicLink, MagicLinksTable, MempoolTransaction, MempoolTransactionsTable, MigrationRole, NativeClock, NotFoundError, NumericAsText, ObserverJournalStatus, ObserverJournalTable, OutboxStatus, ParsedCreateWebhookRequest, ParsedReplayWebhookRequest, ParsedUpdateWebhookRequest, PaymentRequiredError, PendingForkBlocksTable, Pox4CallsTable, Pox4FunctionName, Pox5CycleSignersTable, Pox5CyclesTable, Pox5EventTopic, Pox5EventsTable, ProcessedStripeEventsTable, RUNE_EVENT_TYPES, RateLimitError, ReindexResponse, RepairMode, ReplayResult, ReplayWebhookRequest, ReplayWebhookRequestSchema, RetryState, RotateSecretResponse, RunStatus, RuneApplyDeliveryOf, RuneApplyEnvelope, RuneEventType, SOURCE_READ_COLUMNS, SOURCE_READ_PKS, SOURCE_READ_TYPES, STREAMS_DB_EVENT_TYPES, STREAMS_EVENT_TYPES, STREAMS_TO_DB_EVENT_TYPES, SbtcDepositEvent, SbtcEventTopic, SbtcEventsTable, SbtcSettlementsTable, SbtcTokenEventType, SbtcTokenEventsTable, SbtcWithdrawalEvent, SbtcWithdrawalSweptConfirmedEvent, SecondLayerError, SentinelAccount, SentinelAccountsTable, ServiceHeartbeatsTable, Session, SessionsTable, StageBlockReceiptsTable, StageFailuresTable, StageKind, StageRegistryTable, StageRunsTable, StateWrite, StateWritesArchiveTable, StateWritesTable, StreamsCursor, StreamsDbEventType, StreamsEventType, Subgraph, SubgraphAgentSchema, SubgraphAggregateParams, SubgraphAggregateResponse, SubgraphDetail, SubgraphGap, SubgraphGapEntry, SubgraphGapRange, SubgraphGapsResponse, SubgraphGapsTable, SubgraphHealthSnapshot, SubgraphHealthSnapshotsTable, SubgraphOperation, SubgraphOperationKind, SubgraphOperationStatus, SubgraphOperationsTable, SubgraphProcessingStatsTable, SubgraphQueryParams, SubgraphSpecFormat, SubgraphSpecOptions, SubgraphSummary, SubgraphSyncInfo, SubgraphVerification, SubgraphViolationsTable, SubgraphsTable, SyncScopesTable, TABLE_TO_DB, TenantSuspendedError, Transaction, TransactionsArchiveTable, TransactionsTable, TriggerEvaluatorState, TriggerEvaluatorStateTable, UpdateAccountBalanceAlerts, UpdateAccountCredits, UpdateAccountSpendCap, UpdateApiKey, UpdateArchiveFetch, UpdateBlock, UpdateContract, UpdateEvent, UpdateIndexProgress, UpdateSubgraph, UpdateSubgraphOperation, UpdateTransaction, UpdateUsageLedgerRow, UpdateVmEvent, UpdateWebhook, UpdateWebhookOutbox, UpdateWebhookRequest, UpdateWebhookRequestSchema, UsageLedgerRow, UsageLedgerTable, VM_EVENT_TYPES, VM_NODE_TO_STORED_TYPE2 as VM_NODE_TO_STORED_TYPE, VM_STORED_TO_NODE_TYPE, ValidationError, VersionConflictError, VmEvent, VmEventType, VmEventsArchiveTable, VmEventsTable, VmNodeEventType, WEBHOOK_FORMATS, WEBHOOK_STATUSES, Waitlist, WaitlistSignup, WaitlistSignupsTable, WaitlistsTable, Webhook, WebhookDeliveriesTable, WebhookDelivery, WebhookDetail, WebhookFormat, WebhookFormatSchema, WebhookKind, WebhookOutbox, WebhookOutboxTable, WebhookStatus, WebhookStatusSchema, WebhookSummary, WebhooksTable, applicationDatabaseUrl, assertDbSplit, billingPausedCode, blockEndCursor, closeDb, closeDbOrTimeout, committedHeight, compareStreamsCursor, exports_hmac as crypto, decodeStreamsCursor, describeDbUrl, exports_ed25519 as ed25519, encodeStreamsCursor, finalizedBurnHeight, formatWebhookSchemaErrors, generateSubgraphAgentSchema, generateSubgraphMarkdown, generateSubgraphOpenApi, generateSubgraphSpec, getDb, getDbSplitStatus, getEnv, getErrorMessage, getMigrationRole, getRawClient, getSourceDb, getTargetDb, isBnsDecoderEnabled, isEmptyRangeCursor, isPox4DecoderEnabled, isPox5DecoderEnabled, isSbtcDecoderEnabled, jsonb, logger, onChainPlane, onControlPlane, parseJsonb, resolveSourceUrl, resolveTargetUrl, setMigrationRole, sql };
+export { Account, AccountBalanceAlerts, AccountBalanceAlertsTable, AccountCredits, AccountCreditsTable, AccountSpendCap, AccountSpendCapsTable, AccountsTable, ApiFailedRequest, ApiFailedRequestsTable, ApiKey, ApiKeysTable, ApiRequestLogRow, ApiRequestLogTable, ArchiveFetch, ArchiveFetchesTable, AuthenticationError, AuthorizationError, BILLING_PAUSED_PREFIX, Block, BlocksTable, BnsMarketplaceAction, BnsMarketplaceEventsTable, BnsNameEventTopic, BnsNameEventsTable, BnsNamesTable, BnsNamespaceEventStatus, BnsNamespaceEventsTable, BnsNamespacesTable, BurnBlockRewardSlotsTable, BurnBlockRewardsTable, CHAIN_TRIGGER_FIELDS, CHAIN_TRIGGER_TYPES, CODE_TO_STATUS, ChainApplyDeliveryOf, ChainApplyEnvelope, ChainApplyEnvelopeOf, ChainEventEnvelope, ChainFtBurnData, ChainFtMintData, ChainFtTransferData, ChainNftBurnData, ChainNftMintData, ChainNftTransferData, ChainPrintEventData, ChainReadCacheTable, ChainReorgOrphanedEntry, ChainReorgRollbackDelivery, ChainReorgRollbackEnvelope, ChainReorgsTable, ChainStxBurnData, ChainStxLockData, ChainStxMintData, ChainStxTransferData, ChainTestDelivery, ChainTxLevelEvent, ChainWebhookDelivery, ChainWebhookEnvelope, ContactRequest, ContactRequestsTable, Contract, ContractsTable, CoverageSegmentsTable, CreateWebhookRequest, CreateWebhookRequestSchema, CreateWebhookResponse, DB_TO_STREAMS_EVENT_TYPE, DECODED_EVENT_TYPES2 as DECODED_EVENT_TYPES, DEFAULT_BTC_CONFIRMATIONS, Database, DatabaseError, DbPlane, DbReadRow, DbSplitStatus, DeadLetterEventsTable, DeadRow, DecodedEventType2 as DecodedEventType, DecodedEventsTable, DecoderCheckpointsTable, DeliveryRow, DeploySubgraphRequest, DeploySubgraphRequestSchema, DeploySubgraphResponse, EMPTY_RANGE_EVENT_INDEX_SENTINEL, Env, ErrorCode, ErrorCodes, Event, EventsArchiveTable, EventsTable, FailureClass, FailureUnit, FeedbackTicket, FeedbackTicketsTable, ForbiddenError, HealthHour, HealthSnapshotPoint, INSIGHT_SEVERITIES, IndexColumn, IndexColumnType, IndexPrimaryKey, IndexProgress, IndexProgressTable, InsertAccount, InsertAccountBalanceAlerts, InsertAccountCredits, InsertAccountSpendCap, InsertApiFailedRequest, InsertApiKey, InsertApiRequestLogRow, InsertArchiveFetch, InsertBlock, InsertContactRequest, InsertContract, InsertEvent, InsertFeedbackTicket, InsertIndexProgress, InsertMagicLink, InsertMempoolTransaction, InsertSession, InsertStateWrite, InsertSubgraph, InsertSubgraphGap, InsertSubgraphHealthSnapshot, InsertSubgraphOperation, InsertTransaction, InsertUsageLedgerRow, InsertVmEvent, InsertWaitlistSignup, InsertWebhook, InsertWebhookDelivery, InsertWebhookOutbox, Insight, InsightEvidence, InsightEvidenceSchema, InsightListResponse, InsightListResponseSchema, InsightMutesTable, InsightResourceKind, InsightResourceKindSchema, InsightSchema, InsightSeverity, InsightSeveritySchema, InsightsTable, InstancesTable, KeyRotatedError, MagicLink, MagicLinksTable, MempoolTransaction, MempoolTransactionsTable, MigrationRole, NativeClock, NotFoundError, NumericAsText, ObserverJournalStatus, ObserverJournalTable, OutboxStatus, ParsedCreateWebhookRequest, ParsedReplayWebhookRequest, ParsedUpdateWebhookRequest, PaymentRequiredError, PendingForkBlocksTable, Pox4CallsTable, Pox4FunctionName, Pox5CycleSignersTable, Pox5CyclesTable, Pox5EventTopic, Pox5EventsTable, ProcessedStripeEventsTable, RUNE_EVENT_TYPES, RateLimitError, ReindexResponse, RepairMode, ReplayResult, ReplayWebhookRequest, ReplayWebhookRequestSchema, RetryState, RotateSecretResponse, RunStatus, RuneApplyDeliveryOf, RuneApplyEnvelope, RuneEventType, SEVERITY_ORDER, SOURCE_READ_COLUMNS, SOURCE_READ_PKS, SOURCE_READ_TYPES, STREAMS_DB_EVENT_TYPES, STREAMS_EVENT_TYPES, STREAMS_TO_DB_EVENT_TYPES, SbtcDepositEvent, SbtcEventTopic, SbtcEventsTable, SbtcSettlementsTable, SbtcTokenEventType, SbtcTokenEventsTable, SbtcWithdrawalEvent, SbtcWithdrawalSweptConfirmedEvent, SecondLayerError, SentinelAccount, SentinelAccountsTable, ServiceHeartbeatsTable, Session, SessionsTable, StageBlockReceiptsTable, StageFailuresTable, StageKind, StageRegistryTable, StageRunsTable, StateWrite, StateWritesArchiveTable, StateWritesTable, StreamsCursor, StreamsDbEventType, StreamsEventType, Subgraph, SubgraphAgentSchema, SubgraphAggregateParams, SubgraphAggregateResponse, SubgraphDetail, SubgraphErrorGroupsTable, SubgraphGap, SubgraphGapEntry, SubgraphGapRange, SubgraphGapsResponse, SubgraphGapsTable, SubgraphHealthSnapshot, SubgraphHealthSnapshotsTable, SubgraphOperation, SubgraphOperationKind, SubgraphOperationStatus, SubgraphOperationsTable, SubgraphProcessingStatsTable, SubgraphQueryParams, SubgraphSpecFormat, SubgraphSpecOptions, SubgraphSummary, SubgraphSyncInfo, SubgraphVerification, SubgraphViolationsTable, SubgraphsTable, SyncScopesTable, TABLE_TO_DB, TenantSuspendedError, Transaction, TransactionsArchiveTable, TransactionsTable, TriggerEvaluatorState, TriggerEvaluatorStateTable, UpdateAccountBalanceAlerts, UpdateAccountCredits, UpdateAccountSpendCap, UpdateApiKey, UpdateArchiveFetch, UpdateBlock, UpdateContract, UpdateEvent, UpdateIndexProgress, UpdateSubgraph, UpdateSubgraphOperation, UpdateTransaction, UpdateUsageLedgerRow, UpdateVmEvent, UpdateWebhook, UpdateWebhookOutbox, UpdateWebhookRequest, UpdateWebhookRequestSchema, UsageLedgerRow, UsageLedgerTable, VM_EVENT_TYPES, VM_NODE_TO_STORED_TYPE2 as VM_NODE_TO_STORED_TYPE, VM_STORED_TO_NODE_TYPE, ValidationError, VersionConflictError, VmEvent, VmEventType, VmEventsArchiveTable, VmEventsTable, VmNodeEventType, WEBHOOK_FORMATS, WEBHOOK_STATUSES, Waitlist, WaitlistSignup, WaitlistSignupsTable, WaitlistsTable, Webhook, WebhookDeliveriesTable, WebhookDelivery, WebhookDetail, WebhookFormat, WebhookFormatSchema, WebhookKind, WebhookOutbox, WebhookOutboxTable, WebhookStatus, WebhookStatusSchema, WebhookSummary, WebhooksTable, applicationDatabaseUrl, assertDbSplit, billingPausedCode, blockEndCursor, bucketHourly, closeDb, closeDbOrTimeout, committedHeight, compareStreamsCursor, exports_hmac as crypto, decodeStreamsCursor, describeDbUrl, exports_ed25519 as ed25519, encodeStreamsCursor, finalizedBurnHeight, formatWebhookSchemaErrors, generateSubgraphAgentSchema, generateSubgraphMarkdown, generateSubgraphOpenApi, generateSubgraphSpec, getDb, getDbSplitStatus, getEnv, getErrorMessage, getMigrationRole, getRawClient, getSourceDb, getTargetDb, isBnsDecoderEnabled, isEmptyRangeCursor, isPox4DecoderEnabled, isPox5DecoderEnabled, isSbtcDecoderEnabled, jsonb, logger, onChainPlane, onControlPlane, parseJsonb, resolveSourceUrl, resolveTargetUrl, setMigrationRole, sql };