@opengeni/db 0.28.9 → 0.36.0

package/dist/insights.d.ts

@@ -1,4 +1,4 @@
-import type { Database } from "./database";
+import type { Database } from "./database.js";
 export type InsightsTimeWindow = {
     since: Date;
     until: Date;
@@ -11,10 +11,15 @@ export type ModelCallFactAggregateRow = {
     inputTokens: number;
     outputTokens: number;
     cachedTokens: number;
+    cacheInputTokens: number;
     cacheWriteTokens: number;
     reasoningTokens: number;
     totalTokens: number;
+    tokenKnownCalls: number;
+    cacheKnownCalls: number;
     pricedCostMicros: number;
+    estimatedProviderCostMicros: number;
+    estimatedProviderCostKnownCalls: number;
 };
 export type InsightsDayBucket = {
     day: string;
@@ -40,14 +45,20 @@ export type RootSessionDriverRow = {
     rootSessionId: string;
     title: string | null;
     pricedCostMicros: number;
-    inputTokens: number;
+    estimatedProviderCostMicros: number;
+    estimatedProviderCostKnownCalls: number;
+    totalTokens: number;
     cachedTokens: number;
+    cacheInputTokens: number;
 };
 export type ScheduleFactAggregate = {
     scheduledTaskId: string;
     pricedCostMicros: number;
-    inputTokens: number;
+    estimatedProviderCostMicros: number;
+    estimatedProviderCostKnownCalls: number;
+    totalTokens: number;
     cachedTokens: number;
+    cacheInputTokens: number;
     calls: number;
     /** Prefer credits whenever any credits-path call exists in the window. */
     billingPath: string;
@@ -71,6 +82,27 @@ export type FloorSessionRow = {
     updatedAt: Date;
     createdAt: Date;
 };
+export type RecentModelCallRow = {
+    id: string;
+    occurredAt: Date;
+    recordedAt: Date;
+    sessionId: string;
+    sessionTitle: string | null;
+    turnId: string;
+    provider: string;
+    providerApi: string;
+    model: string;
+    billingPath: string;
+    inputTokens: number | null;
+    outputTokens: number | null;
+    cachedTokens: number | null;
+    cacheWriteTokens: number | null;
+    reasoningTokens: number | null;
+    totalTokens: number | null;
+    pricedCostMicros: number;
+    estimatedProviderCostMicros: number | null;
+    pricingSource: string | null;
+};
 export declare function sumUsageQuantityInRange(db: Database, input: {
     workspaceId: string;
     eventType: string;
@@ -83,6 +115,12 @@ export declare function sumUsageQuantityByDay(db: Database, input: {
     since: Date;
     until: Date;
 }): Promise<Map<string, number>>;
+export declare function sumUsageQuantityByHour(db: Database, input: {
+    workspaceId: string;
+    eventType: string;
+    since: Date;
+    until: Date;
+}): Promise<Map<string, number>>;
 export declare function aggregateModelCallFacts(db: Database, input: {
     workspaceId: string;
     since: Date;
@@ -90,18 +128,35 @@ export declare function aggregateModelCallFacts(db: Database, input: {
     provider?: string | null;
     model?: string | null;
 }): Promise<ModelCallFactAggregateRow[]>;
+type ModelCallFactSeriesAggregate = {
+    costMicros: number;
+    estimatedProviderCostMicros: number;
+    estimatedProviderCostKnownCalls: number;
+    inputTokens: number;
+    outputTokens: number;
+    cachedTokens: number;
+    cacheInputTokens: number;
+    cacheWriteTokens: number;
+    reasoningTokens: number;
+    totalTokens: number;
+    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, {
-    costMicros: number;
-    inputTokens: number;
-    cachedTokens: number;
-    calls: number;
-}>>;
+}): 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;
@@ -118,6 +173,12 @@ export declare function aggregateRootSessionDrivers(db: Database, input: Insight
 export declare function listModelCallFacets(db: Database, input: InsightsTimeWindow & {
     workspaceId: string;
 }): Promise<ModelCallFacetRow[]>;
+export declare function listRecentModelCalls(db: Database, input: InsightsTimeWindow & {
+    workspaceId: string;
+    provider?: string | null;
+    model?: string | null;
+    limit?: number;
+}): Promise<RecentModelCallRow[]>;
 export declare function aggregateScheduleFacts(db: Database, input: InsightsTimeWindow & {
     workspaceId: string;
     provider?: string | null;
@@ -138,8 +199,9 @@ export declare function aggregateSessionDepth(db: Database, workspaceId: string)
     goalsCompleted: number;
 }>;
 export declare function listFloorSessions(db: Database, workspaceId: string, limit?: number): Promise<FloorSessionRow[]>;
-export declare function countOnlineMachines(db: Database, workspaceId: string, heartbeatFreshMs: number): Promise<number>;
+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).
@@ -155,3 +217,4 @@ export declare function backfillModelCallFactsFromSessionEvents(db: Database, in
     considered: number;
     upserted: number;
 }>;
+export {};

package/dist/integration-bindings.d.ts

@@ -0,0 +1,70 @@
+import type { Database } from "./database.js";
+import * as schema from "./schema.js";
+export type IntegrationFacetBindingOwner = {
+    kind: "direct" | "plugin" | "pack" | "migration";
+    id: string;
+    removable: boolean;
+};
+export type UpsertIntegrationFacetBindingInput = {
+    accountId: string;
+    workspaceId: string;
+    integrationFacetInstallationId: string;
+    facetDefinitionId: string;
+    bindingKey: string;
+    displayName: string;
+    runtimeKey?: string | null;
+    connectionId?: string | null;
+    config: Record<string, unknown>;
+    createdBySubjectId: string;
+    owner: IntegrationFacetBindingOwner;
+    expectedVersion?: number;
+};
+export declare class IntegrationFacetBindingVersionConflictError extends Error {
+    readonly bindingKey: string;
+    readonly expectedVersion: number;
+    readonly actualVersion: number;
+    readonly name = "IntegrationFacetBindingVersionConflictError";
+    constructor(bindingKey: string, expectedVersion: number, actualVersion: number);
+}
+export declare class IntegrationFacetBindingVersionRequiredError extends Error {
+    readonly name = "IntegrationFacetBindingVersionRequiredError";
+}
+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 ensureIntegrationFacetDefinition(db: Database, input: {
+    integrationFacetId: string;
+    facetKey: string;
+    kind: "tools" | "knowledge_source" | "inbound_trigger" | "delivery_destination" | "identity_link";
+    configSchema?: Record<string, unknown>;
+    capabilities?: Record<string, unknown>;
+}): Promise<typeof schema.integrationFacetDefinitions.$inferSelect>;
+export declare function upsertIntegrationFacetBinding(db: Database, input: UpsertIntegrationFacetBindingInput): Promise<{
+    row: typeof schema.integrationFacetBindings.$inferSelect;
+    changed: boolean;
+}>;
+export declare function listIntegrationFacetBindingOwners(db: Database, bindingId: string): Promise<IntegrationFacetBindingOwner[]>;
+export declare function removeIntegrationFacetBindingOwner(db: Database, input: {
+    workspaceId: string;
+    bindingId: string;
+    owner: Pick<IntegrationFacetBindingOwner, "kind" | "id">;
+    expectedVersion?: number;
+}): Promise<{
+    binding: typeof schema.integrationFacetBindings.$inferSelect | null;
+    remainingOwners: IntegrationFacetBindingOwner[];
+}>;
+export declare function removeIntegrationFacetBindingOwnersForOwner(db: Database, input: {
+    workspaceId: string;
+    owner: Pick<IntegrationFacetBindingOwner, "kind" | "id">;
+}): Promise<{
+    disabledBindingIds: string[];
+    retainedBindingIds: string[];
+}>;
+export declare function integrationDefinitionHasBindingOwner(db: Database, input: {
+    workspaceId: string;
+    pluginInstallationId: string;
+    owner: Pick<IntegrationFacetBindingOwner, "kind" | "id">;
+}): Promise<boolean>;
+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

@@ -0,0 +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>;