@opengeni/db 1.0.2 → 1.2.0

package/dist/connect-attempts.js

@@ -7,9 +7,9 @@ import {
   getConnectAttempt,
   getConnectBeginReplay,
   listPendingConnectAttempts
-} from "./chunk-OQZOGCLG.js";
-import "./chunk-56MYWKQV.js";
-import "./chunk-LDTQGYD2.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-56MYWKQV.js";
-import "./chunk-LDTQGYD2.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-Y77PVZZD.js";
-import "./chunk-56MYWKQV.js";
-import "./chunk-LDTQGYD2.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,4 +1,7 @@
+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<{
     version: 1;
     scope: "organization";
@@ -95,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";
@@ -1045,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;
@@ -1056,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;
@@ -1111,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
@@ -3306,7 +3313,7 @@ export declare function recordScheduledTaskAdmissionFailure(db: Database, input:
     diagnostic: ConnectionAccountSelectionDiagnostic;
 }): Promise<ScheduledTaskRun>;
 /** Reasons a scheduled occurrence is refused before accepting execution. */
-export type ScheduledTaskAdmissionRefusalReason = "scheduled_authority_unavailable" | "machine_target_unavailable" | "machine_enrollment_inactive" | "variable_set_unavailable" | "rig_version_unavailable" | "insufficient_credits" | "allowance_exhausted" | "monthly_model_cost_limit" | "monthly_agent_run_limit";
+export type ScheduledTaskAdmissionRefusalReason = "scheduled_authority_unavailable" | "machine_target_unavailable" | "machine_enrollment_inactive" | "variable_set_unavailable" | "rig_version_unavailable" | "scheduled_model_unavailable" | "insufficient_credits" | "allowance_exhausted" | "monthly_model_cost_limit" | "monthly_agent_run_limit";
 /**
  * Record a refused occurrence as an immutable run receipt under its producer
  * identity (migration 0539). A transient refusal is `skipped`, a terminal one
@@ -8295,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
@@ -8336,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;
@@ -10400,6 +10417,11 @@ export declare function updateSessionTitleWithEvent(db: Database, input: {
     title: string | null;
     events: SessionEvent[];
 }>;
+/** Read-only admission at a locked paused-to-active transition. */
+export type SessionGoalResumeValidation = (tx: Database, session: Pick<Session, "accountId" | "workspaceId" | "model" | "codexCompactionMode" | "latencyMode">, causalTurn: {
+    id: string;
+    initiatingHumanSubjectId: string | null;
+} | null) => Promise<void>;
 /**
  * Status transition helper. Idempotent: requesting the current status returns
  * `changed: false` so callers can skip emitting a duplicate event. `completed`
@@ -10417,6 +10439,8 @@ export declare function setSessionGoalStatus(db: Database, workspaceId: string,
     commandActor?: Extract<SessionCommandActor, {
         type: "agent_attempt";
     }>;
+    /** Runs under the canonical control/session/goal locks, before a paused goal changes. */
+    beforeResume?: SessionGoalResumeValidation;
 }): Promise<{
     goal: SessionGoal;
     changed: boolean;
@@ -10445,6 +10469,7 @@ export declare function setSessionGoalStatusWithEvent(db: Database, workspaceId:
     commandActor?: Extract<SessionCommandActor, {
         type: "agent_attempt";
     }>;
+    beforeResume?: SessionGoalResumeValidation;
     event: SetSessionGoalStatusEvent;
 }): Promise<{
     goal: SessionGoal;
@@ -10459,7 +10484,7 @@ export type GoalContinuationDecision = {
     decision: "queue";
 } | {
     decision: "paused";
-    reason: "max_auto_continuations" | "limits" | "allowance";
+    reason: "max_auto_continuations" | "limits" | GoalAdmissionPausedReason;
     goal: SessionGoal;
 } | {
     decision: "continue";
@@ -10479,7 +10504,7 @@ export declare function evaluateGoalContinuation(db: Database, input: {
     sessionId: string;
     defaultMaxAutoContinuations?: number | null;
     budgetBlocked?: string | null;
-    budgetPausedReason?: "limits" | "allowance" | undefined;
+    budgetPausedReason?: "limits" | GoalAdmissionPausedReason | undefined;
 }): Promise<GoalContinuationDecision>;
 export declare const GOAL_IDLE_BACKOFF_WAKE_REASON = "goal_idle_backoff";
 /**
@@ -10526,7 +10551,7 @@ export declare function materializeGoalContinuation(db: Database, input: {
     workflowId: string;
     defaultMaxAutoContinuations?: number | null;
     budgetBlocked?: string | null;
-    budgetPausedReason?: "limits" | "allowance" | undefined;
+    budgetPausedReason?: "limits" | GoalAdmissionPausedReason | undefined;
     /** Trusted worker admission, evaluated under the same session/goal locks
      * as lineage materialization. Never substitutes a mutable latest human. */
     admission?: (tx: Database, causalTurn: {
@@ -10534,7 +10559,7 @@ export declare function materializeGoalContinuation(db: Database, input: {
         initiatingHumanSubjectId: string | null;
     } | null) => Promise<{
         budgetBlocked: string | null;
-        budgetPausedReason?: "limits" | "allowance";
+        budgetPausedReason?: "limits" | GoalAdmissionPausedReason;
     }>;
     idleBackoff?: GoalIdleBackoffPolicy | null;
     policy: {