@madewithremy/admin 0.1.63 → 0.1.64

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -20,10 +20,34 @@ export type InfraDesiredState = 'active' | 'hibernated' | 'destroyed';
20
20
  export type InfraHealth = 'ready' | 'not-ready' | 'missing' | 'rebuilding'
21
21
  /** Serving in Qdrant's low-memory mode after repeated out-of-memory restarts, until memory settles. */
22
22
  | 'degraded';
23
+ /**
24
+ * What a resource is: `retrieval`, vector-store capacity of the app's own for
25
+ * its data sources, or `database`, a database server of the app's own for
26
+ * databases past the shared pool's limit.
27
+ */
28
+ export type InfraKind = 'retrieval' | 'database';
29
+ /** What a retrieval size holds. */
30
+ export interface InfraRetrievalCapacity {
31
+ diskGiB: number;
32
+ memoryGiB: number;
33
+ /**
34
+ * The chunks it holds at each embedding dimension on offer, keyed by
35
+ * dimension ("2560"). A chunk embedded at 2560 dimensions takes two and a
36
+ * half times a 1024-dimension one, so a resource's room depends on what is
37
+ * placed on it.
38
+ */
39
+ chunksByDimensions: Record<string, number>;
40
+ }
41
+ /** What a database size holds: how large each of the app's databases may grow, on its CPU and memory. */
42
+ export interface InfraDatabaseCapacity {
43
+ maxDatabaseGiB: number;
44
+ vcpu: number;
45
+ memoryGiB: number;
46
+ }
23
47
  /** A leasable product from the platform catalog. Prices are cogs + margin. */
24
48
  export interface InfraOffering {
25
49
  id: string;
26
- kind: 'retrieval';
50
+ kind: InfraKind;
27
51
  /** User-facing size, e.g. "Small". */
28
52
  label: string;
29
53
  /** User-facing capacity, e.g. "Up to ~34M chunks at 2560 dimensions (~48M at 1024, ~26M at 4096)". */
@@ -31,20 +55,15 @@ export interface InfraOffering {
31
55
  hourlyPriceDollars: number;
32
56
  /** Hourly × 730. */
33
57
  monthlyPriceDollars: number;
34
- /** Zero: a hibernated resource holds nothing; its sources' documents stay in the platform's own store. */
35
- hibernatedHourlyPriceDollars: number;
36
- hibernatedMonthlyPriceDollars: number;
37
58
  /**
38
- * What the size holds: its disk and RAM, and the chunks that comes to at
39
- * each embedding dimension on offer, keyed by dimension ("2560"). A chunk
40
- * embedded at 2560 dimensions takes two and a half times a 1024-dimension
41
- * one, so a resource's room depends on what is placed on it.
59
+ * Zero: a hibernated resource holds nothing. A retrieval resource's sources'
60
+ * documents stay in the platform's own store; a database server's databases
61
+ * are backed up there as it parks.
42
62
  */
43
- capacity: {
44
- diskGiB: number;
45
- memoryGiB: number;
46
- chunksByDimensions: Record<string, number>;
47
- };
63
+ hibernatedHourlyPriceDollars: number;
64
+ hibernatedMonthlyPriceDollars: number;
65
+ /** What the size holds, by kind. */
66
+ capacity: InfraRetrievalCapacity | InfraDatabaseCapacity;
48
67
  capabilities: {
49
68
  hibernate: boolean;
50
69
  };
@@ -54,12 +73,12 @@ export interface InfraResource {
54
73
  id: string;
55
74
  appId: string;
56
75
  name: string;
57
- kind: 'retrieval';
76
+ kind: InfraKind;
58
77
  offeringId: string;
59
78
  offering: InfraOffering | null;
60
79
  phase: InfraPhase;
61
80
  desiredState: InfraDesiredState;
62
- /** Data sources placed on this resource. Destroy is refused while > 0. */
81
+ /** Data sources placed on this resource (retrieval). Destroy is refused while > 0. */
63
82
  attachedSources: number;
64
83
  lastError: string | null;
65
84
  /** Null until the instance exists (requested, hibernated, destroyed). */
@@ -81,7 +100,8 @@ export interface InfraResource {
81
100
  * chunk counts at their dimensions, against what the size can hold
82
101
  * (`usableDiskBytes`). `storedBytes` is the vectors and payload the instance
83
102
  * itself reports (null until it has); the indexes and WAL sit on top of it,
84
- * so it runs under the estimate. Null when the offering is unknown.
103
+ * so it runs under the estimate. Null for a database server, and when the
104
+ * offering is unknown.
85
105
  */
86
106
  footprint: {
87
107
  chunks: number;
@@ -90,6 +110,12 @@ export interface InfraResource {
90
110
  measuredAt: string | null;
91
111
  usableDiskBytes: number;
92
112
  } | null;
113
+ /**
114
+ * A database server's databases as its pod last reported them, each one's
115
+ * data against the cap it holds them to; null for retrieval, and until
116
+ * sampled.
117
+ */
118
+ databases: InfraLeasedDatabase[] | null;
93
119
  /**
94
120
  * The instance's resident memory against the limit it is killed at, as
95
121
  * last sampled; null until the platform has observed the instance.
@@ -131,6 +157,24 @@ export interface InfraResource {
131
157
  createdAt: string;
132
158
  updatedAt: string;
133
159
  }
160
+ /** One of a database server's databases, as its pod last reported it. */
161
+ export interface InfraLeasedDatabase {
162
+ databaseId: string;
163
+ name: string;
164
+ /** The release it belongs to. */
165
+ releaseId: string;
166
+ /** Its pages in use, which deleting rows lowers; null where the pod couldn't read it. */
167
+ dataBytes: number | null;
168
+ /** Its file on the server, which only grows: what a smaller size has to take. */
169
+ fileBytes: number | null;
170
+ /** The cap the server holds it to. */
171
+ capBytes: number | null;
172
+ /** Whether it has writes its backup hasn't had yet (backups run hourly). */
173
+ dirty: boolean;
174
+ lastBackupAt: string | null;
175
+ lastBackupError: string | null;
176
+ sampledAt: string;
177
+ }
134
178
  export interface InfraEvent {
135
179
  id: string;
136
180
  fromPhase: InfraPhase | null;
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@madewithremy/admin",
3
- "version": "0.1.63",
3
+ "version": "0.1.64",
4
4
  "description": "Admin SDK + CLI for managing production Remy apps",
5
5
  "type": "module",
6
6
  "main": "./dist/index.js",