@opengeni/db 0.28.1 → 0.31.1

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;
@@ -98,8 +130,17 @@ export declare function aggregateModelCallFactsByDay(db: Database, input: {
     model?: string | null;
 }): Promise<Map<string, {
     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 aggregateWarmSecondsByGroup(db: Database, input: InsightsTimeWindow & {
@@ -118,6 +159,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,7 +185,7 @@ 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[];
 /**
  * Idempotent YTD backfill from authoritative agent.model.usage into model_call_facts.

package/dist/integration-bindings.d.ts

@@ -0,0 +1,70 @@
+import type { Database } from "./database.js";
+import * as schema from "./schema.js";
+export type IntegrationFeatureBindingOwner = {
+    kind: "direct" | "plugin" | "pack" | "migration";
+    id: string;
+    removable: boolean;
+};
+export type UpsertIntegrationFeatureBindingInput = {
+    accountId: string;
+    workspaceId: string;
+    integrationFacetInstallationId: string;
+    featureFacetId: string;
+    bindingKey: string;
+    displayName: string;
+    runtimeKey?: string | null;
+    connectionId?: string | null;
+    config: Record<string, unknown>;
+    createdBySubjectId: string;
+    owner: IntegrationFeatureBindingOwner;
+    expectedVersion?: number;
+};
+export declare class IntegrationFeatureBindingVersionConflictError extends Error {
+    readonly bindingKey: string;
+    readonly expectedVersion: number;
+    readonly actualVersion: number;
+    readonly name = "IntegrationFeatureBindingVersionConflictError";
+    constructor(bindingKey: string, expectedVersion: number, actualVersion: number);
+}
+export declare class IntegrationFeatureBindingVersionRequiredError extends Error {
+    readonly name = "IntegrationFeatureBindingVersionRequiredError";
+}
+export declare class IntegrationFeatureBindingOwnershipConflictError extends Error {
+    readonly name = "IntegrationFeatureBindingOwnershipConflictError";
+}
+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: {
+    integrationFacetId: string;
+    featureKey: 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;
+    changed: boolean;
+}>;
+export declare function listIntegrationFeatureBindingOwners(db: Database, bindingId: string): Promise<IntegrationFeatureBindingOwner[]>;
+export declare function removeIntegrationFeatureBindingOwner(db: Database, input: {
+    workspaceId: string;
+    bindingId: string;
+    owner: Pick<IntegrationFeatureBindingOwner, "kind" | "id">;
+    expectedVersion?: number;
+}): Promise<{
+    binding: typeof schema.integrationFeatureBindings.$inferSelect | null;
+    remainingOwners: IntegrationFeatureBindingOwner[];
+}>;
+export declare function removeIntegrationFeatureBindingOwnersForOwner(db: Database, input: {
+    workspaceId: string;
+    owner: Pick<IntegrationFeatureBindingOwner, "kind" | "id">;
+}): Promise<{
+    disabledBindingIds: string[];
+    retainedBindingIds: string[];
+}>;
+export declare function integrationDefinitionHasBindingOwner(db: Database, input: {
+    workspaceId: string;
+    pluginInstallationId: string;
+    owner: Pick<IntegrationFeatureBindingOwner, "kind" | "id">;
+}): Promise<boolean>;
+export declare function addIntegrationFeatureBindingOwner(db: Database, bindingId: string, input: Pick<UpsertIntegrationFeatureBindingInput, "accountId" | "workspaceId" | "owner">): Promise<void>;

package/dist/integration-features.d.ts

@@ -0,0 +1,99 @@
+import { type Database } from "./database.js";
+export type IntegrationFeatureKind = "knowledge_source" | "inbound_trigger" | "delivery_destination" | "identity_link";
+export type IntegrationFeatureBindingSummary = {
+    id: string;
+    featureKey: string;
+    kind: IntegrationFeatureKind;
+    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 IntegrationFeatureDefinitionSummary = {
+    featureKey: string;
+    kind: IntegrationFeatureKind;
+    configSchema: Record<string, unknown>;
+    capabilities: Record<string, unknown>;
+};
+export type IntegrationInstanceFeatures = {
+    capabilityId: string;
+    instanceKey: string;
+    providerDomain: string;
+    connectionId: string | null;
+    features: {
+        definition: IntegrationFeatureDefinitionSummary;
+        binding: IntegrationFeatureBindingSummary | null;
+    }[];
+};
+export type IntegrationFeatureMutationResult = {
+    capabilityId: string;
+    instanceKey: string;
+    featureKey: string;
+    status: "configured" | "paused" | "active";
+    binding: IntegrationFeatureBindingSummary;
+};
+export type IntegrationFeatureRemovalResult = {
+    capabilityId: string;
+    instanceKey: string;
+    featureKey: string;
+    status: "not_configured" | "removed" | "retained_by_other_owners";
+    binding: IntegrationFeatureBindingSummary | null;
+    remainingOwners: {
+        kind: "direct" | "plugin" | "pack" | "migration";
+        id: string;
+        removable: boolean;
+    }[];
+};
+export declare class IntegrationFeatureNotFoundError extends Error {
+    readonly name = "IntegrationFeatureNotFoundError";
+}
+export declare class IntegrationFeatureConnectionError extends Error {
+    readonly name = "IntegrationFeatureConnectionError";
+}
+export declare class IntegrationFeatureConfigError extends Error {
+    readonly name = "IntegrationFeatureConfigError";
+}
+export declare class IntegrationFeatureOperationIdempotencyError extends Error {
+    readonly name = "IntegrationFeatureOperationIdempotencyError";
+}
+export declare function listIntegrationInstanceFeatures(db: Database, workspaceId: string, subjectId: string, capabilityId: string, instanceKey: string): Promise<IntegrationInstanceFeatures>;
+export declare function configureIntegrationFeature(db: Database, input: {
+    accountId: string;
+    workspaceId: string;
+    subjectId: string;
+    capabilityId: string;
+    instanceKey: string;
+    featureKey: string;
+    displayName: string;
+    config: Record<string, unknown>;
+    expectedVersion?: number;
+    idempotencyKey: string;
+}): Promise<IntegrationFeatureMutationResult>;
+export declare function setIntegrationFeatureLifecycle(db: Database, input: {
+    accountId: string;
+    workspaceId: string;
+    subjectId: string;
+    capabilityId: string;
+    instanceKey: string;
+    featureKey: string;
+    action: "pause" | "resume";
+    expectedVersion: number;
+    idempotencyKey: string;
+}): Promise<IntegrationFeatureMutationResult>;
+export declare function removeIntegrationFeature(db: Database, input: {
+    accountId: string;
+    workspaceId: string;
+    subjectId: string;
+    capabilityId: string;
+    instanceKey: string;
+    featureKey: string;
+    expectedVersion: number;
+    idempotencyKey: string;
+}): Promise<IntegrationFeatureRemovalResult>;

package/dist/interaction-revisions.d.ts

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