@opengeni/db 0.31.1 → 0.36.0

package/dist/insights.d.ts

@@ -115,20 +115,20 @@ export declare function sumUsageQuantityByDay(db: Database, input: {
     since: Date;
     until: Date;
 }): Promise<Map<string, number>>;
-export declare function aggregateModelCallFacts(db: Database, input: {
+export declare function sumUsageQuantityByHour(db: Database, input: {
     workspaceId: string;
+    eventType: string;
     since: Date;
     until: Date;
-    provider?: string | null;
-    model?: string | null;
-}): Promise<ModelCallFactAggregateRow[]>;
-export declare function aggregateModelCallFactsByDay(db: Database, input: {
+}): Promise<Map<string, number>>;
+export declare function aggregateModelCallFacts(db: Database, input: {
     workspaceId: string;
     since: Date;
     until: Date;
     provider?: string | null;
     model?: string | null;
-}): Promise<Map<string, {
+}): Promise<ModelCallFactAggregateRow[]>;
+type ModelCallFactSeriesAggregate = {
     costMicros: number;
     estimatedProviderCostMicros: number;
     estimatedProviderCostKnownCalls: number;
@@ -142,7 +142,21 @@ export declare function aggregateModelCallFactsByDay(db: Database, input: {
     tokenKnownCalls: number;
     cacheKnownCalls: number;
     calls: number;
-}>>;
+};
+export declare function aggregateModelCallFactsByDay(db: Database, input: {
+    workspaceId: string;
+    since: Date;
+    until: Date;
+    provider?: string | null;
+    model?: string | null;
+}): Promise<Map<string, ModelCallFactSeriesAggregate>>;
+export declare function aggregateModelCallFactsByHour(db: Database, input: {
+    workspaceId: string;
+    since: Date;
+    until: Date;
+    provider?: string | null;
+    model?: string | null;
+}): Promise<Map<string, ModelCallFactSeriesAggregate>>;
 export declare function aggregateWarmSecondsByGroup(db: Database, input: InsightsTimeWindow & {
     workspaceId: string;
     limit?: number;
@@ -187,6 +201,7 @@ export declare function aggregateSessionDepth(db: Database, workspaceId: string)
 export declare function listFloorSessions(db: Database, workspaceId: string, limit?: number): Promise<FloorSessionRow[]>;
 export declare function countOnlineMachines(db: Database, workspaceId: string, heartbeatFreshMs: number, now?: Date): Promise<number>;
 export declare function enumerateUtcDays(since: Date, until: Date): string[];
+export declare function enumerateUtcHours(since: Date, until: Date): string[];
 /**
  * Idempotent YTD backfill from authoritative agent.model.usage into model_call_facts.
  * Never rewrites billing rows or existing live facts (onConflictDoNothing).
@@ -202,3 +217,4 @@ export declare function backfillModelCallFactsFromSessionEvents(db: Database, in
     considered: number;
     upserted: number;
 }>;
+export {};

package/dist/integration-bindings.d.ts

@@ -1,63 +1,63 @@
 import type { Database } from "./database.js";
 import * as schema from "./schema.js";
-export type IntegrationFeatureBindingOwner = {
+export type IntegrationFacetBindingOwner = {
     kind: "direct" | "plugin" | "pack" | "migration";
     id: string;
     removable: boolean;
 };
-export type UpsertIntegrationFeatureBindingInput = {
+export type UpsertIntegrationFacetBindingInput = {
     accountId: string;
     workspaceId: string;
     integrationFacetInstallationId: string;
-    featureFacetId: string;
+    facetDefinitionId: string;
     bindingKey: string;
     displayName: string;
     runtimeKey?: string | null;
     connectionId?: string | null;
     config: Record<string, unknown>;
     createdBySubjectId: string;
-    owner: IntegrationFeatureBindingOwner;
+    owner: IntegrationFacetBindingOwner;
     expectedVersion?: number;
 };
-export declare class IntegrationFeatureBindingVersionConflictError extends Error {
+export declare class IntegrationFacetBindingVersionConflictError extends Error {
     readonly bindingKey: string;
     readonly expectedVersion: number;
     readonly actualVersion: number;
-    readonly name = "IntegrationFeatureBindingVersionConflictError";
+    readonly name = "IntegrationFacetBindingVersionConflictError";
     constructor(bindingKey: string, expectedVersion: number, actualVersion: number);
 }
-export declare class IntegrationFeatureBindingVersionRequiredError extends Error {
-    readonly name = "IntegrationFeatureBindingVersionRequiredError";
+export declare class IntegrationFacetBindingVersionRequiredError extends Error {
+    readonly name = "IntegrationFacetBindingVersionRequiredError";
 }
-export declare class IntegrationFeatureBindingOwnershipConflictError extends Error {
-    readonly name = "IntegrationFeatureBindingOwnershipConflictError";
+export declare class IntegrationFacetBindingOwnershipConflictError extends Error {
+    readonly name = "IntegrationFacetBindingOwnershipConflictError";
 }
 export declare function integrationBindingKey(connectionId: string | null | undefined, requested?: string | null): string;
 export declare function integrationRuntimeKey(baseServerId: string, bindingKey: string): string;
-export declare function ensureIntegrationFeatureFacet(db: Database, input: {
+export declare function ensureIntegrationFacetDefinition(db: Database, input: {
     integrationFacetId: string;
-    featureKey: string;
+    facetKey: string;
     kind: "tools" | "knowledge_source" | "inbound_trigger" | "delivery_destination" | "identity_link";
     configSchema?: Record<string, unknown>;
     capabilities?: Record<string, unknown>;
-}): Promise<typeof schema.integrationFeatureFacets.$inferSelect>;
-export declare function upsertIntegrationFeatureBinding(db: Database, input: UpsertIntegrationFeatureBindingInput): Promise<{
-    row: typeof schema.integrationFeatureBindings.$inferSelect;
+}): Promise<typeof schema.integrationFacetDefinitions.$inferSelect>;
+export declare function upsertIntegrationFacetBinding(db: Database, input: UpsertIntegrationFacetBindingInput): Promise<{
+    row: typeof schema.integrationFacetBindings.$inferSelect;
     changed: boolean;
 }>;
-export declare function listIntegrationFeatureBindingOwners(db: Database, bindingId: string): Promise<IntegrationFeatureBindingOwner[]>;
-export declare function removeIntegrationFeatureBindingOwner(db: Database, input: {
+export declare function listIntegrationFacetBindingOwners(db: Database, bindingId: string): Promise<IntegrationFacetBindingOwner[]>;
+export declare function removeIntegrationFacetBindingOwner(db: Database, input: {
     workspaceId: string;
     bindingId: string;
-    owner: Pick<IntegrationFeatureBindingOwner, "kind" | "id">;
+    owner: Pick<IntegrationFacetBindingOwner, "kind" | "id">;
     expectedVersion?: number;
 }): Promise<{
-    binding: typeof schema.integrationFeatureBindings.$inferSelect | null;
-    remainingOwners: IntegrationFeatureBindingOwner[];
+    binding: typeof schema.integrationFacetBindings.$inferSelect | null;
+    remainingOwners: IntegrationFacetBindingOwner[];
 }>;
-export declare function removeIntegrationFeatureBindingOwnersForOwner(db: Database, input: {
+export declare function removeIntegrationFacetBindingOwnersForOwner(db: Database, input: {
     workspaceId: string;
-    owner: Pick<IntegrationFeatureBindingOwner, "kind" | "id">;
+    owner: Pick<IntegrationFacetBindingOwner, "kind" | "id">;
 }): Promise<{
     disabledBindingIds: string[];
     retainedBindingIds: string[];
@@ -65,6 +65,6 @@ export declare function removeIntegrationFeatureBindingOwnersForOwner(db: Databa
 export declare function integrationDefinitionHasBindingOwner(db: Database, input: {
     workspaceId: string;
     pluginInstallationId: string;
-    owner: Pick<IntegrationFeatureBindingOwner, "kind" | "id">;
+    owner: Pick<IntegrationFacetBindingOwner, "kind" | "id">;
 }): Promise<boolean>;
-export declare function addIntegrationFeatureBindingOwner(db: Database, bindingId: string, input: Pick<UpsertIntegrationFeatureBindingInput, "accountId" | "workspaceId" | "owner">): Promise<void>;
+export declare function addIntegrationFacetBindingOwner(db: Database, bindingId: string, input: Pick<UpsertIntegrationFacetBindingInput, "accountId" | "workspaceId" | "owner">): Promise<void>;

package/dist/integration-facets.d.ts

@@ -0,0 +1,99 @@
+import { type Database } from "./database.js";
+export type IntegrationFacetKind = "knowledge_source" | "inbound_trigger" | "delivery_destination" | "identity_link";
+export type IntegrationFacetBindingSummary = {
+    id: string;
+    facetKey: string;
+    kind: IntegrationFacetKind;
+    bindingKey: string;
+    displayName: string;
+    connectionId: string | null;
+    status: "active" | "paused" | "needs_attention" | "disabled";
+    config: Record<string, unknown>;
+    version: number;
+    hasCursor: boolean;
+    lastSuccessAt: string | null;
+    lastErrorCode: string | null;
+    createdAt: string;
+    updatedAt: string;
+};
+export type IntegrationFacetDefinitionSummary = {
+    facetKey: string;
+    kind: IntegrationFacetKind;
+    configSchema: Record<string, unknown>;
+    capabilities: Record<string, unknown>;
+};
+export type IntegrationInstanceFacets = {
+    capabilityId: string;
+    instanceKey: string;
+    providerDomain: string;
+    connectionId: string | null;
+    facets: {
+        definition: IntegrationFacetDefinitionSummary;
+        binding: IntegrationFacetBindingSummary | null;
+    }[];
+};
+export type IntegrationFacetMutationResult = {
+    capabilityId: string;
+    instanceKey: string;
+    facetKey: string;
+    status: "configured" | "paused" | "active";
+    binding: IntegrationFacetBindingSummary;
+};
+export type IntegrationFacetRemovalResult = {
+    capabilityId: string;
+    instanceKey: string;
+    facetKey: string;
+    status: "not_configured" | "removed" | "retained_by_other_owners";
+    binding: IntegrationFacetBindingSummary | null;
+    remainingOwners: {
+        kind: "direct" | "plugin" | "pack" | "migration";
+        id: string;
+        removable: boolean;
+    }[];
+};
+export declare class IntegrationFacetNotFoundError extends Error {
+    readonly name = "IntegrationFacetNotFoundError";
+}
+export declare class IntegrationFacetConnectionError extends Error {
+    readonly name = "IntegrationFacetConnectionError";
+}
+export declare class IntegrationFacetConfigError extends Error {
+    readonly name = "IntegrationFacetConfigError";
+}
+export declare class IntegrationFacetOperationIdempotencyError extends Error {
+    readonly name = "IntegrationFacetOperationIdempotencyError";
+}
+export declare function listIntegrationInstanceFacets(db: Database, workspaceId: string, subjectId: string, capabilityId: string, instanceKey: string): Promise<IntegrationInstanceFacets>;
+export declare function configureIntegrationFacet(db: Database, input: {
+    accountId: string;
+    workspaceId: string;
+    subjectId: string;
+    capabilityId: string;
+    instanceKey: string;
+    facetKey: string;
+    displayName: string;
+    config: Record<string, unknown>;
+    expectedVersion?: number;
+    idempotencyKey: string;
+}): Promise<IntegrationFacetMutationResult>;
+export declare function setIntegrationFacetLifecycle(db: Database, input: {
+    accountId: string;
+    workspaceId: string;
+    subjectId: string;
+    capabilityId: string;
+    instanceKey: string;
+    facetKey: string;
+    action: "pause" | "resume";
+    expectedVersion: number;
+    idempotencyKey: string;
+}): Promise<IntegrationFacetMutationResult>;
+export declare function removeIntegrationFacet(db: Database, input: {
+    accountId: string;
+    workspaceId: string;
+    subjectId: string;
+    capabilityId: string;
+    instanceKey: string;
+    facetKey: string;
+    expectedVersion: number;
+    idempotencyKey: string;
+}): Promise<IntegrationFacetRemovalResult>;

package/dist/interaction-revisions.d.ts

@@ -1,3 +1,14 @@
 import { type Database } from "./database.js";
 export declare function advanceWorkspaceInteractionRevision(db: Database, accountId: string, workspaceId: string): Promise<number>;
 export declare function readWorkspaceInteractionRevision(db: Database, workspaceId: string): Promise<number>;
+export type WorkspaceInteractionRevisionState = {
+    revision: number;
+    updatedAt: Date | null;
+};
+/** Read the latest cursor while already inside the workspace RLS boundary. */
+export declare function readWorkspaceInteractionRevisionState(db: Database, workspaceId: string): Promise<WorkspaceInteractionRevisionState>;
+/** Standalone tenant-scoped cursor read used by the workspace SSE projection. */
+export declare function getWorkspaceInteractionRevisionState(db: Database, input: {
+    accountId: string;
+    workspaceId: string;
+}): Promise<WorkspaceInteractionRevisionState>;