@sealant/api-contracts-next 0.39.0-next.692 → 0.39.0-next.693

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 (9) hide show
  1. package/dist/core-api/control-plane.d.ts +23 -0
  2. package/dist/core-api/record-events.d.ts +8 -0
  3. package/dist/core-api/record-events.js +8 -0
  4. package/dist/core-api/runs.d.ts +61 -6
  5. package/dist/core-api/runs.js +17 -2
  6. package/dist/core-api/sessions.d.ts +48 -0
  7. package/dist/core-api/sessions.js +8 -0
  8. package/dist/core-api/workspaces.d.ts +3 -0
  9. package/package.json +2 -2
package/dist/core-api/control-plane.d.ts CHANGED
@@ -423,12 +423,15 @@ export declare const ControlPlaneAPI: HttpApi.HttpApi<"sealantControlPlaneApi",
423
423
  readonly executable: import("effect/Schema").String;
424
424
  readonly args: import("effect/Schema").$Array<import("effect/Schema").String>;
425
425
  readonly cwd: import("effect/Schema").optional<import("effect/Schema").String>;
426
+ readonly argCount: import("effect/Schema").optional<import("effect/Schema").Number>;
427
+ readonly argLengths: import("effect/Schema").optional<import("effect/Schema").$Array<import("effect/Schema").Number>>;
426
428
  }>>;
427
429
  readonly metadata: import("effect/Schema").optional<import("effect/Schema").$Record<import("effect/Schema").String, import("effect/Schema").Unknown>>;
428
430
  readonly exitCode: import("effect/Schema").optional<import("effect/Schema").Number>;
429
431
  readonly errorMessage: import("effect/Schema").optional<import("effect/Schema").String>;
430
432
  readonly startedAt: import("effect/Schema").optional<import("effect/Schema").String>;
431
433
  readonly finishedAt: import("effect/Schema").optional<import("effect/Schema").String>;
434
+ readonly recordDeletedAt: import("effect/Schema").optional<import("effect/Schema").String>;
432
435
  readonly createdAt: import("effect/Schema").String;
433
436
  readonly updatedAt: import("effect/Schema").String;
434
437
  }>>, import("effect/unstable/httpapi/HttpApiEndpoint").Json<typeof import("./budgets.ts").BudgetExceededError | typeof import("./runs.js").RunBadRequestError | typeof import("./runs.js").RunNotFoundError | typeof import("./runs.js").RunInternalServerError>, never, never> | import("effect/unstable/httpapi/HttpApiEndpoint").HttpApiEndpoint<"getRun", "GET", "/v1/runs/:runId", import("effect/unstable/httpapi/HttpApiEndpoint").StringTree<import("effect/Schema").Struct<{
@@ -448,12 +451,15 @@ export declare const ControlPlaneAPI: HttpApi.HttpApi<"sealantControlPlaneApi",
448
451
  readonly executable: import("effect/Schema").String;
449
452
  readonly args: import("effect/Schema").$Array<import("effect/Schema").String>;
450
453
  readonly cwd: import("effect/Schema").optional<import("effect/Schema").String>;
454
+ readonly argCount: import("effect/Schema").optional<import("effect/Schema").Number>;
455
+ readonly argLengths: import("effect/Schema").optional<import("effect/Schema").$Array<import("effect/Schema").Number>>;
451
456
  }>>;
452
457
  readonly metadata: import("effect/Schema").optional<import("effect/Schema").$Record<import("effect/Schema").String, import("effect/Schema").Unknown>>;
453
458
  readonly exitCode: import("effect/Schema").optional<import("effect/Schema").Number>;
454
459
  readonly errorMessage: import("effect/Schema").optional<import("effect/Schema").String>;
455
460
  readonly startedAt: import("effect/Schema").optional<import("effect/Schema").String>;
456
461
  readonly finishedAt: import("effect/Schema").optional<import("effect/Schema").String>;
462
+ readonly recordDeletedAt: import("effect/Schema").optional<import("effect/Schema").String>;
457
463
  readonly createdAt: import("effect/Schema").String;
458
464
  readonly updatedAt: import("effect/Schema").String;
459
465
  }>>, import("effect/unstable/httpapi/HttpApiEndpoint").Json<typeof import("./runs.js").RunNotFoundError | typeof import("./runs.js").RunInternalServerError>, never, never> | import("effect/unstable/httpapi/HttpApiEndpoint").HttpApiEndpoint<"getRunChanges", "GET", "/v1/runs/:runId/changes", import("effect/unstable/httpapi/HttpApiEndpoint").StringTree<import("effect/Schema").Struct<{
@@ -562,12 +568,15 @@ export declare const ControlPlaneAPI: HttpApi.HttpApi<"sealantControlPlaneApi",
562
568
  readonly executable: import("effect/Schema").String;
563
569
  readonly args: import("effect/Schema").$Array<import("effect/Schema").String>;
564
570
  readonly cwd: import("effect/Schema").optional<import("effect/Schema").String>;
571
+ readonly argCount: import("effect/Schema").optional<import("effect/Schema").Number>;
572
+ readonly argLengths: import("effect/Schema").optional<import("effect/Schema").$Array<import("effect/Schema").Number>>;
565
573
  }>>;
566
574
  readonly metadata: import("effect/Schema").optional<import("effect/Schema").$Record<import("effect/Schema").String, import("effect/Schema").Unknown>>;
567
575
  readonly exitCode: import("effect/Schema").optional<import("effect/Schema").Number>;
568
576
  readonly errorMessage: import("effect/Schema").optional<import("effect/Schema").String>;
569
577
  readonly startedAt: import("effect/Schema").optional<import("effect/Schema").String>;
570
578
  readonly finishedAt: import("effect/Schema").optional<import("effect/Schema").String>;
579
+ readonly recordDeletedAt: import("effect/Schema").optional<import("effect/Schema").String>;
571
580
  readonly createdAt: import("effect/Schema").String;
572
581
  readonly updatedAt: import("effect/Schema").String;
573
582
  }>>;
@@ -598,12 +607,15 @@ export declare const ControlPlaneAPI: HttpApi.HttpApi<"sealantControlPlaneApi",
598
607
  readonly executable: import("effect/Schema").String;
599
608
  readonly args: import("effect/Schema").$Array<import("effect/Schema").String>;
600
609
  readonly cwd: import("effect/Schema").optional<import("effect/Schema").String>;
610
+ readonly argCount: import("effect/Schema").optional<import("effect/Schema").Number>;
611
+ readonly argLengths: import("effect/Schema").optional<import("effect/Schema").$Array<import("effect/Schema").Number>>;
601
612
  }>>;
602
613
  readonly metadata: import("effect/Schema").optional<import("effect/Schema").$Record<import("effect/Schema").String, import("effect/Schema").Unknown>>;
603
614
  readonly exitCode: import("effect/Schema").optional<import("effect/Schema").Number>;
604
615
  readonly errorMessage: import("effect/Schema").optional<import("effect/Schema").String>;
605
616
  readonly startedAt: import("effect/Schema").optional<import("effect/Schema").String>;
606
617
  readonly finishedAt: import("effect/Schema").optional<import("effect/Schema").String>;
618
+ readonly recordDeletedAt: import("effect/Schema").optional<import("effect/Schema").String>;
607
619
  readonly createdAt: import("effect/Schema").String;
608
620
  readonly updatedAt: import("effect/Schema").String;
609
621
  }>>, import("effect/unstable/httpapi/HttpApiEndpoint").Json<typeof import("./runs.js").RunBadRequestError | typeof import("./runs.js").RunNotFoundError | typeof import("./runs.js").RunInternalServerError>, never, never>, false> | import("effect/unstable/httpapi/HttpApiGroup").HttpApiGroup<"sessions", import("effect/unstable/httpapi/HttpApiEndpoint").HttpApiEndpoint<"closeSession", "POST", "/v1/sessions/:sessionId/close", import("effect/unstable/httpapi/HttpApiEndpoint").StringTree<import("effect/Schema").Struct<{
@@ -619,6 +631,8 @@ export declare const ControlPlaneAPI: HttpApi.HttpApi<"sealantControlPlaneApi",
619
631
  readonly ownerUserId: import("effect/Schema").String;
620
632
  readonly status: import("effect/Schema").Literals<readonly ["starting", "running", "exited", "failed"]>;
621
633
  readonly argv: import("effect/Schema").$Array<import("effect/Schema").String>;
634
+ readonly argCount: import("effect/Schema").optional<import("effect/Schema").Number>;
635
+ readonly argLengths: import("effect/Schema").optional<import("effect/Schema").$Array<import("effect/Schema").Number>>;
622
636
  readonly cwd: import("effect/Schema").optional<import("effect/Schema").String>;
623
637
  readonly cols: import("effect/Schema").Number;
624
638
  readonly rows: import("effect/Schema").Number;
@@ -651,6 +665,8 @@ export declare const ControlPlaneAPI: HttpApi.HttpApi<"sealantControlPlaneApi",
651
665
  readonly ownerUserId: import("effect/Schema").String;
652
666
  readonly status: import("effect/Schema").Literals<readonly ["starting", "running", "exited", "failed"]>;
653
667
  readonly argv: import("effect/Schema").$Array<import("effect/Schema").String>;
668
+ readonly argCount: import("effect/Schema").optional<import("effect/Schema").Number>;
669
+ readonly argLengths: import("effect/Schema").optional<import("effect/Schema").$Array<import("effect/Schema").Number>>;
654
670
  readonly cwd: import("effect/Schema").optional<import("effect/Schema").String>;
655
671
  readonly cols: import("effect/Schema").Number;
656
672
  readonly rows: import("effect/Schema").Number;
@@ -675,6 +691,8 @@ export declare const ControlPlaneAPI: HttpApi.HttpApi<"sealantControlPlaneApi",
675
691
  readonly ownerUserId: import("effect/Schema").String;
676
692
  readonly status: import("effect/Schema").Literals<readonly ["starting", "running", "exited", "failed"]>;
677
693
  readonly argv: import("effect/Schema").$Array<import("effect/Schema").String>;
694
+ readonly argCount: import("effect/Schema").optional<import("effect/Schema").Number>;
695
+ readonly argLengths: import("effect/Schema").optional<import("effect/Schema").$Array<import("effect/Schema").Number>>;
678
696
  readonly cwd: import("effect/Schema").optional<import("effect/Schema").String>;
679
697
  readonly cols: import("effect/Schema").Number;
680
698
  readonly rows: import("effect/Schema").Number;
@@ -717,6 +735,8 @@ export declare const ControlPlaneAPI: HttpApi.HttpApi<"sealantControlPlaneApi",
717
735
  readonly ownerUserId: import("effect/Schema").String;
718
736
  readonly status: import("effect/Schema").Literals<readonly ["starting", "running", "exited", "failed"]>;
719
737
  readonly argv: import("effect/Schema").$Array<import("effect/Schema").String>;
738
+ readonly argCount: import("effect/Schema").optional<import("effect/Schema").Number>;
739
+ readonly argLengths: import("effect/Schema").optional<import("effect/Schema").$Array<import("effect/Schema").Number>>;
720
740
  readonly cwd: import("effect/Schema").optional<import("effect/Schema").String>;
721
741
  readonly cols: import("effect/Schema").Number;
722
742
  readonly rows: import("effect/Schema").Number;
@@ -931,12 +951,15 @@ export declare const ControlPlaneAPI: HttpApi.HttpApi<"sealantControlPlaneApi",
931
951
  readonly executable: import("effect/Schema").String;
932
952
  readonly args: import("effect/Schema").$Array<import("effect/Schema").String>;
933
953
  readonly cwd: import("effect/Schema").optional<import("effect/Schema").String>;
954
+ readonly argCount: import("effect/Schema").optional<import("effect/Schema").Number>;
955
+ readonly argLengths: import("effect/Schema").optional<import("effect/Schema").$Array<import("effect/Schema").Number>>;
934
956
  }>>;
935
957
  readonly metadata: import("effect/Schema").optional<import("effect/Schema").$Record<import("effect/Schema").String, import("effect/Schema").Unknown>>;
936
958
  readonly exitCode: import("effect/Schema").optional<import("effect/Schema").Number>;
937
959
  readonly errorMessage: import("effect/Schema").optional<import("effect/Schema").String>;
938
960
  readonly startedAt: import("effect/Schema").optional<import("effect/Schema").String>;
939
961
  readonly finishedAt: import("effect/Schema").optional<import("effect/Schema").String>;
962
+ readonly recordDeletedAt: import("effect/Schema").optional<import("effect/Schema").String>;
940
963
  readonly createdAt: import("effect/Schema").String;
941
964
  readonly updatedAt: import("effect/Schema").String;
942
965
  }>>, import("effect/unstable/httpapi/HttpApiEndpoint").Json<typeof import("./workspaces.js").WorkspaceBadRequestError | typeof import("./workspaces.js").WorkspaceNotFoundError | typeof import("./workspaces.js").WorkspaceConflictError | typeof import("./workspaces.js").WorkspaceInternalServerError>, never, never> | import("effect/unstable/httpapi/HttpApiEndpoint").HttpApiEndpoint<"expireWorkspace", "POST", "/v1/workspaces/:workspaceId/expire", import("effect/unstable/httpapi/HttpApiEndpoint").StringTree<import("effect/Schema").Struct<{
package/dist/core-api/record-events.d.ts CHANGED
@@ -43,7 +43,15 @@ export declare const processStartedEventSchema: Schema.Struct<{
43
43
  readonly pgid: Schema.Number;
44
44
  readonly pidfd: Schema.Boolean;
45
45
  readonly executable: Schema.String;
46
+ /**
47
+ * Always empty: Sealant never stores a process's arguments, because they can carry secrets.
48
+ * `argCount` and `argLengths` describe them. Kept so readers that decode it keep working.
49
+ */
46
50
  readonly args: Schema.$Array<Schema.String>;
51
+ /** How many arguments the process was started with. Absent when it had none. */
52
+ readonly argCount: Schema.optional<Schema.Number>;
53
+ /** Each argument's length in UTF-8 bytes, in order. Absent when it had none. */
54
+ readonly argLengths: Schema.optional<Schema.$Array<Schema.Number>>;
47
55
  readonly cwd: Schema.String;
48
56
  /** Wall clock at start, microseconds (decimal-string int64). */
49
57
  readonly startedAt: Schema.String;
package/dist/core-api/record-events.js CHANGED
@@ -59,7 +59,15 @@ export const processStartedEventSchema = Schema.Struct({
59
59
  pgid: Schema.Number,
60
60
  pidfd: Schema.Boolean,
61
61
  executable: Schema.String,
62
+ /**
63
+ * Always empty: Sealant never stores a process's arguments, because they can carry secrets.
64
+ * `argCount` and `argLengths` describe them. Kept so readers that decode it keep working.
65
+ */
62
66
  args: Schema.Array(Schema.String),
67
+ /** How many arguments the process was started with. Absent when it had none. */
68
+ argCount: Schema.optional(Schema.Number),
69
+ /** Each argument's length in UTF-8 bytes, in order. Absent when it had none. */
70
+ argLengths: Schema.optional(Schema.Array(Schema.Number)),
63
71
  cwd: Schema.String,
64
72
  /** Wall clock at start, microseconds (decimal-string int64). */
65
73
  startedAt: DecimalString,
package/dist/core-api/runs.d.ts CHANGED
@@ -25,6 +25,19 @@ export declare const runCommandSchema: Schema.Struct<{
25
25
  readonly cwd: Schema.optional<Schema.String>;
26
26
  }>;
27
27
  export type RunCommandWire = typeof runCommandSchema.Type;
28
+ /**
29
+ * The command a run resource reports: its executable and cwd. `args` is always empty: Sealant never
30
+ * stores a command's arguments, because they can carry secrets. `argCount` and `argLengths` (UTF-8
31
+ * bytes each) describe them; both are absent when there were none.
32
+ */
33
+ export declare const recordedRunCommandSchema: Schema.Struct<{
34
+ readonly executable: Schema.String;
35
+ readonly args: Schema.$Array<Schema.String>;
36
+ readonly cwd: Schema.optional<Schema.String>;
37
+ readonly argCount: Schema.optional<Schema.Number>;
38
+ readonly argLengths: Schema.optional<Schema.$Array<Schema.Number>>;
39
+ }>;
40
+ export type RecordedRunCommandWire = typeof recordedRunCommandSchema.Type;
28
41
  export declare const runSchema: Schema.Struct<{
29
42
  readonly runId: Schema.String;
30
43
  readonly workspaceId: Schema.String;
@@ -34,11 +47,13 @@ export declare const runSchema: Schema.Struct<{
34
47
  readonly mode: Schema.Literals<readonly ["one-shot", "interactive"]>;
35
48
  readonly status: Schema.Literals<readonly ["queued", "running", "completed", "failed", "cancelled"]>;
36
49
  readonly prompt: Schema.optional<Schema.String>;
37
- /** The resolved invocation the control plane executed (server-side runs) — self-describing. */
50
+ /** The invocation the run executes: executable and cwd, never its arguments. */
38
51
  readonly command: Schema.optional<Schema.Struct<{
39
52
  readonly executable: Schema.String;
40
53
  readonly args: Schema.$Array<Schema.String>;
41
54
  readonly cwd: Schema.optional<Schema.String>;
55
+ readonly argCount: Schema.optional<Schema.Number>;
56
+ readonly argLengths: Schema.optional<Schema.$Array<Schema.Number>>;
42
57
  }>>;
43
58
  /** Opaque caller correlation bag, echoed verbatim (no platform semantics). */
44
59
  readonly metadata: Schema.optional<Schema.$Record<Schema.String, Schema.Unknown>>;
@@ -46,6 +61,11 @@ export declare const runSchema: Schema.Struct<{
46
61
  readonly errorMessage: Schema.optional<Schema.String>;
47
62
  readonly startedAt: Schema.optional<Schema.String>;
48
63
  readonly finishedAt: Schema.optional<Schema.String>;
64
+ /**
65
+ * When run-record retention deleted this run's record (the operator's
66
+ * `SEALANT_RUN_RECORD_RETENTION_DAYS`). Its timeline, scrollback and events then read as empty.
67
+ */
68
+ readonly recordDeletedAt: Schema.optional<Schema.String>;
49
69
  readonly createdAt: Schema.String;
50
70
  readonly updatedAt: Schema.String;
51
71
  }>;
@@ -105,11 +125,13 @@ export declare const listRunsResponseSchema: Schema.Struct<{
105
125
  readonly mode: Schema.Literals<readonly ["one-shot", "interactive"]>;
106
126
  readonly status: Schema.Literals<readonly ["queued", "running", "completed", "failed", "cancelled"]>;
107
127
  readonly prompt: Schema.optional<Schema.String>;
108
- /** The resolved invocation the control plane executed (server-side runs) — self-describing. */
128
+ /** The invocation the run executes: executable and cwd, never its arguments. */
109
129
  readonly command: Schema.optional<Schema.Struct<{
110
130
  readonly executable: Schema.String;
111
131
  readonly args: Schema.$Array<Schema.String>;
112
132
  readonly cwd: Schema.optional<Schema.String>;
133
+ readonly argCount: Schema.optional<Schema.Number>;
134
+ readonly argLengths: Schema.optional<Schema.$Array<Schema.Number>>;
113
135
  }>>;
114
136
  /** Opaque caller correlation bag, echoed verbatim (no platform semantics). */
115
137
  readonly metadata: Schema.optional<Schema.$Record<Schema.String, Schema.Unknown>>;
@@ -117,6 +139,11 @@ export declare const listRunsResponseSchema: Schema.Struct<{
117
139
  readonly errorMessage: Schema.optional<Schema.String>;
118
140
  readonly startedAt: Schema.optional<Schema.String>;
119
141
  readonly finishedAt: Schema.optional<Schema.String>;
142
+ /**
143
+ * When run-record retention deleted this run's record (the operator's
144
+ * `SEALANT_RUN_RECORD_RETENTION_DAYS`). Its timeline, scrollback and events then read as empty.
145
+ */
146
+ readonly recordDeletedAt: Schema.optional<Schema.String>;
120
147
  readonly createdAt: Schema.String;
121
148
  readonly updatedAt: Schema.String;
122
149
  }>>;
@@ -298,11 +325,13 @@ export declare const RunsGroup: HttpApiGroup.HttpApiGroup<"runs", HttpApiEndpoin
298
325
  readonly mode: Schema.Literals<readonly ["one-shot", "interactive"]>;
299
326
  readonly status: Schema.Literals<readonly ["queued", "running", "completed", "failed", "cancelled"]>;
300
327
  readonly prompt: Schema.optional<Schema.String>;
301
- /** The resolved invocation the control plane executed (server-side runs) — self-describing. */
328
+ /** The invocation the run executes: executable and cwd, never its arguments. */
302
329
  readonly command: Schema.optional<Schema.Struct<{
303
330
  readonly executable: Schema.String;
304
331
  readonly args: Schema.$Array<Schema.String>;
305
332
  readonly cwd: Schema.optional<Schema.String>;
333
+ readonly argCount: Schema.optional<Schema.Number>;
334
+ readonly argLengths: Schema.optional<Schema.$Array<Schema.Number>>;
306
335
  }>>;
307
336
  /** Opaque caller correlation bag, echoed verbatim (no platform semantics). */
308
337
  readonly metadata: Schema.optional<Schema.$Record<Schema.String, Schema.Unknown>>;
@@ -310,6 +339,11 @@ export declare const RunsGroup: HttpApiGroup.HttpApiGroup<"runs", HttpApiEndpoin
310
339
  readonly errorMessage: Schema.optional<Schema.String>;
311
340
  readonly startedAt: Schema.optional<Schema.String>;
312
341
  readonly finishedAt: Schema.optional<Schema.String>;
342
+ /**
343
+ * When run-record retention deleted this run's record (the operator's
344
+ * `SEALANT_RUN_RECORD_RETENTION_DAYS`). Its timeline, scrollback and events then read as empty.
345
+ */
346
+ readonly recordDeletedAt: Schema.optional<Schema.String>;
313
347
  readonly createdAt: Schema.String;
314
348
  readonly updatedAt: Schema.String;
315
349
  }>>, HttpApiEndpoint.Json<typeof BudgetExceededError | typeof RunBadRequestError | typeof RunNotFoundError | typeof RunInternalServerError>, never, never> | HttpApiEndpoint.HttpApiEndpoint<"getRun", "GET", "/:runId", HttpApiEndpoint.StringTree<Schema.Struct<{
@@ -325,11 +359,13 @@ export declare const RunsGroup: HttpApiGroup.HttpApiGroup<"runs", HttpApiEndpoin
325
359
  readonly mode: Schema.Literals<readonly ["one-shot", "interactive"]>;
326
360
  readonly status: Schema.Literals<readonly ["queued", "running", "completed", "failed", "cancelled"]>;
327
361
  readonly prompt: Schema.optional<Schema.String>;
328
- /** The resolved invocation the control plane executed (server-side runs) — self-describing. */
362
+ /** The invocation the run executes: executable and cwd, never its arguments. */
329
363
  readonly command: Schema.optional<Schema.Struct<{
330
364
  readonly executable: Schema.String;
331
365
  readonly args: Schema.$Array<Schema.String>;
332
366
  readonly cwd: Schema.optional<Schema.String>;
367
+ readonly argCount: Schema.optional<Schema.Number>;
368
+ readonly argLengths: Schema.optional<Schema.$Array<Schema.Number>>;
333
369
  }>>;
334
370
  /** Opaque caller correlation bag, echoed verbatim (no platform semantics). */
335
371
  readonly metadata: Schema.optional<Schema.$Record<Schema.String, Schema.Unknown>>;
@@ -337,6 +373,11 @@ export declare const RunsGroup: HttpApiGroup.HttpApiGroup<"runs", HttpApiEndpoin
337
373
  readonly errorMessage: Schema.optional<Schema.String>;
338
374
  readonly startedAt: Schema.optional<Schema.String>;
339
375
  readonly finishedAt: Schema.optional<Schema.String>;
376
+ /**
377
+ * When run-record retention deleted this run's record (the operator's
378
+ * `SEALANT_RUN_RECORD_RETENTION_DAYS`). Its timeline, scrollback and events then read as empty.
379
+ */
380
+ readonly recordDeletedAt: Schema.optional<Schema.String>;
340
381
  readonly createdAt: Schema.String;
341
382
  readonly updatedAt: Schema.String;
342
383
  }>>, HttpApiEndpoint.Json<typeof RunNotFoundError | typeof RunInternalServerError>, never, never> | HttpApiEndpoint.HttpApiEndpoint<"getRunChanges", "GET", "/:runId/changes", HttpApiEndpoint.StringTree<Schema.Struct<{
@@ -458,11 +499,13 @@ export declare const RunsGroup: HttpApiGroup.HttpApiGroup<"runs", HttpApiEndpoin
458
499
  readonly mode: Schema.Literals<readonly ["one-shot", "interactive"]>;
459
500
  readonly status: Schema.Literals<readonly ["queued", "running", "completed", "failed", "cancelled"]>;
460
501
  readonly prompt: Schema.optional<Schema.String>;
461
- /** The resolved invocation the control plane executed (server-side runs) — self-describing. */
502
+ /** The invocation the run executes: executable and cwd, never its arguments. */
462
503
  readonly command: Schema.optional<Schema.Struct<{
463
504
  readonly executable: Schema.String;
464
505
  readonly args: Schema.$Array<Schema.String>;
465
506
  readonly cwd: Schema.optional<Schema.String>;
507
+ readonly argCount: Schema.optional<Schema.Number>;
508
+ readonly argLengths: Schema.optional<Schema.$Array<Schema.Number>>;
466
509
  }>>;
467
510
  /** Opaque caller correlation bag, echoed verbatim (no platform semantics). */
468
511
  readonly metadata: Schema.optional<Schema.$Record<Schema.String, Schema.Unknown>>;
@@ -470,6 +513,11 @@ export declare const RunsGroup: HttpApiGroup.HttpApiGroup<"runs", HttpApiEndpoin
470
513
  readonly errorMessage: Schema.optional<Schema.String>;
471
514
  readonly startedAt: Schema.optional<Schema.String>;
472
515
  readonly finishedAt: Schema.optional<Schema.String>;
516
+ /**
517
+ * When run-record retention deleted this run's record (the operator's
518
+ * `SEALANT_RUN_RECORD_RETENTION_DAYS`). Its timeline, scrollback and events then read as empty.
519
+ */
520
+ readonly recordDeletedAt: Schema.optional<Schema.String>;
473
521
  readonly createdAt: Schema.String;
474
522
  readonly updatedAt: Schema.String;
475
523
  }>>;
@@ -498,11 +546,13 @@ export declare const RunsGroup: HttpApiGroup.HttpApiGroup<"runs", HttpApiEndpoin
498
546
  readonly mode: Schema.Literals<readonly ["one-shot", "interactive"]>;
499
547
  readonly status: Schema.Literals<readonly ["queued", "running", "completed", "failed", "cancelled"]>;
500
548
  readonly prompt: Schema.optional<Schema.String>;
501
- /** The resolved invocation the control plane executed (server-side runs) — self-describing. */
549
+ /** The invocation the run executes: executable and cwd, never its arguments. */
502
550
  readonly command: Schema.optional<Schema.Struct<{
503
551
  readonly executable: Schema.String;
504
552
  readonly args: Schema.$Array<Schema.String>;
505
553
  readonly cwd: Schema.optional<Schema.String>;
554
+ readonly argCount: Schema.optional<Schema.Number>;
555
+ readonly argLengths: Schema.optional<Schema.$Array<Schema.Number>>;
506
556
  }>>;
507
557
  /** Opaque caller correlation bag, echoed verbatim (no platform semantics). */
508
558
  readonly metadata: Schema.optional<Schema.$Record<Schema.String, Schema.Unknown>>;
@@ -510,6 +560,11 @@ export declare const RunsGroup: HttpApiGroup.HttpApiGroup<"runs", HttpApiEndpoin
510
560
  readonly errorMessage: Schema.optional<Schema.String>;
511
561
  readonly startedAt: Schema.optional<Schema.String>;
512
562
  readonly finishedAt: Schema.optional<Schema.String>;
563
+ /**
564
+ * When run-record retention deleted this run's record (the operator's
565
+ * `SEALANT_RUN_RECORD_RETENTION_DAYS`). Its timeline, scrollback and events then read as empty.
566
+ */
567
+ readonly recordDeletedAt: Schema.optional<Schema.String>;
513
568
  readonly createdAt: Schema.String;
514
569
  readonly updatedAt: Schema.String;
515
570
  }>>, HttpApiEndpoint.Json<typeof RunBadRequestError | typeof RunNotFoundError | typeof RunInternalServerError>, never, never>, false>;
package/dist/core-api/runs.js CHANGED
@@ -32,6 +32,16 @@ export const runCommandSchema = Schema.Struct({
32
32
  args: Schema.Array(Schema.String),
33
33
  cwd: Schema.optional(NonEmptyString),
34
34
  });
35
+ /**
36
+ * The command a run resource reports: its executable and cwd. `args` is always empty: Sealant never
37
+ * stores a command's arguments, because they can carry secrets. `argCount` and `argLengths` (UTF-8
38
+ * bytes each) describe them; both are absent when there were none.
39
+ */
40
+ export const recordedRunCommandSchema = Schema.Struct({
41
+ ...runCommandSchema.fields,
42
+ argCount: Schema.optional(Schema.Number),
43
+ argLengths: Schema.optional(Schema.Array(Schema.Number)),
44
+ });
35
45
  export const runSchema = Schema.Struct({
36
46
  runId: NonEmptyString,
37
47
  workspaceId: NonEmptyString,
@@ -41,14 +51,19 @@ export const runSchema = Schema.Struct({
41
51
  mode: runModeSchema,
42
52
  status: runStatusSchema,
43
53
  prompt: Schema.optional(Schema.String),
44
- /** The resolved invocation the control plane executed (server-side runs) — self-describing. */
45
- command: Schema.optional(runCommandSchema),
54
+ /** The invocation the run executes: executable and cwd, never its arguments. */
55
+ command: Schema.optional(recordedRunCommandSchema),
46
56
  /** Opaque caller correlation bag, echoed verbatim (no platform semantics). */
47
57
  metadata: Schema.optional(Schema.Record(Schema.String, Schema.Unknown)),
48
58
  exitCode: Schema.optional(Schema.Number),
49
59
  errorMessage: Schema.optional(Schema.String),
50
60
  startedAt: Schema.optional(Schema.String),
51
61
  finishedAt: Schema.optional(Schema.String),
62
+ /**
63
+ * When run-record retention deleted this run's record (the operator's
64
+ * `SEALANT_RUN_RECORD_RETENTION_DAYS`). Its timeline, scrollback and events then read as empty.
65
+ */
66
+ recordDeletedAt: Schema.optional(Schema.String),
52
67
  createdAt: Schema.String,
53
68
  updatedAt: Schema.String,
54
69
  });
package/dist/core-api/sessions.d.ts CHANGED
@@ -69,7 +69,15 @@ export declare const sessionSchema: Schema.Struct<{
69
69
  readonly runId: Schema.String;
70
70
  readonly ownerUserId: Schema.String;
71
71
  readonly status: Schema.Literals<readonly ["starting", "running", "exited", "failed"]>;
72
+ /**
73
+ * Only `argv[0]`, the program: Sealant never stores a session's arguments, because they can carry
74
+ * secrets. `argCount` and `argLengths` (UTF-8 bytes each) describe them.
75
+ */
72
76
  readonly argv: Schema.$Array<Schema.String>;
77
+ /** How many arguments followed the program. Absent when there were none. */
78
+ readonly argCount: Schema.optional<Schema.Number>;
79
+ /** Each argument's length in UTF-8 bytes, in order. Absent when there were none. */
80
+ readonly argLengths: Schema.optional<Schema.$Array<Schema.Number>>;
73
81
  readonly cwd: Schema.optional<Schema.String>;
74
82
  readonly cols: Schema.Number;
75
83
  readonly rows: Schema.Number;
@@ -104,7 +112,15 @@ export declare const listSessionsResponseSchema: Schema.Struct<{
104
112
  readonly runId: Schema.String;
105
113
  readonly ownerUserId: Schema.String;
106
114
  readonly status: Schema.Literals<readonly ["starting", "running", "exited", "failed"]>;
115
+ /**
116
+ * Only `argv[0]`, the program: Sealant never stores a session's arguments, because they can carry
117
+ * secrets. `argCount` and `argLengths` (UTF-8 bytes each) describe them.
118
+ */
107
119
  readonly argv: Schema.$Array<Schema.String>;
120
+ /** How many arguments followed the program. Absent when there were none. */
121
+ readonly argCount: Schema.optional<Schema.Number>;
122
+ /** Each argument's length in UTF-8 bytes, in order. Absent when there were none. */
123
+ readonly argLengths: Schema.optional<Schema.$Array<Schema.Number>>;
108
124
  readonly cwd: Schema.optional<Schema.String>;
109
125
  readonly cols: Schema.Number;
110
126
  readonly rows: Schema.Number;
@@ -227,7 +243,15 @@ export declare const SessionsGroup: HttpApiGroup.HttpApiGroup<"sessions", HttpAp
227
243
  readonly runId: Schema.String;
228
244
  readonly ownerUserId: Schema.String;
229
245
  readonly status: Schema.Literals<readonly ["starting", "running", "exited", "failed"]>;
246
+ /**
247
+ * Only `argv[0]`, the program: Sealant never stores a session's arguments, because they can carry
248
+ * secrets. `argCount` and `argLengths` (UTF-8 bytes each) describe them.
249
+ */
230
250
  readonly argv: Schema.$Array<Schema.String>;
251
+ /** How many arguments followed the program. Absent when there were none. */
252
+ readonly argCount: Schema.optional<Schema.Number>;
253
+ /** Each argument's length in UTF-8 bytes, in order. Absent when there were none. */
254
+ readonly argLengths: Schema.optional<Schema.$Array<Schema.Number>>;
231
255
  readonly cwd: Schema.optional<Schema.String>;
232
256
  readonly cols: Schema.Number;
233
257
  readonly rows: Schema.Number;
@@ -272,7 +296,15 @@ export declare const SessionsGroup: HttpApiGroup.HttpApiGroup<"sessions", HttpAp
272
296
  readonly runId: Schema.String;
273
297
  readonly ownerUserId: Schema.String;
274
298
  readonly status: Schema.Literals<readonly ["starting", "running", "exited", "failed"]>;
299
+ /**
300
+ * Only `argv[0]`, the program: Sealant never stores a session's arguments, because they can carry
301
+ * secrets. `argCount` and `argLengths` (UTF-8 bytes each) describe them.
302
+ */
275
303
  readonly argv: Schema.$Array<Schema.String>;
304
+ /** How many arguments followed the program. Absent when there were none. */
305
+ readonly argCount: Schema.optional<Schema.Number>;
306
+ /** Each argument's length in UTF-8 bytes, in order. Absent when there were none. */
307
+ readonly argLengths: Schema.optional<Schema.$Array<Schema.Number>>;
276
308
  readonly cwd: Schema.optional<Schema.String>;
277
309
  readonly cols: Schema.Number;
278
310
  readonly rows: Schema.Number;
@@ -303,7 +335,15 @@ export declare const SessionsGroup: HttpApiGroup.HttpApiGroup<"sessions", HttpAp
303
335
  readonly runId: Schema.String;
304
336
  readonly ownerUserId: Schema.String;
305
337
  readonly status: Schema.Literals<readonly ["starting", "running", "exited", "failed"]>;
338
+ /**
339
+ * Only `argv[0]`, the program: Sealant never stores a session's arguments, because they can carry
340
+ * secrets. `argCount` and `argLengths` (UTF-8 bytes each) describe them.
341
+ */
306
342
  readonly argv: Schema.$Array<Schema.String>;
343
+ /** How many arguments followed the program. Absent when there were none. */
344
+ readonly argCount: Schema.optional<Schema.Number>;
345
+ /** Each argument's length in UTF-8 bytes, in order. Absent when there were none. */
346
+ readonly argLengths: Schema.optional<Schema.$Array<Schema.Number>>;
307
347
  readonly cwd: Schema.optional<Schema.String>;
308
348
  readonly cols: Schema.Number;
309
349
  readonly rows: Schema.Number;
@@ -355,7 +395,15 @@ export declare const SessionsGroup: HttpApiGroup.HttpApiGroup<"sessions", HttpAp
355
395
  readonly runId: Schema.String;
356
396
  readonly ownerUserId: Schema.String;
357
397
  readonly status: Schema.Literals<readonly ["starting", "running", "exited", "failed"]>;
398
+ /**
399
+ * Only `argv[0]`, the program: Sealant never stores a session's arguments, because they can carry
400
+ * secrets. `argCount` and `argLengths` (UTF-8 bytes each) describe them.
401
+ */
358
402
  readonly argv: Schema.$Array<Schema.String>;
403
+ /** How many arguments followed the program. Absent when there were none. */
404
+ readonly argCount: Schema.optional<Schema.Number>;
405
+ /** Each argument's length in UTF-8 bytes, in order. Absent when there were none. */
406
+ readonly argLengths: Schema.optional<Schema.$Array<Schema.Number>>;
359
407
  readonly cwd: Schema.optional<Schema.String>;
360
408
  readonly cols: Schema.Number;
361
409
  readonly rows: Schema.Number;
package/dist/core-api/sessions.js CHANGED
@@ -65,7 +65,15 @@ export const sessionSchema = Schema.Struct({
65
65
  runId: NonEmptyString,
66
66
  ownerUserId: NonEmptyString,
67
67
  status: sessionStatusSchema,
68
+ /**
69
+ * Only `argv[0]`, the program: Sealant never stores a session's arguments, because they can carry
70
+ * secrets. `argCount` and `argLengths` (UTF-8 bytes each) describe them.
71
+ */
68
72
  argv: Schema.Array(Schema.String),
73
+ /** How many arguments followed the program. Absent when there were none. */
74
+ argCount: Schema.optional(Schema.Number),
75
+ /** Each argument's length in UTF-8 bytes, in order. Absent when there were none. */
76
+ argLengths: Schema.optional(Schema.Array(Schema.Number)),
69
77
  cwd: Schema.optional(NonEmptyString),
70
78
  cols: Schema.Number,
71
79
  rows: Schema.Number,
package/dist/core-api/workspaces.d.ts CHANGED
@@ -1554,12 +1554,15 @@ export declare const WorkspacesGroup: HttpApiGroup.HttpApiGroup<"workspaces", Ht
1554
1554
  readonly executable: Schema.String;
1555
1555
  readonly args: Schema.$Array<Schema.String>;
1556
1556
  readonly cwd: Schema.optional<Schema.String>;
1557
+ readonly argCount: Schema.optional<Schema.Number>;
1558
+ readonly argLengths: Schema.optional<Schema.$Array<Schema.Number>>;
1557
1559
  }>>;
1558
1560
  readonly metadata: Schema.optional<Schema.$Record<Schema.String, Schema.Unknown>>;
1559
1561
  readonly exitCode: Schema.optional<Schema.Number>;
1560
1562
  readonly errorMessage: Schema.optional<Schema.String>;
1561
1563
  readonly startedAt: Schema.optional<Schema.String>;
1562
1564
  readonly finishedAt: Schema.optional<Schema.String>;
1565
+ readonly recordDeletedAt: Schema.optional<Schema.String>;
1563
1566
  readonly createdAt: Schema.String;
1564
1567
  readonly updatedAt: Schema.String;
1565
1568
  }>>, HttpApiEndpoint.Json<typeof WorkspaceBadRequestError | typeof WorkspaceNotFoundError | typeof WorkspaceConflictError | typeof WorkspaceInternalServerError>, never, never> | HttpApiEndpoint.HttpApiEndpoint<"expireWorkspace", "POST", "/:workspaceId/expire", HttpApiEndpoint.StringTree<Schema.Struct<{
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@sealant/api-contracts-next",
3
- "version": "0.39.0-next.692",
3
+ "version": "0.39.0-next.693",
4
4
  "description": "Contract-first HTTP API definitions for Sealant services",
5
5
  "license": "Apache-2.0",
6
6
  "repository": {
@@ -28,7 +28,7 @@
28
28
  "peerDependencies": {
29
29
  "effect": ">=4.0.0-beta.85 <5"
30
30
  },
31
- "gitHead": "856412ff6b8e8fcae303941ede49f4492c498d4a",
31
+ "gitHead": "58bba78e17aa1040d344fb58fd519764f74fa760",
32
32
  "publishConfig": {
33
33
  "access": "public"
34
34
  }