sailfork 0.6.0 → 0.6.2

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.
@@ -1065,6 +1065,19 @@ export declare const ops: {
1065
1065
  long: false;
1066
1066
  paginated: false;
1067
1067
  };
1068
+ 'issues.mine_page': {
1069
+ id: string;
1070
+ method: 'GET';
1071
+ path: string;
1072
+ pathParams: never[];
1073
+ queryParams: string[];
1074
+ bodyParams: never[];
1075
+ effect: 'read';
1076
+ retry: 'safe';
1077
+ held: false;
1078
+ long: false;
1079
+ paginated: false;
1080
+ };
1068
1081
  'issues.next': {
1069
1082
  id: string;
1070
1083
  method: 'GET';
@@ -1312,6 +1325,19 @@ export declare const ops: {
1312
1325
  long: false;
1313
1326
  paginated: false;
1314
1327
  };
1328
+ 'me.get': {
1329
+ id: string;
1330
+ method: 'GET';
1331
+ path: string;
1332
+ pathParams: never[];
1333
+ queryParams: never[];
1334
+ bodyParams: never[];
1335
+ effect: 'read';
1336
+ retry: 'safe';
1337
+ held: false;
1338
+ long: false;
1339
+ paginated: false;
1340
+ };
1315
1341
  'me.onboarded': {
1316
1342
  id: string;
1317
1343
  method: 'POST';
@@ -1676,6 +1702,19 @@ export declare const ops: {
1676
1702
  long: false;
1677
1703
  paginated: false;
1678
1704
  };
1705
+ 'pulls.mine': {
1706
+ id: string;
1707
+ method: 'GET';
1708
+ path: string;
1709
+ pathParams: never[];
1710
+ queryParams: string[];
1711
+ bodyParams: never[];
1712
+ effect: 'read';
1713
+ retry: 'safe';
1714
+ held: false;
1715
+ long: false;
1716
+ paginated: false;
1717
+ };
1679
1718
  'pulls.resolve_conflicts': {
1680
1719
  id: string;
1681
1720
  method: 'POST';
@@ -1767,6 +1806,84 @@ export declare const ops: {
1767
1806
  long: false;
1768
1807
  paginated: false;
1769
1808
  };
1809
+ 'push.devices.register': {
1810
+ id: string;
1811
+ method: 'POST';
1812
+ path: string;
1813
+ pathParams: never[];
1814
+ queryParams: never[];
1815
+ bodyParams: string[];
1816
+ effect: 'write';
1817
+ retry: 'idempotent';
1818
+ held: false;
1819
+ long: false;
1820
+ paginated: false;
1821
+ };
1822
+ 'push.devices.unregister': {
1823
+ id: string;
1824
+ method: 'DELETE';
1825
+ path: string;
1826
+ pathParams: string[];
1827
+ queryParams: never[];
1828
+ bodyParams: never[];
1829
+ effect: 'delete';
1830
+ retry: 'idempotent';
1831
+ held: false;
1832
+ long: false;
1833
+ paginated: false;
1834
+ };
1835
+ 'push.live_activity_tokens.register': {
1836
+ id: string;
1837
+ method: 'POST';
1838
+ path: string;
1839
+ pathParams: never[];
1840
+ queryParams: never[];
1841
+ bodyParams: string[];
1842
+ effect: 'write';
1843
+ retry: 'idempotent';
1844
+ held: false;
1845
+ long: false;
1846
+ paginated: false;
1847
+ };
1848
+ 'push.live_activity_tokens.remove': {
1849
+ id: string;
1850
+ method: 'DELETE';
1851
+ path: string;
1852
+ pathParams: string[];
1853
+ queryParams: never[];
1854
+ bodyParams: never[];
1855
+ effect: 'delete';
1856
+ retry: 'idempotent';
1857
+ held: false;
1858
+ long: false;
1859
+ paginated: false;
1860
+ };
1861
+ 'push.settings.get': {
1862
+ id: string;
1863
+ method: 'GET';
1864
+ path: string;
1865
+ pathParams: never[];
1866
+ queryParams: never[];
1867
+ bodyParams: never[];
1868
+ effect: 'read';
1869
+ retry: 'safe';
1870
+ held: false;
1871
+ long: false;
1872
+ paginated: false;
1873
+ };
1874
+ 'push.settings.update': {
1875
+ id: string;
1876
+ method: 'PATCH';
1877
+ path: string;
1878
+ pathParams: never[];
1879
+ queryParams: never[];
1880
+ bodyParams: string[];
1881
+ effect: 'write';
1882
+ retry: 'idempotent';
1883
+ held: false;
1884
+ long: false;
1885
+ paginated: false;
1886
+ };
1770
1887
  'repos.commit': {
1771
1888
  id: string;
1772
1889
  method: 'GET';
@@ -1023,6 +1023,8 @@ export type Hidden = {
1023
1023
  };
1024
1024
  /** Why a comment is hidden. */
1025
1025
  export type HideReason = 'spam' | 'abuse' | 'offTopic' | 'outdated' | 'resolved';
1026
+ /** The operating system a host's sandboxes run: the guest OS of a macOS VM sandbox, else Linux. */
1027
+ export type HostOs = 'linux' | 'macos';
1026
1028
  export type Inbox = {
1027
1029
  /** Unread notifications per tab of what `owner` asked for. */
1028
1030
  counts: InboxCounts;
@@ -1298,6 +1300,13 @@ export type LabelList = {
1298
1300
  /** Most used first, then by name. */
1299
1301
  items: LabelItem[];
1300
1302
  };
1303
+ /** A registered Live Activity token. */
1304
+ export type LiveActivityToken = {
1305
+ expiresAt: string | null;
1306
+ kind: LiveActivityTokenKind;
1307
+ subject: string | null;
1308
+ };
1309
+ export type LiveActivityTokenKind = 'push_to_start' | 'activity';
1301
1310
  /** The account after a profile change. */
1302
1311
  export type MeUpdated = {
1303
1312
  avatarUrl: string | null;
@@ -1306,6 +1315,26 @@ export type MeUpdated = {
1306
1315
  id: string;
1307
1316
  name: string;
1308
1317
  };
1318
+ /** The signed-in account with the addresses its clone URLs use. */
1319
+ export type MeView = {
1320
+ /** A site administrator, who sees `/admin`; left out for everyone else. */
1321
+ admin?: boolean;
1322
+ avatarUrl: string | null;
1323
+ email: string;
1324
+ /** Origin of HTTPS clone URLs: the git host when the server has one, else the site. */
1325
+ gitBase: string;
1326
+ handle: string;
1327
+ id: string;
1328
+ name: string;
1329
+ /** When the person finished or skipped the welcome steps; null right after sign-up. */
1330
+ onboardedAt: string | null;
1331
+ /** A safety operator, who sees the safety queue; left out for everyone else. */
1332
+ safetyOperator?: boolean;
1333
+ /** The `ssh://` origin of clone URLs; null when the server has no SSH host. */
1334
+ sshBase: string | null;
1335
+ /** The person has not accepted the current terms; the web app asks before anything else. Left out once accepted, and never blocks tokens. */
1336
+ termsStale?: boolean;
1337
+ };
1309
1338
  /** How `POST pulls/{n}/merge` lands the commits; omitted, the base fast-forwards when it can and gets a merge commit otherwise. */
1310
1339
  export type MergeMethod = 'merge' | 'squash' | 'rebase' | 'fast-forward';
1311
1340
  /** Whether the head merges into the base as the branches stand: `clean`, `conflict` (with the files that do not merge in `conflicts`) or `unknown` (merged, closed, a branch gone, or the check failed). */
@@ -1351,9 +1380,73 @@ export type MyIssue = {
1351
1380
  title: string;
1352
1381
  url: string;
1353
1382
  };
1383
+ /** Which of the caller's issues `issues.mine_page` lists. */
1384
+ export type MyIssueFilter = 'assigned' | 'created' | 'mentioned' | 'involved';
1385
+ /** A page of the caller's issues across repositories. */
1386
+ export type MyIssuePage = {
1387
+ /** Newest first. */
1388
+ items: MyIssuePageItem[];
1389
+ /** Pass it as `cursor` for the next page; absent on the last. */
1390
+ nextCursor: string | null;
1391
+ };
1392
+ /** An issue of one of the caller's repositories lists, with where it lives. */
1393
+ export type MyIssuePageItem = {
1394
+ /** Nested, not flattened: the issue's own `owner` is its assignee and would collide with the repository owner. */
1395
+ issue: Issue;
1396
+ /** The repository owner's handle. */
1397
+ owner: string;
1398
+ /** The repository's name. */
1399
+ repo: string;
1400
+ };
1354
1401
  export type MyIssues = {
1355
1402
  items: MyIssue[];
1356
1403
  };
1404
+ /** A pull request of one of the caller's repositories lists, with where it lives. */
1405
+ export type MyPull = {
1406
+ agent: boolean;
1407
+ /** The client named in `X-Sailfork-Agent`, or `caisson`; absent for people. */
1408
+ agentClient?: string | null;
1409
+ /** How that client reached Sailfork: the `sailfork` CLI or MCP. */
1410
+ agentSurface?: Surface | null;
1411
+ at: string;
1412
+ author: string;
1413
+ base: string;
1414
+ /** Absent from the trimmed rows of a `brief` list. */
1415
+ body?: string[];
1416
+ /** REST only: the body as one string. */
1417
+ bodyText?: string | null;
1418
+ branch: string;
1419
+ checks: string;
1420
+ /** REST only: the issues merging it closes, from `Closes #n` in its title or body and an `issue/<n>-` branch, which `Refs #n` overrides. */
1421
+ closes?: number[];
1422
+ /** REST only: the branch again, under the name callers expect. */
1423
+ head?: string | null;
1424
+ /** REST only: the branch tip (the merged tip once merged); `None` when the branch is gone. */
1425
+ headSha?: string | null;
1426
+ merge?: PullMerge | null;
1427
+ number: number;
1428
+ /** The repository owner's handle. */
1429
+ owner: string;
1430
+ /** The pull request this one is stacked on; absent when it sits directly on a branch. */
1431
+ parent?: number | null;
1432
+ /** The repository's name. */
1433
+ repo: string;
1434
+ review: string;
1435
+ reviewer: string | null;
1436
+ state: string;
1437
+ title: string;
1438
+ /** REST only: the pull request's page. */
1439
+ url?: string | null;
1440
+ };
1441
+ /** Which of the caller's pull requests `pulls.mine` lists. */
1442
+ export type MyPullFilter = 'review-requested' | 'authored' | 'assigned' | 'involved';
1443
+ /** A page of the caller's pull requests across repositories. */
1444
+ export type MyPullPage = {
1445
+ /** Newest first. `headSha` is absent from open ones: the branch tips are not read across repositories. */
1446
+ items: MyPull[];
1447
+ /** Pass it as `cursor` for the next page; absent on the last. A page can hold fewer than `limit` items when private-branch rules hide some from the caller. */
1448
+ nextCursor: string | null;
1449
+ };
1357
1450
  export type NoContent = null;
1358
1451
  export type Opener = {
1359
1452
  key: string;
@@ -1592,6 +1685,31 @@ export type PullThread = {
1592
1685
  side?: DiffSide | null;
1593
1686
  startLine?: number | null;
1594
1687
  };
1688
+ /** A device the server pushes to. */
1689
+ export type PushDevice = {
1690
+ appVersion: string;
1691
+ bundleId: string;
1692
+ deviceId: string;
1693
+ environment: PushEnvironment;
1694
+ lastSeenAt: string;
1695
+ };
1696
+ /** Which APNs host a token belongs to: Xcode and TestFlight builds register `sandbox` tokens, App Store builds `production` ones. */
1697
+ export type PushEnvironment = 'sandbox' | 'production';
1698
+ /** Which events push to the person's devices. Quiet hours are the notification settings' own. */
1699
+ export type PushSettings = {
1700
+ /** Something is assigned to you. On by default. */
1701
+ assignments: boolean;
1702
+ /** Comments on issues and pull requests you follow. Off by default. */
1703
+ comments: boolean;
1704
+ /** Runs and pull requests you start show as Live Activities. On by default. */
1705
+ liveActivities: boolean;
1706
+ /** Someone mentions you. On by default. */
1707
+ mentions: boolean;
1708
+ /** Someone asks you to review a pull request. On by default. */
1709
+ reviewRequests: boolean;
1710
+ /** A run you started, or checks on your pull request, fail. On by default. */
1711
+ runFailures: boolean;
1712
+ };
1595
1713
  /** A group of queued pull requests tested together. */
1596
1714
  export type QueueBatch = {
1597
1715
  base: string;
@@ -2118,7 +2236,7 @@ export type SandboxUsage = {
2118
2236
  diskMb?: number | null;
2119
2237
  memoryMb: number;
2120
2238
  };
2121
- /** Why a queued sandbox has not started. The code is stable: `capacity` (no eligible host has the room now), `behind_reservation` (it would fit, but starts after a request ahead of it that holds the next room there), `bake_idle` (a bake starts only where nothing else waits), `policy` (the organization's or a host's rule refuses every host), `no_eligible_host` (the hosts online lack a label, architecture or image it needs) and `no_host_online` (none is online and taking new work: offline, cordoned or draining) and `repo_ci_cap` (a CI job of a repository already at the most CI jobs its owner lets it run at once). */
2239
+ /** Why a queued sandbox has not started. The code is stable: `capacity` (no eligible host has the room now), `behind_reservation` (it would fit, but starts after a request ahead of it that holds the next room there), `bake_idle` (a bake starts only where nothing else waits), `policy` (the organization's or a host's rule refuses every host), `no_eligible_host` (the hosts online lack a label, OS, architecture or image it needs) and `no_host_online` (none is online and taking new work: offline, cordoned or draining) and `repo_ci_cap` (a CI job of a repository already at the most CI jobs its owner lets it run at once). */
2122
2240
  export type SandboxWait = {
2123
2241
  code: string;
2124
2242
  message: string;
@@ -2851,12 +2969,16 @@ export type CaissonsTestInput = {
2851
2969
  id: string;
2852
2970
  /** The container image; the host's default. */
2853
2971
  image?: string | null;
2972
+ /** Host labels the sandbox needs: only a host carrying every one of them takes it. */
2973
+ labels?: string[];
2854
2974
  /** Memory for the sandbox, in MB. */
2855
2975
  memoryMb?: number | null;
2856
2976
  /** How long the sandbox may live, in minutes. */
2857
2977
  minutes?: number | null;
2858
2978
  /** The org or user the caisson is under. */
2859
2979
  org: string;
2980
+ /** The OS to run on: `linux` (the default) or `macos`, which only a macOS host takes. */
2981
+ os?: HostOs | null;
2860
2982
  /** How long the command may run, in seconds. */
2861
2983
  timeoutSeconds?: number | null;
2862
2984
  /** `inherit` gives the command `SAILFORK_TOKEN` and `SAILFORK_HOST`: a token limited to this repository that ends with the test's sandbox. */
@@ -3633,6 +3755,22 @@ export type IssuesMineInput = {
3633
3755
  q?: string | null;
3634
3756
  };
3635
3757
  export type IssuesMineOutput = MyIssues;
3758
+ /**
3759
+ * List the issues that need you or are yours across every repository you can read, newest first.
3760
+ */
3761
+ export type IssuesMinePageInput = {
3762
+ /** The `nextCursor` of the previous page. */
3763
+ cursor?: string | null;
3764
+ /** `assigned`, `created`, `mentioned` or `involved` (the default: any of the three). */
3765
+ filter?: MyIssueFilter | null;
3766
+ /** Items per page: 30 by default, at most 100. */
3767
+ limit?: number | null;
3768
+ /** Only this repository, as `owner/name`. */
3769
+ repo?: string | null;
3770
+ /** `open` (the default), `closed` or `all`. */
3771
+ state?: string | null;
3772
+ };
3773
+ export type IssuesMinePageOutput = MyIssuePage;
3636
3774
  /**
3637
3775
  * Get the most important ready issue: unblocked, not an epic, with no live lease, and unassigned or assigned to you. Answers 204 when none is ready. With `claim` it also takes a lease on it.
3638
3776
  */
@@ -3908,6 +4046,11 @@ export type LabelsUpdateOutput = Label;
3908
4046
  */
3909
4047
  export type MeAgentTrackingInput = Record<string, never>;
3910
4048
  export type MeAgentTrackingOutput = AgentTrackingState;
4049
+ /**
4050
+ * The signed-in account. Any token or session works, whatever its scopes.
4051
+ */
4052
+ export type MeGetInput = Record<string, never>;
4053
+ export type MeGetOutput = MeView;
3911
4054
  /**
3912
4055
  * Mark the welcome steps finished or skipped. The first time is kept.
3913
4056
  */
@@ -4340,6 +4483,20 @@ export type PullsMergeInput = {
4340
4483
  repo: string;
4341
4484
  };
4342
4485
  export type PullsMergeOutput = Pull;
4486
+ /**
4487
+ * List the pull requests that need you or are yours across every repository you can read, newest first.
4488
+ */
4489
+ export type PullsMineInput = {
4490
+ /** The `nextCursor` of the previous page. */
4491
+ cursor?: string | null;
4492
+ /** `review-requested`, `authored`, `assigned` or `involved` (the default: authored or assigned). */
4493
+ filter?: MyPullFilter | null;
4494
+ /** Items per page: 30 by default, at most 100. */
4495
+ limit?: number | null;
4496
+ /** `open` (the default), `draft`, `merged`, `closed` or `all`. */
4497
+ state?: string | null;
4498
+ };
4499
+ export type PullsMineOutput = MyPullPage;
4343
4500
  /**
4344
4501
  * Bring the base into a pull request's branch as one merge commit by the caller, with every conflict resolved. Needs push access to the branch.
4345
4502
  */
@@ -4457,6 +4614,72 @@ export type PullsUpdateBranchInput = {
4457
4614
  repo: string;
4458
4615
  };
4459
4616
  export type PullsUpdateBranchOutput = BranchUpdated;
4617
+ /**
4618
+ * Register the app's APNs device token for this device, or refresh it. The same `deviceId` again replaces the token, environment and versions; a token another device or account held before is released to this one.
4619
+ */
4620
+ export type PushDevicesRegisterInput = {
4621
+ /** The app's version, for support. At most 64 characters. */
4622
+ appVersion?: string | null;
4623
+ /** The app's bundle id, which is the APNs topic. Defaults to the server's `APNS_TOPIC`. */
4624
+ bundleId?: string | null;
4625
+ /** A stable id the app keeps for this installation, such as a UUID it stores in the keychain. At most 128 characters. */
4626
+ deviceId: string;
4627
+ environment: PushEnvironment;
4628
+ /** The APNs device token as lowercase or uppercase hex. */
4629
+ token: string;
4630
+ };
4631
+ export type PushDevicesRegisterOutput = PushDevice;
4632
+ /**
4633
+ * Stop pushing to a device, as the app does when the person signs out. A device that is not registered answers the same.
4634
+ */
4635
+ export type PushDevicesUnregisterInput = {
4636
+ /** The `deviceId` the device registered with. */
4637
+ id: string;
4638
+ };
4639
+ export type PushDevicesUnregisterOutput = NoContent;
4640
+ /**
4641
+ * Register a Live Activity token. A `push_to_start` token lets the server start an activity for a run or pull request you start; an `activity` token, with its `subject`, receives that activity's updates until it ends. The same token again replaces its subject and expiry.
4642
+ */
4643
+ export type PushLiveActivityTokensRegisterInput = {
4644
+ /** The app's bundle id. Defaults to the server's `APNS_TOPIC`. */
4645
+ bundleId?: string | null;
4646
+ /** The `deviceId` of the device that holds it. */
4647
+ deviceId?: string | null;
4648
+ environment: PushEnvironment;
4649
+ /** When the token stops working, an RFC 3339 time. Left out, it lives until it is removed or Apple rejects it. */
4650
+ expiresAt?: string | null;
4651
+ kind: LiveActivityTokenKind;
4652
+ /** Required for `activity`, refused for `push_to_start`: `run:<run id>` or `pull:<owner>/<repo>#<number>`, one you can read. */
4653
+ subject?: string | null;
4654
+ /** The token as hex. */
4655
+ token: string;
4656
+ };
4657
+ export type PushLiveActivityTokensRegisterOutput = LiveActivityToken;
4658
+ /**
4659
+ * Forget a Live Activity token, as the app does when its activity ends.
4660
+ */
4661
+ export type PushLiveActivityTokensRemoveInput = {
4662
+ /** The token, as registered. */
4663
+ token: string;
4664
+ };
4665
+ export type PushLiveActivityTokensRemoveOutput = NoContent;
4666
+ /**
4667
+ * What reaches your phone: the push switches, and whether runs show as Live Activities.
4668
+ */
4669
+ export type PushSettingsGetInput = Record<string, never>;
4670
+ export type PushSettingsGetOutput = PushSettings;
4671
+ /**
4672
+ * Turn push events and Live Activities on or off. Only the fields sent change.
4673
+ */
4674
+ export type PushSettingsUpdateInput = {
4675
+ assignments?: boolean | null;
4676
+ comments?: boolean | null;
4677
+ liveActivities?: boolean | null;
4678
+ mentions?: boolean | null;
4679
+ reviewRequests?: boolean | null;
4680
+ runFailures?: boolean | null;
4681
+ };
4682
+ export type PushSettingsUpdateOutput = PushSettings;
4460
4683
  /**
4461
4684
  * Show a commit: its message, author, parent and child, and its changes as a diff of the first files in path order.
4462
4685
  */
@@ -4569,7 +4792,7 @@ export type ReposUpdateInput = {
4569
4792
  };
4570
4793
  export type ReposUpdateOutput = RepoInfo;
4571
4794
  /**
4572
- * Start a sandbox: an isolated Linux container on one of the organization's Drydock hosts, for untrusted code, builds, tests or scripts. Answers 201 once it runs, or 202 with it `queued` when every host is full; follow `GET /api/sandboxes/{id}/events` or read it again until it runs.
4795
+ * Start a sandbox: an isolated Linux container (or, with `os` set to `macos`, a macOS VM) on one of the organization's Drydock hosts, for untrusted code, builds, tests or scripts. Answers 201 once it runs, or 202 with it `queued` when every host is full; follow `GET /api/sandboxes/{id}/events` or read it again until it runs.
4573
4796
  */
4574
4797
  export type SandboxesCreateInput = {
4575
4798
  /** `false` skips the host's dependency cache for the repository. */
@@ -4598,6 +4821,8 @@ export type SandboxesCreateInput = {
4598
4821
  network?: string | null;
4599
4822
  /** The organization's handle, or your own handle for a personal sandbox. */
4600
4823
  org: string;
4824
+ /** The OS the sandbox runs: `linux` (the default) or `macos`, which only a macOS host takes. */
4825
+ os?: HostOs | null;
4601
4826
  /** A branch, tag or commit of `repo`; the default branch when absent. */
4602
4827
  ref?: string | null;
4603
4828
  /** A repository as `owner/name` whose tree is put in `/work`; excludes `caisson`. */
@@ -1,2 +1,2 @@
1
- export declare const VERSION = "0.6.0";
1
+ export declare const VERSION = "0.6.2";
2
2
  export declare const API_VERSION = "2026-12-01";
@@ -367,6 +367,10 @@ export declare class IssuesResource {
367
367
  * Issues by title words, repository name or number across every repository you belong to, open first. Each word must appear in `owner/name` or the title; a number matches the issue's number.
368
368
  */
369
369
  mine(input?: T.IssuesMineInput, opts?: RequestOptions): Promise<T.IssuesMineOutput>;
370
+ /**
371
+ * List the issues that need you or are yours across every repository you can read, newest first.
372
+ */
373
+ minePage(input?: T.IssuesMinePageInput, opts?: RequestOptions): Promise<T.IssuesMinePageOutput>;
370
374
  /**
371
375
  * Get the most important ready issue: unblocked, not an epic, with no live lease, and unassigned or assigned to you. Answers 204 when none is ready. With `claim` it also takes a lease on it.
372
376
  *
@@ -457,6 +461,10 @@ export declare class MeResource {
457
461
  * Whether the account's agent work is tracked. Off, requests from the account's tokens, CLI and MCP ignore `X-Sailfork-Agent`, take no lease and read as the person.
458
462
  */
459
463
  agentTracking(input?: T.MeAgentTrackingInput, opts?: RequestOptions): Promise<T.MeAgentTrackingOutput>;
464
+ /**
465
+ * The signed-in account. Any token or session works, whatever its scopes.
466
+ */
467
+ get(input?: T.MeGetInput, opts?: RequestOptions): Promise<T.MeGetOutput>;
460
468
  /**
461
469
  * Mark the welcome steps finished or skipped. The first time is kept.
462
470
  */
@@ -591,6 +599,10 @@ export declare class PullsResource {
591
599
  * Resolves to `{ status: "held" }` when a person has to approve it first.
592
600
  */
593
601
  merge(input: T.PullsMergeInput, opts?: RequestOptions): Promise<Result<T.PullsMergeOutput>>;
602
+ /**
603
+ * List the pull requests that need you or are yours across every repository you can read, newest first.
604
+ */
605
+ mine(input?: T.PullsMineInput, opts?: RequestOptions): Promise<T.PullsMineOutput>;
594
606
  /**
595
607
  * Bring the base into a pull request's branch as one merge commit by the caller, with every conflict resolved. Needs push access to the branch.
596
608
  */
@@ -620,6 +632,34 @@ export declare class PullsResource {
620
632
  */
621
633
  updateBranch(input: T.PullsUpdateBranchInput, opts?: RequestOptions): Promise<T.PullsUpdateBranchOutput>;
622
634
  }
635
+ export declare class PushResource {
636
+ private readonly core;
637
+ constructor(core: Core);
638
+ /**
639
+ * Register the app's APNs device token for this device, or refresh it. The same `deviceId` again replaces the token, environment and versions; a token another device or account held before is released to this one.
640
+ */
641
+ devicesRegister(input: T.PushDevicesRegisterInput, opts?: RequestOptions): Promise<T.PushDevicesRegisterOutput>;
642
+ /**
643
+ * Stop pushing to a device, as the app does when the person signs out. A device that is not registered answers the same.
644
+ */
645
+ devicesUnregister(input: T.PushDevicesUnregisterInput, opts?: RequestOptions): Promise<T.PushDevicesUnregisterOutput>;
646
+ /**
647
+ * Register a Live Activity token. A `push_to_start` token lets the server start an activity for a run or pull request you start; an `activity` token, with its `subject`, receives that activity's updates until it ends. The same token again replaces its subject and expiry.
648
+ */
649
+ liveActivityTokensRegister(input: T.PushLiveActivityTokensRegisterInput, opts?: RequestOptions): Promise<T.PushLiveActivityTokensRegisterOutput>;
650
+ /**
651
+ * Forget a Live Activity token, as the app does when its activity ends.
652
+ */
653
+ liveActivityTokensRemove(input: T.PushLiveActivityTokensRemoveInput, opts?: RequestOptions): Promise<T.PushLiveActivityTokensRemoveOutput>;
654
+ /**
655
+ * What reaches your phone: the push switches, and whether runs show as Live Activities.
656
+ */
657
+ settingsGet(input?: T.PushSettingsGetInput, opts?: RequestOptions): Promise<T.PushSettingsGetOutput>;
658
+ /**
659
+ * Turn push events and Live Activities on or off. Only the fields sent change.
660
+ */
661
+ settingsUpdate(input?: T.PushSettingsUpdateInput, opts?: RequestOptions): Promise<T.PushSettingsUpdateOutput>;
662
+ }
623
663
  export declare class ReposResource {
624
664
  private readonly core;
625
665
  constructor(core: Core);
@@ -656,7 +696,7 @@ export declare class SandboxesResource {
656
696
  private readonly core;
657
697
  constructor(core: Core);
658
698
  /**
659
- * Start a sandbox: an isolated Linux container on one of the organization's Drydock hosts, for untrusted code, builds, tests or scripts. Answers 201 once it runs, or 202 with it `queued` when every host is full; follow `GET /api/sandboxes/{id}/events` or read it again until it runs.
699
+ * Start a sandbox: an isolated Linux container (or, with `os` set to `macos`, a macOS VM) on one of the organization's Drydock hosts, for untrusted code, builds, tests or scripts. Answers 201 once it runs, or 202 with it `queued` when every host is full; follow `GET /api/sandboxes/{id}/events` or read it again until it runs.
660
700
  */
661
701
  create(input: T.SandboxesCreateInput, opts?: RequestOptions): Promise<T.SandboxesCreateOutput>;
662
702
  /**
@@ -876,7 +916,7 @@ export declare class OrgSandboxesResource {
876
916
  private readonly bound;
877
917
  constructor(core: Core, bound: OrgBound);
878
918
  /**
879
- * Start a sandbox: an isolated Linux container on one of the organization's Drydock hosts, for untrusted code, builds, tests or scripts. Answers 201 once it runs, or 202 with it `queued` when every host is full; follow `GET /api/sandboxes/{id}/events` or read it again until it runs.
919
+ * Start a sandbox: an isolated Linux container (or, with `os` set to `macos`, a macOS VM) on one of the organization's Drydock hosts, for untrusted code, builds, tests or scripts. Answers 201 once it runs, or 202 with it `queued` when every host is full; follow `GET /api/sandboxes/{id}/events` or read it again until it runs.
880
920
  */
881
921
  create(input?: Omit<T.SandboxesCreateInput, 'org'>, opts?: RequestOptions): Promise<T.SandboxesCreateOutput>;
882
922
  /**
@@ -1369,6 +1409,7 @@ export type Resources = {
1369
1409
  milestones: MilestonesResource;
1370
1410
  notes: NotesResource;
1371
1411
  pulls: PullsResource;
1412
+ push: PushResource;
1372
1413
  repos: ReposResource;
1373
1414
  sandboxes: SandboxesResource;
1374
1415
  search: SearchResource;
@@ -2,4 +2,4 @@ export * from "./api.js";
2
2
  export { type OpId, ops } from "./ops.js";
3
3
  export * as tools from "./tools.js";
4
4
  export type * as types from "./types.js";
5
- export type { AffectedMode, AffectedStep, AgentTrackingState, Annotation, ApiError, Artifacts, AskKind, AskOptionInput, AutoMerge, BatchItem, BranchUpdated, CaissonAffected, CaissonAsk, CaissonAstMatch, CaissonAstMatches, CaissonBase, CaissonBashResult, CaissonBatchResult, CaissonChange, CaissonChangeRequest, CaissonChanged, CaissonCommitted, CaissonEdit, CaissonFileRead, CaissonFilesRead, CaissonGlob, CaissonGrep, CaissonGrepCount, CaissonGrepLine, CaissonGrepMatch, CaissonLocated, CaissonLspAnswer, CaissonLspPlace, CaissonLspProgress, CaissonLspQuestion, CaissonLspRenamed, CaissonLspStopped, CaissonPage, CaissonPolicy, CaissonPull, CaissonRefused, CaissonReview, CaissonReviewStatus, CaissonRow, CaissonShipped, CaissonTested, Check, CheckRun, CheckRunAction, CheckRunApp, CheckRunApp2, CheckRunBody, CheckRunBrief, CheckRunList, CheckRunOutput, CheckRunText, CheckSource, CheckState, CheckStep, ChecksState, Claim, CloneDefaults, CloneDefaultsEdit, CloseReason, CodeLine, CodeSnippet, CommentKind, CommentProof, CommitLog, CommitPage, CommitRecord, CommitView, CompareAnswer, CompareFiles, CompareView, ConflictFile, ConflictKind, ConflictResolution, ConflictSide, ConflictTake, ContextVisibility, CreatedIssue, Delegate, DelegateAsk, DelegateRequest, DeletionScheduled, DiffHunk, DiffLine, DiffSide, DiffTotals, EnvChain, EnvChainEntry, EnvDeviceRequest, EnvFile, EnvFileWrite, EnvFiles, EnvLog, EnvLogEntry, EnvPendingRemoval, EnvPerson, EnvRekeyFile, EnvRepo, EnvSigned, ErrorCode, ErrorLocation, Event, EventPage, EventSubscription, FailedStep, FileDiff, FileHit, FindingResolution, GithubInstallUrl, GithubInstallation, GithubRepo, GrepMode, Held, HeldDecided, HeldListing, HeldRequest, Hidden, HideReason, Inbox, InboxCounts, InboxItem, Issue, IssueAsk, IssueAskAnswer, IssueAskOption, IssueComment, IssueContext, IssueDetail, IssueEvent, IssuePage, IssuePriority, IssueStage, IssueStarted, IssueState, IssueStatus, ItemRef, KeyProof, Label, LabelItem, LabelList, MeUpdated, MergeMethod, Mergeable, Milestone, MilestoneItem, MilestoneList, MilestoneState, MyIssue, MyIssues, NoContent, Opener, PathHit, PathRule, Proof, ProofSource, Pull, PullChecks, PullComment, PullCommit, PullConflicts, PullDetail, PullDiff, PullFile, PullHunk, PullItems, PullLine, PullMerge, PullPage, PullPatchState, PullThread, QueueBatch, QueueDropped, QueueEntry, QueueStatus, Reaction, Reaction2, ReactionKind, RecoveryCodeList, RefHit, RefHit2, RefResults, RefResults2, RelatedItem, RelatedKind, RelatedLink, RelatedWork, RepoHit, RepoInfo, RepoNote, RepoNoteLimits, RepoNotes, ReviewChange, ReviewComment, ReviewFinding, ReviewFindingInput, ReviewPacket, ReviewRisk, ReviewSince, ReviewSinceFinding, Rollup, Run, RunArtifact, RunCancelled, RunEvent, RunFailures, RunId, RunJob, RunLogPage, RunLogs, RunStep, RunStepLog, RunTests, RunWait, Runs, Sandbox, SandboxBackground, SandboxCaisson, SandboxClass, SandboxExecResult, SandboxHostRef, SandboxIdle, SandboxKind, SandboxOrigin, SandboxPage, SandboxTokenMode, SandboxUsage, SandboxWait, SearchResults, SessionStep, SimilarIssue, SimilarIssues, SkippedWorkflow, SshKey, StackEntry, StopMode, SubIssue, Surface, SymbolHit, SymbolHit2, SymbolResults, SymbolResults2, TestFailure, Token, TokenCreated, TotpSetup, TouchingState, Verdict, Visibility, WaitAnswer, WaitTarget, WorkspaceUnread } from "./types.js";
5
+ export type { AffectedMode, AffectedStep, AgentTrackingState, Annotation, ApiError, Artifacts, AskKind, AskOptionInput, AutoMerge, BatchItem, BranchUpdated, CaissonAffected, CaissonAsk, CaissonAstMatch, CaissonAstMatches, CaissonBase, CaissonBashResult, CaissonBatchResult, CaissonChange, CaissonChangeRequest, CaissonChanged, CaissonCommitted, CaissonEdit, CaissonFileRead, CaissonFilesRead, CaissonGlob, CaissonGrep, CaissonGrepCount, CaissonGrepLine, CaissonGrepMatch, CaissonLocated, CaissonLspAnswer, CaissonLspPlace, CaissonLspProgress, CaissonLspQuestion, CaissonLspRenamed, CaissonLspStopped, CaissonPage, CaissonPolicy, CaissonPull, CaissonRefused, CaissonReview, CaissonReviewStatus, CaissonRow, CaissonShipped, CaissonTested, Check, CheckRun, CheckRunAction, CheckRunApp, CheckRunApp2, CheckRunBody, CheckRunBrief, CheckRunList, CheckRunOutput, CheckRunText, CheckSource, CheckState, CheckStep, ChecksState, Claim, CloneDefaults, CloneDefaultsEdit, CloseReason, CodeLine, CodeSnippet, CommentKind, CommentProof, CommitLog, CommitPage, CommitRecord, CommitView, CompareAnswer, CompareFiles, CompareView, ConflictFile, ConflictKind, ConflictResolution, ConflictSide, ConflictTake, ContextVisibility, CreatedIssue, Delegate, DelegateAsk, DelegateRequest, DeletionScheduled, DiffHunk, DiffLine, DiffSide, DiffTotals, EnvChain, EnvChainEntry, EnvDeviceRequest, EnvFile, EnvFileWrite, EnvFiles, EnvLog, EnvLogEntry, EnvPendingRemoval, EnvPerson, EnvRekeyFile, EnvRepo, EnvSigned, ErrorCode, ErrorLocation, Event, EventPage, EventSubscription, FailedStep, FileDiff, FileHit, FindingResolution, GithubInstallUrl, GithubInstallation, GithubRepo, GrepMode, Held, HeldDecided, HeldListing, HeldRequest, Hidden, HideReason, HostOs, Inbox, InboxCounts, InboxItem, Issue, IssueAsk, IssueAskAnswer, IssueAskOption, IssueComment, IssueContext, IssueDetail, IssueEvent, IssuePage, IssuePriority, IssueStage, IssueStarted, IssueState, IssueStatus, ItemRef, KeyProof, Label, LabelItem, LabelList, LiveActivityToken, LiveActivityTokenKind, MeUpdated, MeView, MergeMethod, Mergeable, Milestone, MilestoneItem, MilestoneList, MilestoneState, MyIssue, MyIssueFilter, MyIssuePage, MyIssuePageItem, MyIssues, MyPull, MyPullFilter, MyPullPage, NoContent, Opener, PathHit, PathRule, Proof, ProofSource, Pull, PullChecks, PullComment, PullCommit, PullConflicts, PullDetail, PullDiff, PullFile, PullHunk, PullItems, PullLine, PullMerge, PullPage, PullPatchState, PullThread, PushDevice, PushEnvironment, PushSettings, QueueBatch, QueueDropped, QueueEntry, QueueStatus, Reaction, Reaction2, ReactionKind, RecoveryCodeList, RefHit, RefHit2, RefResults, RefResults2, RelatedItem, RelatedKind, RelatedLink, RelatedWork, RepoHit, RepoInfo, RepoNote, RepoNoteLimits, RepoNotes, ReviewChange, ReviewComment, ReviewFinding, ReviewFindingInput, ReviewPacket, ReviewRisk, ReviewSince, ReviewSinceFinding, Rollup, Run, RunArtifact, RunCancelled, RunEvent, RunFailures, RunId, RunJob, RunLogPage, RunLogs, RunStep, RunStepLog, RunTests, RunWait, Runs, Sandbox, SandboxBackground, SandboxCaisson, SandboxClass, SandboxExecResult, SandboxHostRef, SandboxIdle, SandboxKind, SandboxOrigin, SandboxPage, SandboxTokenMode, SandboxUsage, SandboxWait, SearchResults, SessionStep, SimilarIssue, SimilarIssues, SkippedWorkflow, SshKey, StackEntry, StopMode, SubIssue, Surface, SymbolHit, SymbolHit2, SymbolResults, SymbolResults2, TestFailure, Token, TokenCreated, TotpSetup, TouchingState, Verdict, Visibility, WaitAnswer, WaitTarget, WorkspaceUnread } from "./types.js";