@opengeni/db 1.1.0 → 1.2.0

package/dist/connect-attempts.js

@@ -7,9 +7,9 @@ import {
   getConnectAttempt,
   getConnectBeginReplay,
   listPendingConnectAttempts
-} from "./chunk-BLUQG54M.js";
-import "./chunk-SKYRM7R7.js";
-import "./chunk-VOB6TXSJ.js";
+} from "./chunk-CONWNUSL.js";
+import "./chunk-O2Y5E5M3.js";
+import "./chunk-FWQNHNOU.js";
 import "./chunk-P7YDM2RI.js";
 import "./chunk-PZ5AY32C.js";
 export {

package/dist/credit-balances.d.ts

@@ -0,0 +1,18 @@
+import type { BillingBalance } from "@opengeni/contracts";
+import type { Database } from "./database.js";
+/** Read totals and grant remainders from one database snapshot. */
+type CreditBalanceSnapshot = BillingBalance & {
+    creditPolicyRevision?: number;
+};
+export declare function getBillingBalance(db: Database, accountId: string, policyRevision?: number): Promise<CreditBalanceSnapshot>;
+/** Missing model means a non-model resource, which can only use general credits. */
+export declare function spendableCreditMicros(balance: BillingBalance, modelId?: string): number;
+export declare function getSpendableCreditBalance(db: Database, accountId: string, modelId?: string, policyRevision?: number): Promise<CreditBalanceSnapshot>;
+export declare function planCreditDebit(balance: BillingBalance, requestedMicros: number, modelId?: string): {
+    debitedMicros: number;
+    allocations: {
+        grantEntryId: string;
+        amountMicros: number;
+    }[];
+};
+export {};

package/dist/credit-promotion-policy.d.ts

@@ -0,0 +1,10 @@
+import { type Database } from "./database.js";
+/** Runtime policy supersedes deployment bootstrap configuration. No process cache. */
+export declare function readCreditPromotionPolicy(db: Database): Promise<{
+    defaultModelIds?: string[] | undefined;
+    signupModelIds?: string[] | undefined;
+    offers: Record<string, {
+        label: string;
+        eligibleModelIds?: string[] | undefined;
+    }>;
+} | null>;

package/dist/editable-artifact-durable-export.js

@@ -1,8 +1,8 @@
 import {
   rawRows,
   withRlsContext
-} from "./chunk-SKYRM7R7.js";
-import "./chunk-VOB6TXSJ.js";
+} from "./chunk-O2Y5E5M3.js";
+import "./chunk-FWQNHNOU.js";
 import "./chunk-P7YDM2RI.js";
 import "./chunk-PZ5AY32C.js";
 

package/dist/editable-artifacts.js

@@ -10,9 +10,9 @@ import {
   listEditableArtifactIdsForSession,
   touchEditableArtifactSessionLink,
   transactionallyAuthorizeEditableArtifactActor
-} from "./chunk-BZV5ZDRY.js";
-import "./chunk-SKYRM7R7.js";
-import "./chunk-VOB6TXSJ.js";
+} from "./chunk-LXPFNG4L.js";
+import "./chunk-O2Y5E5M3.js";
+import "./chunk-FWQNHNOU.js";
 import "./chunk-P7YDM2RI.js";
 import "./chunk-PZ5AY32C.js";
 export {

package/dist/index.d.ts

@@ -1,3 +1,5 @@
+export { readCreditPromotionPolicy } from "./credit-promotion-policy.js";
+export { getBillingBalance, getSpendableCreditBalance, spendableCreditMicros, } from "./credit-balances.js";
 export { SubscriptionAccountChangedError } from "./subscription-account-conflict.js";
 import type { GoalAdmissionPausedReason } from "@opengeni/contracts";
 export declare const getScheduledTaskClaudeProviderAccountAuthoritySnapshot: (db: Database, workspaceId: string, taskId: string) => Promise<{
@@ -96,6 +98,7 @@ import { type SQL } from "drizzle-orm";
 export { frozenInitiatorForCommandActor, type FrozenTurnInitiator } from "./turn-initiator.js";
 export { LOSSLESS_TEXT_PREFIX } from "./lossless-json.js";
 import { type NewSessionDraftSnapshot } from "./new-session-drafts.js";
+export { DatabaseTransactionError } from "./persistence-errors.js";
 import { type SessionDiscoveryControl, type SessionCommandActor, type SessionTurnAttemptOutcome } from "./session-control.js";
 import { type ConnectedMachineBackgroundCommandClaim } from "./session-background-commands.js";
 import { type SessionRealtimeContinuityEntry } from "./session-realtime-context.js";
@@ -1046,6 +1049,7 @@ export declare function applyCreditLedgerEntry(db: Database, input: {
     workspaceId?: string | null;
     type: string;
     amountMicros: number;
+    eligibleModelIds?: string[] | undefined;
     sourceType?: string | null;
     sourceId?: string | null;
     idempotencyKey: string;
@@ -1057,6 +1061,9 @@ export declare function applyCreditDebitUpToBalance(db: Database, input: {
     workspaceId?: string | null;
     type: string;
     requestedAmountMicros: number;
+    /** Canonical, accepted model ID. Omitted for non-model usage. */
+    modelId?: string;
+    creditPolicyRevision?: number | undefined;
     sourceType?: string | null;
     sourceId?: string | null;
     idempotencyKey: string;
@@ -1112,7 +1119,6 @@ export declare function recordStripeWebhookEvent(db: Database, input: {
 }): Promise<boolean>;
 export declare function isStripeWebhookProcessed(db: Database, id: string): Promise<boolean>;
 export declare function markStripeWebhookProcessed(db: Database, id: string): Promise<void>;
-export declare function getBillingBalance(db: Database, accountId: string): Promise<BillingBalance>;
 /**
  * Whether the organization holds a positive OpenGeni credit balance, whatever
  * its source: a purchase, an operator grant, a test credit, or the one-time
@@ -8296,16 +8302,24 @@ export declare function reapStaleLeaseHolders(db: Database, input: {
     drained: ReapDrainable[];
 }>;
 /** Settlement reasons for legacy retained commands that containment stopped
- * after a verified checkpoint. Neither is exit proof: the command settles
+ * after a verified checkpoint. None is exit proof: the command settles
  * `lost` with no exit code. */
 export declare const IDLE_COMMAND_CONTAINMENT_REASON = "idle_containment";
 export declare const DEADLINE_COMMAND_CONTAINMENT_REASON = "provider_deadline_containment";
+export declare const QUIESCENCE_COMMAND_CONTAINMENT_REASON = "quiescence_containment";
+type SettledCommandOwner = {
+    sessionId: string;
+    attemptId: string;
+    temporalWorkflowId: string;
+    temporalWorkflowRunId: string;
+    temporalActivityId: string;
+};
 /** Bounded per-candidate containment inspection outcomes (metric labels). */
-export type CommandContainmentInspection = "idle_enrolled" | "deadline_enrolled" | "resumed_enrolled" | "not_eligible" | "inspection_failed";
+export type CommandContainmentInspection = "idle_enrolled" | "deadline_enrolled" | "quiescence_enrolled" | "resumed_enrolled" | "not_eligible" | "inspection_failed";
 export type CommandContainmentEnrollment = ReapDrainable & {
-    /** `idle`/`deadline` newly enrolled this call; `resumed` continues an
+    /** `idle`/`deadline`/`quiescence` newly enrolled this call; `resumed` continues an
      * existing enrollment whose drain has not committed yet. */
-    mode: "idle" | "deadline" | "resumed";
+    mode: "idle" | "deadline" | "quiescence" | "resumed";
 };
 /** Pending machine input that would start a turn in an idle session, by the
  * wake class map: every immediate kind except terminal command results (held
@@ -8337,6 +8351,8 @@ export declare function enrollRetainedCommandContainment(db: Database, input: {
     sandboxGroupId: string;
     /** Omit to evaluate only the provider-deadline rule. */
     idleCommandContainmentMs?: number | undefined;
+    /** Internal recovery authority: caller verified exact Temporal settlement. */
+    settledOwner?: SettledCommandOwner;
 }): Promise<CommandContainmentEnrollment | null>;
 export declare function reapStaleLeaseHoldersGlobal(db: Database, input: {
     viewerHolderTtlMs: number;