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.
- package/AGENTS.md +13 -1
- package/dist/index.cjs +156 -3
- package/dist/index.js +156 -3
- package/dist/tools.cjs +141 -4
- package/dist/tools.js +141 -4
- package/dist/types/core/version.d.ts +1 -1
- package/dist/types/generated/api.d.ts +43 -2
- package/dist/types/generated/index.d.ts +1 -1
- package/dist/types/generated/ops.d.ts +117 -0
- package/dist/types/generated/types.d.ts +227 -2
- package/dist/types-cjs/core/version.d.ts +1 -1
- package/dist/types-cjs/generated/api.d.ts +43 -2
- package/dist/types-cjs/generated/index.d.ts +1 -1
- package/dist/types-cjs/generated/ops.d.ts +117 -0
- package/dist/types-cjs/generated/types.d.ts +227 -2
- package/llms.txt +13 -1
- package/package.json +1 -1
|
@@ -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.
|
|
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";
|