@robosystems/client 1.3.0 → 1.4.1

package/artifacts/LedgerClient.d.ts

@@ -97,7 +97,17 @@ export interface InitializeLedgerResult {
 }
 export interface ClosePeriodResult {
     period: string;
+    /**
+     * Total drafts the close moved to posted, across both post paths. A close
+     * that published everything to QuickBooks used to report 0 here, because
+     * the pre-publish step promotes each draft before the local bulk
+     * transition counts it; both paths are summed now.
+     */
     entriesPosted: number;
+    /** Drafts published to QuickBooks by the close's pre-publish step. */
+    entriesPublishedToQb: number;
+    /** Drafts posted by the local bulk transition (never reach QuickBooks). */
+    entriesPostedLocally: number;
     targetAutoAdvanced: boolean;
     fiscalCalendar: LedgerFiscalCalendar;
     /**
@@ -152,6 +162,13 @@ export interface InitializeLedgerOptions {
 export interface ClosePeriodOptions {
     note?: string | null;
     allowStaleSync?: boolean;
+    /**
+     * Close despite matured obligations that were never drafted, knowingly
+     * omitting those adjusting entries. Prefer re-running promotion with
+     * handler dispatch, or voiding the obligations. The override is recorded
+     * in the close audit note.
+     */
+    allowStrandedObligations?: boolean;
 }
 export interface CreateScheduleOptions {
     name: string;

package/artifacts/LedgerClient.js

@@ -579,12 +579,15 @@ class LedgerClient {
             period,
             note: options?.note ?? null,
             allow_stale_sync: options?.allowStaleSync,
+            allow_stranded_obligations: options?.allowStrandedObligations,
         };
         const envelope = await this.callOperation('Close period', (0, sdk_gen_1.closePeriod)({ path: { graph_id: graphId }, body }));
         const raw = envelope.result;
         return {
             period: raw.period,
             entriesPosted: raw.entries_posted ?? 0,
+            entriesPublishedToQb: raw.entries_published_to_qb ?? 0,
+            entriesPostedLocally: raw.entries_posted_locally ?? 0,
             targetAutoAdvanced: raw.target_auto_advanced ?? false,
             fiscalCalendar: rawFiscalCalendarToCamel(raw.fiscal_calendar),
             ruleSummary: raw.rule_summary ?? null,
@@ -1079,6 +1082,14 @@ class LedgerClient {
 }
 exports.LedgerClient = LedgerClient;
 // ── Module-private conversion helpers ─────────────────────────────────
+function rawObligationDetailToCamel(raw) {
+    return {
+        eventId: raw.event_id,
+        scheduleId: raw.schedule_id ?? null,
+        scheduleName: raw.schedule_name ?? null,
+        period: raw.period,
+    };
+}
 function rawFiscalCalendarToCamel(raw) {
     return {
         graphId: raw.graph_id,
@@ -1089,6 +1100,12 @@ function rawFiscalCalendarToCamel(raw) {
         catchUpSequence: raw.catch_up_sequence ?? [],
         closeableNow: raw.closeable_now ?? false,
         blockers: raw.blockers ?? [],
+        pendingObligationCount: raw.pending_obligation_count ?? 0,
+        pendingObligationSample: (raw.pending_obligation_sample ?? []).map(rawObligationDetailToCamel),
+        earliestPendingPeriod: raw.earliest_pending_period ?? null,
+        strandedObligationCount: raw.stranded_obligation_count ?? 0,
+        strandedObligationSample: (raw.stranded_obligation_sample ?? []).map(rawObligationDetailToCamel),
+        syncStaleDays: raw.sync_stale_days ?? null,
         lastCloseAt: raw.last_close_at ?? null,
         initializedAt: raw.initialized_at ?? null,
         lastSyncAt: raw.last_sync_at ?? null,

package/artifacts/LedgerClient.ts

@@ -345,6 +345,13 @@ export interface CreateReportOptions {
 // consumers; for simple ack/ack-with-id payloads we keep the raw shape.
 
 /** Snake-case shape returned in envelope.result for fiscal calendar writes. */
+interface RawObligationDetail {
+  event_id: string
+  schedule_id?: string | null
+  schedule_name?: string | null
+  period: string
+}
+
 interface RawFiscalCalendar {
   graph_id: string
   fiscal_year_start_month: number
@@ -354,6 +361,15 @@ interface RawFiscalCalendar {
   catch_up_sequence: string[]
   closeable_now: boolean
   blockers: string[]
+  // Detail for actionable blockers — the API populates each only when its
+  // corresponding code is in `blockers`, so a caller can name which
+  // schedules hold the close rather than just that something does.
+  pending_obligation_count?: number
+  pending_obligation_sample?: RawObligationDetail[]
+  earliest_pending_period?: string | null
+  stranded_obligation_count?: number
+  stranded_obligation_sample?: RawObligationDetail[]
+  sync_stale_days?: number | null
   last_close_at: string | null
   initialized_at: string | null
   last_sync_at: string | null
@@ -375,6 +391,8 @@ interface RawInitializeLedgerResult {
 interface RawClosePeriodResult {
   period: string
   entries_posted: number
+  entries_published_to_qb?: number
+  entries_posted_locally?: number
   target_auto_advanced: boolean
   fiscal_calendar: RawFiscalCalendar
   // §3.8 — auto-run rules on close. `null` when no schedules with facts
@@ -404,7 +422,17 @@ export interface InitializeLedgerResult {
 
 export interface ClosePeriodResult {
   period: string
+  /**
+   * Total drafts the close moved to posted, across both post paths. A close
+   * that published everything to QuickBooks used to report 0 here, because
+   * the pre-publish step promotes each draft before the local bulk
+   * transition counts it; both paths are summed now.
+   */
   entriesPosted: number
+  /** Drafts published to QuickBooks by the close's pre-publish step. */
+  entriesPublishedToQb: number
+  /** Drafts posted by the local bulk transition (never reach QuickBooks). */
+  entriesPostedLocally: number
   targetAutoAdvanced: boolean
   fiscalCalendar: LedgerFiscalCalendar
   /**
@@ -466,6 +494,13 @@ export interface InitializeLedgerOptions {
 export interface ClosePeriodOptions {
   note?: string | null
   allowStaleSync?: boolean
+  /**
+   * Close despite matured obligations that were never drafted, knowingly
+   * omitting those adjusting entries. Prefer re-running promotion with
+   * handler dispatch, or voiding the obligations. The override is recorded
+   * in the close audit note.
+   */
+  allowStrandedObligations?: boolean
 }
 
 export interface CreateScheduleOptions {
@@ -1603,6 +1638,7 @@ export class LedgerClient {
       period,
       note: options?.note ?? null,
       allow_stale_sync: options?.allowStaleSync,
+      allow_stranded_obligations: options?.allowStrandedObligations,
     }
     const envelope = await this.callOperation(
       'Close period',
@@ -1612,6 +1648,8 @@ export class LedgerClient {
     return {
       period: raw.period,
       entriesPosted: raw.entries_posted ?? 0,
+      entriesPublishedToQb: raw.entries_published_to_qb ?? 0,
+      entriesPostedLocally: raw.entries_posted_locally ?? 0,
       targetAutoAdvanced: raw.target_auto_advanced ?? false,
       fiscalCalendar: rawFiscalCalendarToCamel(raw.fiscal_calendar),
       ruleSummary: raw.rule_summary ?? null,
@@ -2363,6 +2401,15 @@ export class LedgerClient {
 
 // ── Module-private conversion helpers ─────────────────────────────────
 
+function rawObligationDetailToCamel(raw: RawObligationDetail) {
+  return {
+    eventId: raw.event_id,
+    scheduleId: raw.schedule_id ?? null,
+    scheduleName: raw.schedule_name ?? null,
+    period: raw.period,
+  }
+}
+
 function rawFiscalCalendarToCamel(raw: RawFiscalCalendar): LedgerFiscalCalendar {
   return {
     graphId: raw.graph_id,
@@ -2373,6 +2420,14 @@ function rawFiscalCalendarToCamel(raw: RawFiscalCalendar): LedgerFiscalCalendar
     catchUpSequence: raw.catch_up_sequence ?? [],
     closeableNow: raw.closeable_now ?? false,
     blockers: raw.blockers ?? [],
+    pendingObligationCount: raw.pending_obligation_count ?? 0,
+    pendingObligationSample: (raw.pending_obligation_sample ?? []).map(rawObligationDetailToCamel),
+    earliestPendingPeriod: raw.earliest_pending_period ?? null,
+    strandedObligationCount: raw.stranded_obligation_count ?? 0,
+    strandedObligationSample: (raw.stranded_obligation_sample ?? []).map(
+      rawObligationDetailToCamel
+    ),
+    syncStaleDays: raw.sync_stale_days ?? null,
     lastCloseAt: raw.last_close_at ?? null,
     initializedAt: raw.initialized_at ?? null,
     lastSyncAt: raw.last_sync_at ?? null,

package/artifacts/graphql/generated/graphql.d.ts

@@ -317,10 +317,10 @@ export type EventBlock = {
     externalId: Maybe<Scalars['String']['output']>;
     externalUrl: Maybe<Scalars['String']['output']>;
     id: Scalars['String']['output'];
+    isReconcilingItem: Scalars['Boolean']['output'];
     metadata: Scalars['JSON']['output'];
     obligatedByEventId: Maybe<Scalars['String']['output']>;
     occurredAt: Scalars['DateTime']['output'];
-    payloadDrift: Scalars['Boolean']['output'];
     replacedByEventId: Maybe<Scalars['String']['output']>;
     replacesEventId: Maybe<Scalars['String']['output']>;
     resourceElementId: Maybe<Scalars['String']['output']>;
@@ -1620,9 +1620,9 @@ export type QueryEventBlocksArgs = {
     agentId?: InputMaybe<Scalars['String']['input']>;
     eventCategory?: InputMaybe<Scalars['String']['input']>;
     eventType?: InputMaybe<Scalars['String']['input']>;
+    isReconcilingItem?: InputMaybe<Scalars['Boolean']['input']>;
     limit?: InputMaybe<Scalars['Int']['input']>;
     offset?: InputMaybe<Scalars['Int']['input']>;
-    payloadDrift?: InputMaybe<Scalars['Boolean']['input']>;
     source?: InputMaybe<Scalars['String']['input']>;
     status?: InputMaybe<Scalars['String']['input']>;
 };
@@ -2771,9 +2771,25 @@ export type GetLedgerFiscalCalendarQuery = {
         catchUpSequence: Array<string>;
         closeableNow: boolean;
         blockers: Array<string>;
+        pendingObligationCount: number;
+        earliestPendingPeriod: string | null;
+        strandedObligationCount: number;
+        syncStaleDays: number | null;
         lastCloseAt: any | null;
         initializedAt: any | null;
         lastSyncAt: any | null;
+        pendingObligationSample: Array<{
+            eventId: string;
+            scheduleId: string | null;
+            scheduleName: string | null;
+            period: string;
+        }>;
+        strandedObligationSample: Array<{
+            eventId: string;
+            scheduleId: string | null;
+            scheduleName: string | null;
+            period: string;
+        }>;
         periods: Array<{
             name: string;
             startDate: any;

package/artifacts/graphql/generated/graphql.js

@@ -1621,6 +1621,36 @@ exports.GetLedgerFiscalCalendarDocument = {
                                 { kind: 'Field', name: { kind: 'Name', value: 'catchUpSequence' } },
                                 { kind: 'Field', name: { kind: 'Name', value: 'closeableNow' } },
                                 { kind: 'Field', name: { kind: 'Name', value: 'blockers' } },
+                                { kind: 'Field', name: { kind: 'Name', value: 'pendingObligationCount' } },
+                                {
+                                    kind: 'Field',
+                                    name: { kind: 'Name', value: 'pendingObligationSample' },
+                                    selectionSet: {
+                                        kind: 'SelectionSet',
+                                        selections: [
+                                            { kind: 'Field', name: { kind: 'Name', value: 'eventId' } },
+                                            { kind: 'Field', name: { kind: 'Name', value: 'scheduleId' } },
+                                            { kind: 'Field', name: { kind: 'Name', value: 'scheduleName' } },
+                                            { kind: 'Field', name: { kind: 'Name', value: 'period' } },
+                                        ],
+                                    },
+                                },
+                                { kind: 'Field', name: { kind: 'Name', value: 'earliestPendingPeriod' } },
+                                { kind: 'Field', name: { kind: 'Name', value: 'strandedObligationCount' } },
+                                {
+                                    kind: 'Field',
+                                    name: { kind: 'Name', value: 'strandedObligationSample' },
+                                    selectionSet: {
+                                        kind: 'SelectionSet',
+                                        selections: [
+                                            { kind: 'Field', name: { kind: 'Name', value: 'eventId' } },
+                                            { kind: 'Field', name: { kind: 'Name', value: 'scheduleId' } },
+                                            { kind: 'Field', name: { kind: 'Name', value: 'scheduleName' } },
+                                            { kind: 'Field', name: { kind: 'Name', value: 'period' } },
+                                        ],
+                                    },
+                                },
+                                { kind: 'Field', name: { kind: 'Name', value: 'syncStaleDays' } },
                                 { kind: 'Field', name: { kind: 'Name', value: 'lastCloseAt' } },
                                 { kind: 'Field', name: { kind: 'Name', value: 'initializedAt' } },
                                 { kind: 'Field', name: { kind: 'Name', value: 'lastSyncAt' } },

package/artifacts/graphql/generated/graphql.ts

@@ -301,10 +301,10 @@ export type EventBlock = {
   externalId: Maybe<Scalars['String']['output']>
   externalUrl: Maybe<Scalars['String']['output']>
   id: Scalars['String']['output']
+  isReconcilingItem: Scalars['Boolean']['output']
   metadata: Scalars['JSON']['output']
   obligatedByEventId: Maybe<Scalars['String']['output']>
   occurredAt: Scalars['DateTime']['output']
-  payloadDrift: Scalars['Boolean']['output']
   replacedByEventId: Maybe<Scalars['String']['output']>
   replacesEventId: Maybe<Scalars['String']['output']>
   resourceElementId: Maybe<Scalars['String']['output']>
@@ -1680,9 +1680,9 @@ export type QueryEventBlocksArgs = {
   agentId?: InputMaybe<Scalars['String']['input']>
   eventCategory?: InputMaybe<Scalars['String']['input']>
   eventType?: InputMaybe<Scalars['String']['input']>
+  isReconcilingItem?: InputMaybe<Scalars['Boolean']['input']>
   limit?: InputMaybe<Scalars['Int']['input']>
   offset?: InputMaybe<Scalars['Int']['input']>
-  payloadDrift?: InputMaybe<Scalars['Boolean']['input']>
   source?: InputMaybe<Scalars['String']['input']>
   status?: InputMaybe<Scalars['String']['input']>
 }
@@ -2896,9 +2896,25 @@ export type GetLedgerFiscalCalendarQuery = {
     catchUpSequence: Array<string>
     closeableNow: boolean
     blockers: Array<string>
+    pendingObligationCount: number
+    earliestPendingPeriod: string | null
+    strandedObligationCount: number
+    syncStaleDays: number | null
     lastCloseAt: any | null
     initializedAt: any | null
     lastSyncAt: any | null
+    pendingObligationSample: Array<{
+      eventId: string
+      scheduleId: string | null
+      scheduleName: string | null
+      period: string
+    }>
+    strandedObligationSample: Array<{
+      eventId: string
+      scheduleId: string | null
+      scheduleName: string | null
+      period: string
+    }>
     periods: Array<{
       name: string
       startDate: any
@@ -5857,6 +5873,36 @@ export const GetLedgerFiscalCalendarDocument = {
                 { kind: 'Field', name: { kind: 'Name', value: 'catchUpSequence' } },
                 { kind: 'Field', name: { kind: 'Name', value: 'closeableNow' } },
                 { kind: 'Field', name: { kind: 'Name', value: 'blockers' } },
+                { kind: 'Field', name: { kind: 'Name', value: 'pendingObligationCount' } },
+                {
+                  kind: 'Field',
+                  name: { kind: 'Name', value: 'pendingObligationSample' },
+                  selectionSet: {
+                    kind: 'SelectionSet',
+                    selections: [
+                      { kind: 'Field', name: { kind: 'Name', value: 'eventId' } },
+                      { kind: 'Field', name: { kind: 'Name', value: 'scheduleId' } },
+                      { kind: 'Field', name: { kind: 'Name', value: 'scheduleName' } },
+                      { kind: 'Field', name: { kind: 'Name', value: 'period' } },
+                    ],
+                  },
+                },
+                { kind: 'Field', name: { kind: 'Name', value: 'earliestPendingPeriod' } },
+                { kind: 'Field', name: { kind: 'Name', value: 'strandedObligationCount' } },
+                {
+                  kind: 'Field',
+                  name: { kind: 'Name', value: 'strandedObligationSample' },
+                  selectionSet: {
+                    kind: 'SelectionSet',
+                    selections: [
+                      { kind: 'Field', name: { kind: 'Name', value: 'eventId' } },
+                      { kind: 'Field', name: { kind: 'Name', value: 'scheduleId' } },
+                      { kind: 'Field', name: { kind: 'Name', value: 'scheduleName' } },
+                      { kind: 'Field', name: { kind: 'Name', value: 'period' } },
+                    ],
+                  },
+                },
+                { kind: 'Field', name: { kind: 'Name', value: 'syncStaleDays' } },
                 { kind: 'Field', name: { kind: 'Name', value: 'lastCloseAt' } },
                 { kind: 'Field', name: { kind: 'Name', value: 'initializedAt' } },
                 { kind: 'Field', name: { kind: 'Name', value: 'lastSyncAt' } },

package/artifacts/graphql/queries/ledger/fiscalCalendar.d.ts

@@ -4,5 +4,12 @@
  * The resolver blends extensions-DB data (calendar + periods) with a
  * platform-DB lookup for QB sync state (last_sync_at). Clients use
  * `closeableNow` + `blockers` as the close gate.
+ *
+ * The obligation and staleness detail fields populate only when their
+ * corresponding blocker code is present, so a UI can name *which* schedules
+ * are holding the close instead of just reporting that something is. They
+ * are selected unconditionally here — the resolver returns 0 / [] / null
+ * when the blocker isn't active, which costs nothing and keeps the document
+ * free of a second round trip for the case that matters most.
  */
 export declare const GET_FISCAL_CALENDAR: string;

package/artifacts/graphql/queries/ledger/fiscalCalendar.js

@@ -8,6 +8,13 @@ const graphql_request_1 = require("graphql-request");
  * The resolver blends extensions-DB data (calendar + periods) with a
  * platform-DB lookup for QB sync state (last_sync_at). Clients use
  * `closeableNow` + `blockers` as the close gate.
+ *
+ * The obligation and staleness detail fields populate only when their
+ * corresponding blocker code is present, so a UI can name *which* schedules
+ * are holding the close instead of just reporting that something is. They
+ * are selected unconditionally here — the resolver returns 0 / [] / null
+ * when the blocker isn't active, which costs nothing and keeps the document
+ * free of a second round trip for the case that matters most.
  */
 exports.GET_FISCAL_CALENDAR = (0, graphql_request_1.gql) `
   query GetLedgerFiscalCalendar {
@@ -20,6 +27,22 @@ exports.GET_FISCAL_CALENDAR = (0, graphql_request_1.gql) `
       catchUpSequence
       closeableNow
       blockers
+      pendingObligationCount
+      pendingObligationSample {
+        eventId
+        scheduleId
+        scheduleName
+        period
+      }
+      earliestPendingPeriod
+      strandedObligationCount
+      strandedObligationSample {
+        eventId
+        scheduleId
+        scheduleName
+        period
+      }
+      syncStaleDays
       lastCloseAt
       initializedAt
       lastSyncAt

package/artifacts/graphql/queries/ledger/fiscalCalendar.ts

@@ -6,6 +6,13 @@ import { gql } from 'graphql-request'
  * The resolver blends extensions-DB data (calendar + periods) with a
  * platform-DB lookup for QB sync state (last_sync_at). Clients use
  * `closeableNow` + `blockers` as the close gate.
+ *
+ * The obligation and staleness detail fields populate only when their
+ * corresponding blocker code is present, so a UI can name *which* schedules
+ * are holding the close instead of just reporting that something is. They
+ * are selected unconditionally here — the resolver returns 0 / [] / null
+ * when the blocker isn't active, which costs nothing and keeps the document
+ * free of a second round trip for the case that matters most.
  */
 export const GET_FISCAL_CALENDAR = gql`
   query GetLedgerFiscalCalendar {
@@ -18,6 +25,22 @@ export const GET_FISCAL_CALENDAR = gql`
       catchUpSequence
       closeableNow
       blockers
+      pendingObligationCount
+      pendingObligationSample {
+        eventId
+        scheduleId
+        scheduleName
+        period
+      }
+      earliestPendingPeriod
+      strandedObligationCount
+      strandedObligationSample {
+        eventId
+        scheduleId
+        scheduleName
+        period
+      }
+      syncStaleDays
       lastCloseAt
       initializedAt
       lastSyncAt

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@robosystems/client",
-  "version": "1.3.0",
+  "version": "1.4.1",
   "description": "TypeScript client library for RoboSystems Financial Knowledge Graph API",
   "main": "index.js",
   "types": "index.d.ts",

package/sdk/types.gen.d.ts

@@ -4804,11 +4804,11 @@ export type EventBlockEnvelope = {
         [key: string]: unknown;
     };
     /**
-     * Payload Drift
+     * Is Reconciling Item
      *
-     * True when a source re-sync surfaced a changed upstream payload for an event whose GL is already posted (committed/fulfilled are immutable to sync). The live payload and GL are untouched; the incoming payload is stashed in `metadata.drift_payload` with `metadata.drift_detected_at`. Drifted events need operator reconciliation — the local books no longer mirror the source.
+     * True when this event is a reconciling item: a source re-sync surfaced a changed upstream payload for an event whose GL is already posted (committed/fulfilled are immutable to sync) — the local books legitimately no longer mirror the source, and the difference awaits an explicit disposition (restate the affected months, or book a catch-up entry in the open period). The live payload and GL are untouched; the incoming payload is stashed in `metadata.drift_payload` with `metadata.drift_detected_at`.
      */
-    payload_drift?: boolean;
+    is_reconciling_item?: boolean;
     /**
      * Dimension Ids
      *
@@ -7032,7 +7032,7 @@ export type InstanceUsage = {
     /**
      * Usage Percentage
      *
-     * Storage usage as percentage of limit (e.g. 105.2)
+     * Storage usage as percentage of limit (e.g. 105.2). Derived from the enforced figure — durable bytes only, excluding `transient` build artifacts — so it can read lower than total_storage_gb/limit_gb while a blue-green rebuild is in flight.
      */
     usage_percentage?: number | null;
     /**
@@ -7050,7 +7050,7 @@ export type InstanceUsage = {
     /**
      * Items
      *
-     * Itemized storage by type — graph, memory, subgraph, vectors, staging. Sums to total_storage_gb.
+     * Itemized storage by type — graph, memory, subgraph, vectors, staging, transient, orphan. Sums to total_storage_gb. Only `subgraph` items correspond to live subgraphs, so this is the type to sum when reconciling against the subgraph list.
      */
     items?: Array<StorageItem>;
 };
@@ -8018,6 +8018,12 @@ export type ListSubgraphsResponse = {
      * Maximum allowed subgraphs for this tier (None = unlimited)
      */
     max_subgraphs?: number | null;
+    /**
+     * Total Size Bytes
+     *
+     * Combined on-disk footprint of all subgraphs in bytes
+     */
+    total_size_bytes?: number | null;
     /**
      * Total Size Mb
      *
@@ -13680,7 +13686,7 @@ export type StorageItem = {
     /**
      * Type
      *
-     * One of: graph, memory, subgraph, vectors, staging
+     * One of: graph, memory, subgraph, vectors, staging, transient (blue-green build artifact), orphan (a `{parent}_*` database, vector index, or staging file with no row in the graph registry — reclaimable leftover of a deleted subgraph)
      */
     type: string;
     /**
@@ -13932,6 +13938,12 @@ export type SubgraphResponse = {
      * When the subgraph was last updated
      */
     updated_at: string;
+    /**
+     * Size Bytes
+     *
+     * On-disk footprint in bytes — the database, its write-ahead log, and its vector index. Prefer this over size_mb at subgraph scale.
+     */
+    size_bytes?: number | null;
     /**
      * Size Mb
      *
@@ -13999,10 +14011,16 @@ export type SubgraphSummary = {
      * Current status
      */
     status: string;
+    /**
+     * Size Bytes
+     *
+     * On-disk footprint in bytes — the database, its write-ahead log, and its vector index. Prefer this over size_mb at subgraph scale.
+     */
+    size_bytes?: number | null;
     /**
      * Size Mb
      *
-     * Size in megabytes
+     * Same footprint in megabytes. Derived from size_bytes; kept for callers that render MB directly.
      */
     size_mb?: number | null;
     /**

package/sdk/types.gen.ts

@@ -4929,11 +4929,11 @@ export type EventBlockEnvelope = {
         [key: string]: unknown;
     };
     /**
-     * Payload Drift
+     * Is Reconciling Item
      *
-     * True when a source re-sync surfaced a changed upstream payload for an event whose GL is already posted (committed/fulfilled are immutable to sync). The live payload and GL are untouched; the incoming payload is stashed in `metadata.drift_payload` with `metadata.drift_detected_at`. Drifted events need operator reconciliation — the local books no longer mirror the source.
+     * True when this event is a reconciling item: a source re-sync surfaced a changed upstream payload for an event whose GL is already posted (committed/fulfilled are immutable to sync) — the local books legitimately no longer mirror the source, and the difference awaits an explicit disposition (restate the affected months, or book a catch-up entry in the open period). The live payload and GL are untouched; the incoming payload is stashed in `metadata.drift_payload` with `metadata.drift_detected_at`.
      */
-    payload_drift?: boolean;
+    is_reconciling_item?: boolean;
     /**
      * Dimension Ids
      *
@@ -7204,7 +7204,7 @@ export type InstanceUsage = {
     /**
      * Usage Percentage
      *
-     * Storage usage as percentage of limit (e.g. 105.2)
+     * Storage usage as percentage of limit (e.g. 105.2). Derived from the enforced figure — durable bytes only, excluding `transient` build artifacts — so it can read lower than total_storage_gb/limit_gb while a blue-green rebuild is in flight.
      */
     usage_percentage?: number | null;
     /**
@@ -7222,7 +7222,7 @@ export type InstanceUsage = {
     /**
      * Items
      *
-     * Itemized storage by type — graph, memory, subgraph, vectors, staging. Sums to total_storage_gb.
+     * Itemized storage by type — graph, memory, subgraph, vectors, staging, transient, orphan. Sums to total_storage_gb. Only `subgraph` items correspond to live subgraphs, so this is the type to sum when reconciling against the subgraph list.
      */
     items?: Array<StorageItem>;
 };
@@ -8208,6 +8208,12 @@ export type ListSubgraphsResponse = {
      * Maximum allowed subgraphs for this tier (None = unlimited)
      */
     max_subgraphs?: number | null;
+    /**
+     * Total Size Bytes
+     *
+     * Combined on-disk footprint of all subgraphs in bytes
+     */
+    total_size_bytes?: number | null;
     /**
      * Total Size Mb
      *
@@ -14020,7 +14026,7 @@ export type StorageItem = {
     /**
      * Type
      *
-     * One of: graph, memory, subgraph, vectors, staging
+     * One of: graph, memory, subgraph, vectors, staging, transient (blue-green build artifact), orphan (a `{parent}_*` database, vector index, or staging file with no row in the graph registry — reclaimable leftover of a deleted subgraph)
      */
     type: string;
     /**
@@ -14278,6 +14284,12 @@ export type SubgraphResponse = {
      * When the subgraph was last updated
      */
     updated_at: string;
+    /**
+     * Size Bytes
+     *
+     * On-disk footprint in bytes — the database, its write-ahead log, and its vector index. Prefer this over size_mb at subgraph scale.
+     */
+    size_bytes?: number | null;
     /**
      * Size Mb
      *
@@ -14346,10 +14358,16 @@ export type SubgraphSummary = {
      * Current status
      */
     status: string;
+    /**
+     * Size Bytes
+     *
+     * On-disk footprint in bytes — the database, its write-ahead log, and its vector index. Prefer this over size_mb at subgraph scale.
+     */
+    size_bytes?: number | null;
     /**
      * Size Mb
      *
-     * Size in megabytes
+     * Same footprint in megabytes. Derived from size_bytes; kept for callers that render MB directly.
      */
     size_mb?: number | null;
     /**

package/types.gen.d.ts

@@ -4804,11 +4804,11 @@ export type EventBlockEnvelope = {
         [key: string]: unknown;
     };
     /**
-     * Payload Drift
+     * Is Reconciling Item
      *
-     * True when a source re-sync surfaced a changed upstream payload for an event whose GL is already posted (committed/fulfilled are immutable to sync). The live payload and GL are untouched; the incoming payload is stashed in `metadata.drift_payload` with `metadata.drift_detected_at`. Drifted events need operator reconciliation — the local books no longer mirror the source.
+     * True when this event is a reconciling item: a source re-sync surfaced a changed upstream payload for an event whose GL is already posted (committed/fulfilled are immutable to sync) — the local books legitimately no longer mirror the source, and the difference awaits an explicit disposition (restate the affected months, or book a catch-up entry in the open period). The live payload and GL are untouched; the incoming payload is stashed in `metadata.drift_payload` with `metadata.drift_detected_at`.
      */
-    payload_drift?: boolean;
+    is_reconciling_item?: boolean;
     /**
      * Dimension Ids
      *
@@ -7032,7 +7032,7 @@ export type InstanceUsage = {
     /**
      * Usage Percentage
      *
-     * Storage usage as percentage of limit (e.g. 105.2)
+     * Storage usage as percentage of limit (e.g. 105.2). Derived from the enforced figure — durable bytes only, excluding `transient` build artifacts — so it can read lower than total_storage_gb/limit_gb while a blue-green rebuild is in flight.
      */
     usage_percentage?: number | null;
     /**
@@ -7050,7 +7050,7 @@ export type InstanceUsage = {
     /**
      * Items
      *
-     * Itemized storage by type — graph, memory, subgraph, vectors, staging. Sums to total_storage_gb.
+     * Itemized storage by type — graph, memory, subgraph, vectors, staging, transient, orphan. Sums to total_storage_gb. Only `subgraph` items correspond to live subgraphs, so this is the type to sum when reconciling against the subgraph list.
      */
     items?: Array<StorageItem>;
 };
@@ -8018,6 +8018,12 @@ export type ListSubgraphsResponse = {
      * Maximum allowed subgraphs for this tier (None = unlimited)
      */
     max_subgraphs?: number | null;
+    /**
+     * Total Size Bytes
+     *
+     * Combined on-disk footprint of all subgraphs in bytes
+     */
+    total_size_bytes?: number | null;
     /**
      * Total Size Mb
      *
@@ -13680,7 +13686,7 @@ export type StorageItem = {
     /**
      * Type
      *
-     * One of: graph, memory, subgraph, vectors, staging
+     * One of: graph, memory, subgraph, vectors, staging, transient (blue-green build artifact), orphan (a `{parent}_*` database, vector index, or staging file with no row in the graph registry — reclaimable leftover of a deleted subgraph)
      */
     type: string;
     /**
@@ -13932,6 +13938,12 @@ export type SubgraphResponse = {
      * When the subgraph was last updated
      */
     updated_at: string;
+    /**
+     * Size Bytes
+     *
+     * On-disk footprint in bytes — the database, its write-ahead log, and its vector index. Prefer this over size_mb at subgraph scale.
+     */
+    size_bytes?: number | null;
     /**
      * Size Mb
      *
@@ -13999,10 +14011,16 @@ export type SubgraphSummary = {
      * Current status
      */
     status: string;
+    /**
+     * Size Bytes
+     *
+     * On-disk footprint in bytes — the database, its write-ahead log, and its vector index. Prefer this over size_mb at subgraph scale.
+     */
+    size_bytes?: number | null;
     /**
      * Size Mb
      *
-     * Size in megabytes
+     * Same footprint in megabytes. Derived from size_bytes; kept for callers that render MB directly.
      */
     size_mb?: number | null;
     /**

package/types.gen.ts

@@ -4929,11 +4929,11 @@ export type EventBlockEnvelope = {
         [key: string]: unknown;
     };
     /**
-     * Payload Drift
+     * Is Reconciling Item
      *
-     * True when a source re-sync surfaced a changed upstream payload for an event whose GL is already posted (committed/fulfilled are immutable to sync). The live payload and GL are untouched; the incoming payload is stashed in `metadata.drift_payload` with `metadata.drift_detected_at`. Drifted events need operator reconciliation — the local books no longer mirror the source.
+     * True when this event is a reconciling item: a source re-sync surfaced a changed upstream payload for an event whose GL is already posted (committed/fulfilled are immutable to sync) — the local books legitimately no longer mirror the source, and the difference awaits an explicit disposition (restate the affected months, or book a catch-up entry in the open period). The live payload and GL are untouched; the incoming payload is stashed in `metadata.drift_payload` with `metadata.drift_detected_at`.
      */
-    payload_drift?: boolean;
+    is_reconciling_item?: boolean;
     /**
      * Dimension Ids
      *
@@ -7204,7 +7204,7 @@ export type InstanceUsage = {
     /**
      * Usage Percentage
      *
-     * Storage usage as percentage of limit (e.g. 105.2)
+     * Storage usage as percentage of limit (e.g. 105.2). Derived from the enforced figure — durable bytes only, excluding `transient` build artifacts — so it can read lower than total_storage_gb/limit_gb while a blue-green rebuild is in flight.
      */
     usage_percentage?: number | null;
     /**
@@ -7222,7 +7222,7 @@ export type InstanceUsage = {
     /**
      * Items
      *
-     * Itemized storage by type — graph, memory, subgraph, vectors, staging. Sums to total_storage_gb.
+     * Itemized storage by type — graph, memory, subgraph, vectors, staging, transient, orphan. Sums to total_storage_gb. Only `subgraph` items correspond to live subgraphs, so this is the type to sum when reconciling against the subgraph list.
      */
     items?: Array<StorageItem>;
 };
@@ -8208,6 +8208,12 @@ export type ListSubgraphsResponse = {
      * Maximum allowed subgraphs for this tier (None = unlimited)
      */
     max_subgraphs?: number | null;
+    /**
+     * Total Size Bytes
+     *
+     * Combined on-disk footprint of all subgraphs in bytes
+     */
+    total_size_bytes?: number | null;
     /**
      * Total Size Mb
      *
@@ -14020,7 +14026,7 @@ export type StorageItem = {
     /**
      * Type
      *
-     * One of: graph, memory, subgraph, vectors, staging
+     * One of: graph, memory, subgraph, vectors, staging, transient (blue-green build artifact), orphan (a `{parent}_*` database, vector index, or staging file with no row in the graph registry — reclaimable leftover of a deleted subgraph)
      */
     type: string;
     /**
@@ -14278,6 +14284,12 @@ export type SubgraphResponse = {
      * When the subgraph was last updated
      */
     updated_at: string;
+    /**
+     * Size Bytes
+     *
+     * On-disk footprint in bytes — the database, its write-ahead log, and its vector index. Prefer this over size_mb at subgraph scale.
+     */
+    size_bytes?: number | null;
     /**
      * Size Mb
      *
@@ -14346,10 +14358,16 @@ export type SubgraphSummary = {
      * Current status
      */
     status: string;
+    /**
+     * Size Bytes
+     *
+     * On-disk footprint in bytes — the database, its write-ahead log, and its vector index. Prefer this over size_mb at subgraph scale.
+     */
+    size_bytes?: number | null;
     /**
      * Size Mb
      *
-     * Size in megabytes
+     * Same footprint in megabytes. Derived from size_bytes; kept for callers that render MB directly.
      */
     size_mb?: number | null;
     /**