@bctrl/sdk 1.0.7 → 1.0.8

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.
@@ -521,6 +521,30 @@ export interface paths {
521
521
  /**
522
522
  * Stream run activities
523
523
  * @description Stream unified run activities as Server-Sent Events.
524
+ *
525
+ * Each frame uses an `event:` line and a JSON `data:` body. Durable activity frames also include an `id:` line that can be used as the next `cursor`.
526
+ *
527
+ * ### Event frames
528
+ *
529
+ * | Event | Has `id` | Data schema | When it is sent |
530
+ * |---|---:|---|---|
531
+ * | `run.activity` | Yes | `RunActivityItem` | A new activity item is available. |
532
+ * | `heartbeat` | No | `{ time: string }` | Keeps the stream alive while no activity is emitted. |
533
+ * | `run.ended` | No | `{ runId: string, status: RunStatus, finishedAt: string | null, failure: RunFailure | null }` | Terminal frame emitted when the run finishes. |
534
+ *
535
+ * ### Example
536
+ *
537
+ * ```text
538
+ * event: run.activity
539
+ * id: act_123
540
+ * data: {"id":"act_123","runId":"run_123","type":"log","time":"2026-06-25T12:00:00.000Z"}
541
+ *
542
+ * event: heartbeat
543
+ * data: {"time":"2026-06-25T12:00:05.000Z"}
544
+ *
545
+ * event: run.ended
546
+ * data: {"runId":"run_123","status":"completed","finishedAt":"2026-06-25T12:01:00.000Z","failure":null}
547
+ * ```
524
548
  */
525
549
  get: operations["runs.activity.stream"];
526
550
  put?: never;
@@ -561,6 +585,30 @@ export interface paths {
561
585
  /**
562
586
  * Stream run events
563
587
  * @description Stream canonical run events as Server-Sent Events.
588
+ *
589
+ * Each frame uses an `event:` line and a JSON `data:` body. Durable run-event frames also include an `id:` line that can be used as the next `cursor`.
590
+ *
591
+ * ### Event frames
592
+ *
593
+ * | Event | Has `id` | Data schema | When it is sent |
594
+ * |---|---:|---|---|
595
+ * | `run.event` | Yes | `RunEvent` | A new canonical run event is available. |
596
+ * | `heartbeat` | No | `{ time: string }` | Keeps the stream alive while no event is emitted. |
597
+ * | `run.ended` | No | `{ runId: string, status: RunStatus, finishedAt: string | null, failure: RunFailure | null }` | Terminal frame emitted when the run finishes. |
598
+ *
599
+ * ### Example
600
+ *
601
+ * ```text
602
+ * event: run.event
603
+ * id: evt_123
604
+ * data: {"id":"evt_123","runId":"run_123","type":"runtime.lifecycle","status":"completed"}
605
+ *
606
+ * event: heartbeat
607
+ * data: {"time":"2026-06-25T12:00:05.000Z"}
608
+ *
609
+ * event: run.ended
610
+ * data: {"runId":"run_123","status":"completed","finishedAt":"2026-06-25T12:01:00.000Z","failure":null}
611
+ * ```
564
612
  */
565
613
  get: operations["runs.events.stream"];
566
614
  put?: never;
@@ -5211,14 +5259,16 @@ export interface operations {
5211
5259
  "files.list": {
5212
5260
  parameters: {
5213
5261
  query?: {
5214
- spaceId?: string | "default";
5262
+ /** @description Filter by a space UUID, or pass `default` to use the caller default space. */
5263
+ spaceId?: string;
5215
5264
  source?: "upload" | "runtime";
5216
5265
  path?: string;
5217
5266
  prefix?: string;
5218
5267
  q?: string;
5219
5268
  runId?: string;
5220
5269
  runtimeId?: string;
5221
- type?: string | string[];
5270
+ /** @description Filter by one or more file artifact types. Repeat the query parameter for multiple values. */
5271
+ type?: string[];
5222
5272
  createdAfter?: string;
5223
5273
  include?: "folders";
5224
5274
  cursor?: string;
@@ -5285,7 +5335,8 @@ export interface operations {
5285
5335
  "files.upload": {
5286
5336
  parameters: {
5287
5337
  query?: {
5288
- spaceId?: string | "default";
5338
+ /** @description Filter by a space UUID, or pass `default` to use the caller default space. */
5339
+ spaceId?: string;
5289
5340
  };
5290
5341
  header?: never;
5291
5342
  path?: never;
@@ -6701,7 +6752,8 @@ export interface operations {
6701
6752
  "runs.list": {
6702
6753
  parameters: {
6703
6754
  query?: {
6704
- status?: ("active" | "stopped" | "failed") | ("active" | "stopped" | "failed")[];
6755
+ /** @description Filter by one or more run statuses. Repeat the query parameter for multiple values. */
6756
+ status?: ("active" | "stopped" | "failed")[];
6705
6757
  spaceId?: string;
6706
6758
  runtimeId?: string;
6707
6759
  cursor?: string;
@@ -6867,9 +6919,12 @@ export interface operations {
6867
6919
  parameters: {
6868
6920
  query?: {
6869
6921
  view?: "normal" | "debug";
6870
- type?: string | string[];
6871
- category?: ("runtime" | "browser" | "network" | "console" | "file" | "invocation" | "tool" | "captcha" | "agent" | "llm" | "system") | ("runtime" | "browser" | "network" | "console" | "file" | "invocation" | "tool" | "captcha" | "agent" | "llm" | "system")[];
6872
- severity?: ("info" | "warning" | "error") | ("info" | "warning" | "error")[];
6922
+ /** @description Filter by one or more activity types. Repeat the query parameter for multiple values. */
6923
+ type?: string[];
6924
+ /** @description Filter by one or more activity categories. Repeat the query parameter for multiple values. */
6925
+ category?: ("runtime" | "browser" | "network" | "console" | "file" | "invocation" | "tool" | "captcha" | "agent" | "llm" | "system")[];
6926
+ /** @description Filter by one or more activity severities. Repeat the query parameter for multiple values. */
6927
+ severity?: ("info" | "warning" | "error")[];
6873
6928
  invocationId?: string;
6874
6929
  fileId?: string;
6875
6930
  cursor?: string;
@@ -6973,9 +7028,12 @@ export interface operations {
6973
7028
  parameters: {
6974
7029
  query?: {
6975
7030
  view?: "normal" | "debug";
6976
- type?: string | string[];
6977
- category?: ("runtime" | "browser" | "network" | "console" | "file" | "invocation" | "tool" | "captcha" | "agent" | "llm" | "system") | ("runtime" | "browser" | "network" | "console" | "file" | "invocation" | "tool" | "captcha" | "agent" | "llm" | "system")[];
6978
- severity?: ("info" | "warning" | "error") | ("info" | "warning" | "error")[];
7031
+ /** @description Filter by one or more activity types. Repeat the query parameter for multiple values. */
7032
+ type?: string[];
7033
+ /** @description Filter by one or more activity categories. Repeat the query parameter for multiple values. */
7034
+ category?: ("runtime" | "browser" | "network" | "console" | "file" | "invocation" | "tool" | "captcha" | "agent" | "llm" | "system")[];
7035
+ /** @description Filter by one or more activity severities. Repeat the query parameter for multiple values. */
7036
+ severity?: ("info" | "warning" | "error")[];
6979
7037
  invocationId?: string;
6980
7038
  fileId?: string;
6981
7039
  cursor?: string;
@@ -7069,8 +7127,10 @@ export interface operations {
7069
7127
  "runs.events.list": {
7070
7128
  parameters: {
7071
7129
  query?: {
7072
- type?: ("runtime.lifecycle" | "navigation" | "network.request" | "network.response" | "network.failed" | "console.message" | "page.error" | "page.crash" | "dialog" | "download" | "captcha.solve.started" | "captcha.solve.succeeded" | "captcha.solve.failed") | ("runtime.lifecycle" | "navigation" | "network.request" | "network.response" | "network.failed" | "console.message" | "page.error" | "page.crash" | "dialog" | "download" | "captcha.solve.started" | "captcha.solve.succeeded" | "captcha.solve.failed")[];
7073
- status?: ("started" | "stopped" | "failed" | "finished" | "received") | ("started" | "stopped" | "failed" | "finished" | "received")[];
7130
+ /** @description Filter by one or more event types. Repeat the query parameter for multiple values. */
7131
+ type?: ("runtime.lifecycle" | "navigation" | "network.request" | "network.response" | "network.failed" | "console.message" | "page.error" | "page.crash" | "dialog" | "download" | "captcha.solve.started" | "captcha.solve.succeeded" | "captcha.solve.failed")[];
7132
+ /** @description Filter by one or more event statuses. Repeat the query parameter for multiple values. */
7133
+ status?: ("started" | "stopped" | "failed" | "finished" | "received")[];
7074
7134
  pageId?: string;
7075
7135
  contextId?: string;
7076
7136
  cursor?: string;
@@ -7173,8 +7233,10 @@ export interface operations {
7173
7233
  "runs.events.stream": {
7174
7234
  parameters: {
7175
7235
  query?: {
7176
- type?: ("runtime.lifecycle" | "navigation" | "network.request" | "network.response" | "network.failed" | "console.message" | "page.error" | "page.crash" | "dialog" | "download" | "captcha.solve.started" | "captcha.solve.succeeded" | "captcha.solve.failed") | ("runtime.lifecycle" | "navigation" | "network.request" | "network.response" | "network.failed" | "console.message" | "page.error" | "page.crash" | "dialog" | "download" | "captcha.solve.started" | "captcha.solve.succeeded" | "captcha.solve.failed")[];
7177
- status?: ("started" | "stopped" | "failed" | "finished" | "received") | ("started" | "stopped" | "failed" | "finished" | "received")[];
7236
+ /** @description Filter by one or more event types. Repeat the query parameter for multiple values. */
7237
+ type?: ("runtime.lifecycle" | "navigation" | "network.request" | "network.response" | "network.failed" | "console.message" | "page.error" | "page.crash" | "dialog" | "download" | "captcha.solve.started" | "captcha.solve.succeeded" | "captcha.solve.failed")[];
7238
+ /** @description Filter by one or more event statuses. Repeat the query parameter for multiple values. */
7239
+ status?: ("started" | "stopped" | "failed" | "finished" | "received")[];
7178
7240
  pageId?: string;
7179
7241
  contextId?: string;
7180
7242
  cursor?: string;
@@ -7268,7 +7330,8 @@ export interface operations {
7268
7330
  "runs.files.list": {
7269
7331
  parameters: {
7270
7332
  query?: {
7271
- type?: string | string[];
7333
+ /** @description Filter by one or more file artifact types. Repeat the query parameter for multiple values. */
7334
+ type?: string[];
7272
7335
  cursor?: string;
7273
7336
  limit?: number;
7274
7337
  };
@@ -7519,8 +7582,10 @@ export interface operations {
7519
7582
  "runs.invocations.list": {
7520
7583
  parameters: {
7521
7584
  query?: {
7522
- status?: ("queued" | "dispatching" | "running" | "cancelling" | "succeeded" | "failed" | "cancelled" | "timed_out") | ("queued" | "dispatching" | "running" | "cancelling" | "succeeded" | "failed" | "cancelled" | "timed_out")[];
7523
- action?: ("act" | "observe" | "extract" | "browserUse" | "stagehandAgent" | "solveCaptcha") | ("act" | "observe" | "extract" | "browserUse" | "stagehandAgent" | "solveCaptcha")[];
7585
+ /** @description Filter by one or more invocation statuses. Repeat the query parameter for multiple values. */
7586
+ status?: ("queued" | "dispatching" | "running" | "cancelling" | "succeeded" | "failed" | "cancelled" | "timed_out")[];
7587
+ /** @description Filter by one or more invocation actions. Repeat the query parameter for multiple values. */
7588
+ action?: ("act" | "observe" | "extract" | "browserUse" | "stagehandAgent" | "solveCaptcha")[];
7524
7589
  cursor?: string;
7525
7590
  limit?: number;
7526
7591
  };
@@ -7965,8 +8030,10 @@ export interface operations {
7965
8030
  "runtimes.list": {
7966
8031
  parameters: {
7967
8032
  query?: {
7968
- spaceId?: string | "default";
7969
- status?: ("active" | "stopped" | "failed") | ("active" | "stopped" | "failed")[];
8033
+ /** @description Filter by a space UUID, or pass `default` to use the caller default space. */
8034
+ spaceId?: string;
8035
+ /** @description Filter by one or more runtime statuses. Repeat the query parameter for multiple values. */
8036
+ status?: ("active" | "stopped" | "failed")[];
7970
8037
  cursor?: string;
7971
8038
  limit?: number;
7972
8039
  };
@@ -8457,7 +8524,8 @@ export interface operations {
8457
8524
  "runtimes.files.list": {
8458
8525
  parameters: {
8459
8526
  query?: {
8460
- type?: string | string[];
8527
+ /** @description Filter by one or more file artifact types. Repeat the query parameter for multiple values. */
8528
+ type?: string[];
8461
8529
  cursor?: string;
8462
8530
  limit?: number;
8463
8531
  };
@@ -11179,7 +11247,9 @@ export interface operations {
11179
11247
  query?: {
11180
11248
  cursor?: string;
11181
11249
  limit?: number;
11182
- include?: "usage" | "usage"[];
11250
+ /** @description Include optional subaccount expansions. Repeat the query parameter for multiple values. */
11251
+ include?: "usage"[];
11252
+ /** @description Filter subaccounts by lifecycle status. */
11183
11253
  status?: "active" | "archived";
11184
11254
  externalId?: string;
11185
11255
  query?: string;
@@ -11376,7 +11446,8 @@ export interface operations {
11376
11446
  "subaccounts.get": {
11377
11447
  parameters: {
11378
11448
  query?: {
11379
- include?: "usage" | "usage"[];
11449
+ /** @description Include optional subaccount expansions. Repeat the query parameter for multiple values. */
11450
+ include?: "usage"[];
11380
11451
  };
11381
11452
  header?: never;
11382
11453
  path: {
@@ -11751,7 +11822,8 @@ export interface operations {
11751
11822
  "tool-calls.list": {
11752
11823
  parameters: {
11753
11824
  query?: {
11754
- spaceId?: string | "default";
11825
+ /** @description Filter by a space UUID, or pass `default` to use the caller default space. */
11826
+ spaceId?: string;
11755
11827
  toolId?: string;
11756
11828
  runId?: string;
11757
11829
  invocationId?: string;
@@ -11900,7 +11972,8 @@ export interface operations {
11900
11972
  "tools.list": {
11901
11973
  parameters: {
11902
11974
  query?: {
11903
- spaceId?: string | "default";
11975
+ /** @description Filter by a space UUID, or pass `default` to use the caller default space. */
11976
+ spaceId?: string;
11904
11977
  cursor?: string;
11905
11978
  limit?: number;
11906
11979
  };
@@ -12538,7 +12611,8 @@ export interface operations {
12538
12611
  "toolsets.list": {
12539
12612
  parameters: {
12540
12613
  query?: {
12541
- spaceId?: string | "default";
12614
+ /** @description Filter by a space UUID, or pass `default` to use the caller default space. */
12615
+ spaceId?: string;
12542
12616
  cursor?: string;
12543
12617
  limit?: number;
12544
12618
  };
@@ -13090,7 +13164,8 @@ export interface operations {
13090
13164
  query?: {
13091
13165
  prefix?: string;
13092
13166
  origin?: string;
13093
- hasTotp?: boolean | "0" | "1" | "true" | "false";
13167
+ /** @description Filter to secrets that have or do not have TOTP configured. */
13168
+ hasTotp?: boolean;
13094
13169
  cursor?: string;
13095
13170
  limit?: number;
13096
13171
  };
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@bctrl/sdk",
3
- "version": "1.0.7",
3
+ "version": "1.0.8",
4
4
  "description": "BCTRL SDK - Remote browser automation",
5
5
  "main": "./dist/index.js",
6
6
  "types": "./dist/index.d.ts",