@camstack/types 1.2.62 → 1.2.63

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.
Files changed (7) hide show
  1. package/dist/capabilities/filesystem-browse.cap.d.ts +4 -3
  2. package/dist/capabilities/storage-provider.cap.d.ts +11 -0
  3. package/dist/capabilities/storage.cap.d.ts +4 -0
  4. package/dist/index.js +19 -3
  5. package/dist/index.mjs +19 -3
  6. package/dist/interfaces/storage-location.d.ts +1 -0
  7. package/package.json +1 -1
package/dist/capabilities/filesystem-browse.cap.d.ts CHANGED
@@ -1,6 +1,7 @@
1
1
  /**
2
2
  * filesystem-browse — per-node capability for browsing the node's local
3
- * filesystem, sandboxed to operator-configured allowed roots. Used by the
3
+ * filesystem. Reads are unconfined (whole filesystem, from `/` down); WRITES
4
+ * are sandboxed to operator-configured allowed roots (D115). Used by the
4
5
  * admin "Add filesystem location" flow to pick a node + path. `mode:'per-node'`
5
6
  * (one provider per node); the hub calls it with `{nodeId}` so the codegen
6
7
  * routes to that exact node (default `nodeIdMode:'routing'`).
@@ -13,9 +14,9 @@ export declare const filesystemBrowseCapability: {
13
14
  readonly mode: "singleton";
14
15
  readonly internal: true;
15
16
  readonly methods: {
16
- /** The allowed roots browsing is sandboxed to on this node. */
17
+ /** The roots `createDir` is sandboxed to on this node. Browsing is not confined to them. */
17
18
  readonly listAllowedRoots: import("./capability-definition.js").CapabilityMethodSchema<z.ZodVoid, z.ZodReadonly<z.ZodArray<z.ZodString>>, import("./capability-definition.js").CapabilityMethodKind>;
18
- /** Immediate subdirectories of `path` (must be within an allowed root) + free/total bytes. */
19
+ /** Immediate subdirectories of any absolute `path` + free/total bytes. Read-only. */
19
20
  readonly browse: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
20
21
  path: z.ZodString;
21
22
  }, z.core.$strip>, z.ZodObject<{
package/dist/capabilities/storage-provider.cap.d.ts CHANGED
@@ -29,6 +29,7 @@ declare const BeginUploadInputSchema: z.ZodObject<{
29
29
  nodeId: z.ZodOptional<z.ZodString>;
30
30
  isDefault: z.ZodDefault<z.ZodBoolean>;
31
31
  isSystem: z.ZodDefault<z.ZodBoolean>;
32
+ enabled: z.ZodOptional<z.ZodBoolean>;
32
33
  capacity: z.ZodOptional<z.ZodNullable<z.ZodObject<{
33
34
  totalBytes: z.ZodNumber;
34
35
  availableBytes: z.ZodNumber;
@@ -63,6 +64,7 @@ declare const BeginDownloadInputSchema: z.ZodObject<{
63
64
  nodeId: z.ZodOptional<z.ZodString>;
64
65
  isDefault: z.ZodDefault<z.ZodBoolean>;
65
66
  isSystem: z.ZodDefault<z.ZodBoolean>;
67
+ enabled: z.ZodOptional<z.ZodBoolean>;
66
68
  capacity: z.ZodOptional<z.ZodNullable<z.ZodObject<{
67
69
  totalBytes: z.ZodNumber;
68
70
  availableBytes: z.ZodNumber;
@@ -143,6 +145,7 @@ export declare const storageProviderCapability: {
143
145
  nodeId: z.ZodOptional<z.ZodString>;
144
146
  isDefault: z.ZodDefault<z.ZodBoolean>;
145
147
  isSystem: z.ZodDefault<z.ZodBoolean>;
148
+ enabled: z.ZodOptional<z.ZodBoolean>;
146
149
  capacity: z.ZodOptional<z.ZodNullable<z.ZodObject<{
147
150
  totalBytes: z.ZodNumber;
148
151
  availableBytes: z.ZodNumber;
@@ -162,6 +165,7 @@ export declare const storageProviderCapability: {
162
165
  nodeId: z.ZodOptional<z.ZodString>;
163
166
  isDefault: z.ZodDefault<z.ZodBoolean>;
164
167
  isSystem: z.ZodDefault<z.ZodBoolean>;
168
+ enabled: z.ZodOptional<z.ZodBoolean>;
165
169
  capacity: z.ZodOptional<z.ZodNullable<z.ZodObject<{
166
170
  totalBytes: z.ZodNumber;
167
171
  availableBytes: z.ZodNumber;
@@ -182,6 +186,7 @@ export declare const storageProviderCapability: {
182
186
  nodeId: z.ZodOptional<z.ZodString>;
183
187
  isDefault: z.ZodDefault<z.ZodBoolean>;
184
188
  isSystem: z.ZodDefault<z.ZodBoolean>;
189
+ enabled: z.ZodOptional<z.ZodBoolean>;
185
190
  capacity: z.ZodOptional<z.ZodNullable<z.ZodObject<{
186
191
  totalBytes: z.ZodNumber;
187
192
  availableBytes: z.ZodNumber;
@@ -201,6 +206,7 @@ export declare const storageProviderCapability: {
201
206
  nodeId: z.ZodOptional<z.ZodString>;
202
207
  isDefault: z.ZodDefault<z.ZodBoolean>;
203
208
  isSystem: z.ZodDefault<z.ZodBoolean>;
209
+ enabled: z.ZodOptional<z.ZodBoolean>;
204
210
  capacity: z.ZodOptional<z.ZodNullable<z.ZodObject<{
205
211
  totalBytes: z.ZodNumber;
206
212
  availableBytes: z.ZodNumber;
@@ -220,6 +226,7 @@ export declare const storageProviderCapability: {
220
226
  nodeId: z.ZodOptional<z.ZodString>;
221
227
  isDefault: z.ZodDefault<z.ZodBoolean>;
222
228
  isSystem: z.ZodDefault<z.ZodBoolean>;
229
+ enabled: z.ZodOptional<z.ZodBoolean>;
223
230
  capacity: z.ZodOptional<z.ZodNullable<z.ZodObject<{
224
231
  totalBytes: z.ZodNumber;
225
232
  availableBytes: z.ZodNumber;
@@ -239,6 +246,7 @@ export declare const storageProviderCapability: {
239
246
  nodeId: z.ZodOptional<z.ZodString>;
240
247
  isDefault: z.ZodDefault<z.ZodBoolean>;
241
248
  isSystem: z.ZodDefault<z.ZodBoolean>;
249
+ enabled: z.ZodOptional<z.ZodBoolean>;
242
250
  capacity: z.ZodOptional<z.ZodNullable<z.ZodObject<{
243
251
  totalBytes: z.ZodNumber;
244
252
  availableBytes: z.ZodNumber;
@@ -258,6 +266,7 @@ export declare const storageProviderCapability: {
258
266
  nodeId: z.ZodOptional<z.ZodString>;
259
267
  isDefault: z.ZodDefault<z.ZodBoolean>;
260
268
  isSystem: z.ZodDefault<z.ZodBoolean>;
269
+ enabled: z.ZodOptional<z.ZodBoolean>;
261
270
  capacity: z.ZodOptional<z.ZodNullable<z.ZodObject<{
262
271
  totalBytes: z.ZodNumber;
263
272
  availableBytes: z.ZodNumber;
@@ -276,6 +285,7 @@ export declare const storageProviderCapability: {
276
285
  nodeId: z.ZodOptional<z.ZodString>;
277
286
  isDefault: z.ZodDefault<z.ZodBoolean>;
278
287
  isSystem: z.ZodDefault<z.ZodBoolean>;
288
+ enabled: z.ZodOptional<z.ZodBoolean>;
279
289
  capacity: z.ZodOptional<z.ZodNullable<z.ZodObject<{
280
290
  totalBytes: z.ZodNumber;
281
291
  availableBytes: z.ZodNumber;
@@ -309,6 +319,7 @@ export declare const storageProviderCapability: {
309
319
  nodeId: z.ZodOptional<z.ZodString>;
310
320
  isDefault: z.ZodDefault<z.ZodBoolean>;
311
321
  isSystem: z.ZodDefault<z.ZodBoolean>;
322
+ enabled: z.ZodOptional<z.ZodBoolean>;
312
323
  capacity: z.ZodOptional<z.ZodNullable<z.ZodObject<{
313
324
  totalBytes: z.ZodNumber;
314
325
  availableBytes: z.ZodNumber;
package/dist/capabilities/storage.cap.d.ts CHANGED
@@ -96,6 +96,7 @@ export declare const storageCapability: {
96
96
  nodeId: z.ZodOptional<z.ZodString>;
97
97
  isDefault: z.ZodDefault<z.ZodBoolean>;
98
98
  isSystem: z.ZodDefault<z.ZodBoolean>;
99
+ enabled: z.ZodOptional<z.ZodBoolean>;
99
100
  capacity: z.ZodOptional<z.ZodNullable<z.ZodObject<{
100
101
  totalBytes: z.ZodNumber;
101
102
  availableBytes: z.ZodNumber;
@@ -114,6 +115,7 @@ export declare const storageCapability: {
114
115
  nodeId: z.ZodOptional<z.ZodString>;
115
116
  isDefault: z.ZodDefault<z.ZodBoolean>;
116
117
  isSystem: z.ZodDefault<z.ZodBoolean>;
118
+ enabled: z.ZodOptional<z.ZodBoolean>;
117
119
  capacity: z.ZodOptional<z.ZodNullable<z.ZodObject<{
118
120
  totalBytes: z.ZodNumber;
119
121
  availableBytes: z.ZodNumber;
@@ -145,6 +147,7 @@ export declare const storageCapability: {
145
147
  nodeId: z.ZodOptional<z.ZodString>;
146
148
  isDefault: z.ZodDefault<z.ZodBoolean>;
147
149
  isSystem: z.ZodDefault<z.ZodBoolean>;
150
+ enabled: z.ZodOptional<z.ZodBoolean>;
148
151
  capacity: z.ZodOptional<z.ZodNullable<z.ZodObject<{
149
152
  totalBytes: z.ZodNumber;
150
153
  availableBytes: z.ZodNumber;
@@ -158,6 +161,7 @@ export declare const storageCapability: {
158
161
  nodeId: z.ZodOptional<z.ZodString>;
159
162
  isDefault: z.ZodDefault<z.ZodBoolean>;
160
163
  isSystem: z.ZodDefault<z.ZodBoolean>;
164
+ enabled: z.ZodOptional<z.ZodBoolean>;
161
165
  capacity: z.ZodOptional<z.ZodNullable<z.ZodObject<{
162
166
  totalBytes: z.ZodNumber;
163
167
  availableBytes: z.ZodNumber;
package/dist/index.js CHANGED
@@ -1857,6 +1857,21 @@ var StorageLocationSchema = zod.z.object({
1857
1857
  nodeId: zod.z.string().optional(),
1858
1858
  isDefault: zod.z.boolean().default(false),
1859
1859
  isSystem: zod.z.boolean().default(false),
1860
+ /**
1861
+ * Operator opt-in: whether consumers that BALANCE across several locations
1862
+ * of a type may write here. Recordings reads it today; event media and
1863
+ * backups are the next consumers, which is why the flag lives on the
1864
+ * location rather than in any one addon's store — nothing has to be
1865
+ * extended to add the next consumer.
1866
+ *
1867
+ * OPTIONAL, and ABSENT MEANS ACTIVE. Every location persisted before the
1868
+ * flag existed reads back with no flag and keeps working exactly as before;
1869
+ * that is the whole compat story, and it is why no migration ships with it.
1870
+ * A newly CREATED sibling is stamped `false` by the orchestrator (creating a
1871
+ * disk must not silently start writing to it); the default of a type is
1872
+ * always stamped `true`.
1873
+ */
1874
+ enabled: zod.z.boolean().optional(),
1860
1875
  /** COMPUTED at read time by the orchestrator (statfs of the backing volume
1861
1876
  * for node-local locations it can reach) — never persisted, absent when the
1862
1877
  * volume is remote/unreachable. The single capacity truth every UI reads. */
@@ -9296,7 +9311,8 @@ var embeddingEncoderCapability = {
9296
9311
  //#region src/capabilities/filesystem-browse.cap.ts
9297
9312
  /**
9298
9313
  * filesystem-browse — per-node capability for browsing the node's local
9299
- * filesystem, sandboxed to operator-configured allowed roots. Used by the
9314
+ * filesystem. Reads are unconfined (whole filesystem, from `/` down); WRITES
9315
+ * are sandboxed to operator-configured allowed roots (D115). Used by the
9300
9316
  * admin "Add filesystem location" flow to pick a node + path. `mode:'per-node'`
9301
9317
  * (one provider per node); the hub calls it with `{nodeId}` so the codegen
9302
9318
  * routes to that exact node (default `nodeIdMode:'routing'`).
@@ -9317,9 +9333,9 @@ var filesystemBrowseCapability = {
9317
9333
  mode: "singleton",
9318
9334
  internal: true,
9319
9335
  methods: {
9320
- /** The allowed roots browsing is sandboxed to on this node. */
9336
+ /** The roots `createDir` is sandboxed to on this node. Browsing is not confined to them. */
9321
9337
  listAllowedRoots: require_sleep.method(zod.z.void(), zod.z.array(zod.z.string()).readonly(), { auth: "admin" }),
9322
- /** Immediate subdirectories of `path` (must be within an allowed root) + free/total bytes. */
9338
+ /** Immediate subdirectories of any absolute `path` + free/total bytes. Read-only. */
9323
9339
  browse: require_sleep.method(zod.z.object({ path: zod.z.string() }), BrowseResultSchema, { auth: "admin" }),
9324
9340
  /** Create a subdirectory (within an allowed root). Returns its absolute path. */
9325
9341
  createDir: require_sleep.method(zod.z.object({ path: zod.z.string() }), zod.z.object({ path: zod.z.string() }), {
package/dist/index.mjs CHANGED
@@ -1856,6 +1856,21 @@ var StorageLocationSchema = z.object({
1856
1856
  nodeId: z.string().optional(),
1857
1857
  isDefault: z.boolean().default(false),
1858
1858
  isSystem: z.boolean().default(false),
1859
+ /**
1860
+ * Operator opt-in: whether consumers that BALANCE across several locations
1861
+ * of a type may write here. Recordings reads it today; event media and
1862
+ * backups are the next consumers, which is why the flag lives on the
1863
+ * location rather than in any one addon's store — nothing has to be
1864
+ * extended to add the next consumer.
1865
+ *
1866
+ * OPTIONAL, and ABSENT MEANS ACTIVE. Every location persisted before the
1867
+ * flag existed reads back with no flag and keeps working exactly as before;
1868
+ * that is the whole compat story, and it is why no migration ships with it.
1869
+ * A newly CREATED sibling is stamped `false` by the orchestrator (creating a
1870
+ * disk must not silently start writing to it); the default of a type is
1871
+ * always stamped `true`.
1872
+ */
1873
+ enabled: z.boolean().optional(),
1859
1874
  /** COMPUTED at read time by the orchestrator (statfs of the backing volume
1860
1875
  * for node-local locations it can reach) — never persisted, absent when the
1861
1876
  * volume is remote/unreachable. The single capacity truth every UI reads. */
@@ -9295,7 +9310,8 @@ var embeddingEncoderCapability = {
9295
9310
  //#region src/capabilities/filesystem-browse.cap.ts
9296
9311
  /**
9297
9312
  * filesystem-browse — per-node capability for browsing the node's local
9298
- * filesystem, sandboxed to operator-configured allowed roots. Used by the
9313
+ * filesystem. Reads are unconfined (whole filesystem, from `/` down); WRITES
9314
+ * are sandboxed to operator-configured allowed roots (D115). Used by the
9299
9315
  * admin "Add filesystem location" flow to pick a node + path. `mode:'per-node'`
9300
9316
  * (one provider per node); the hub calls it with `{nodeId}` so the codegen
9301
9317
  * routes to that exact node (default `nodeIdMode:'routing'`).
@@ -9316,9 +9332,9 @@ var filesystemBrowseCapability = {
9316
9332
  mode: "singleton",
9317
9333
  internal: true,
9318
9334
  methods: {
9319
- /** The allowed roots browsing is sandboxed to on this node. */
9335
+ /** The roots `createDir` is sandboxed to on this node. Browsing is not confined to them. */
9320
9336
  listAllowedRoots: method(z.void(), z.array(z.string()).readonly(), { auth: "admin" }),
9321
- /** Immediate subdirectories of `path` (must be within an allowed root) + free/total bytes. */
9337
+ /** Immediate subdirectories of any absolute `path` + free/total bytes. Read-only. */
9322
9338
  browse: method(z.object({ path: z.string() }), BrowseResultSchema, { auth: "admin" }),
9323
9339
  /** Create a subdirectory (within an allowed root). Returns its absolute path. */
9324
9340
  createDir: method(z.object({ path: z.string() }), z.object({ path: z.string() }), {
package/dist/interfaces/storage-location.d.ts CHANGED
@@ -48,6 +48,7 @@ export declare const StorageLocationSchema: z.ZodObject<{
48
48
  nodeId: z.ZodOptional<z.ZodString>;
49
49
  isDefault: z.ZodDefault<z.ZodBoolean>;
50
50
  isSystem: z.ZodDefault<z.ZodBoolean>;
51
+ enabled: z.ZodOptional<z.ZodBoolean>;
51
52
  capacity: z.ZodOptional<z.ZodNullable<z.ZodObject<{
52
53
  totalBytes: z.ZodNumber;
53
54
  availableBytes: z.ZodNumber;
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@camstack/types",
3
- "version": "1.2.62",
3
+ "version": "1.2.63",
4
4
  "description": "Shared types, interfaces, and model catalogs for the CamStack detection ecosystem",
5
5
  "keywords": [
6
6
  "camstack",