sailfork 0.6.1 → 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 +1 -1
- package/dist/index.cjs +3 -3
- package/dist/index.js +3 -3
- package/dist/tools.cjs +24 -4
- package/dist/tools.js +24 -4
- package/dist/types/core/version.d.ts +1 -1
- package/dist/types/generated/api.d.ts +2 -2
- package/dist/types/generated/index.d.ts +1 -1
- package/dist/types/generated/types.d.ts +10 -2
- package/dist/types-cjs/core/version.d.ts +1 -1
- package/dist/types-cjs/generated/api.d.ts +2 -2
- package/dist/types-cjs/generated/index.d.ts +1 -1
- package/dist/types-cjs/generated/types.d.ts +10 -2
- package/llms.txt +1 -1
- package/package.json +1 -1
package/AGENTS.md
CHANGED
|
@@ -235,7 +235,7 @@ const repo = sf.repo("acme/api");
|
|
|
235
235
|
|
|
236
236
|
### sandboxes
|
|
237
237
|
|
|
238
|
-
- `sf.sandboxes.create(input)`: 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. Scope `sandbox`, write, retry idempotent.
|
|
238
|
+
- `sf.sandboxes.create(input)`: 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. Scope `sandbox`, write, retry idempotent.
|
|
239
239
|
- `sf.sandboxes.delete(input)`: Destroy a sandbox now, kept files and checkpoints included. Scope `sandbox`, destructive, retry idempotent.
|
|
240
240
|
- `sf.sandboxes.exec(input)`: Run a command in a running sandbox and answer when it ends, with its output and exit code. Give `command` (run by `/bin/sh -c`) or `argv`. A request with `Accept: application/x-ndjson` is answered as a stream of output lines ending with the exit instead; the JSON below is the answer otherwise. Scope `sandbox`, write, retry idempotent.
|
|
241
241
|
- `sf.sandboxes.get(input)`: Show one sandbox. Scope `sandbox`, read, retry safe.
|
package/dist/index.cjs
CHANGED
|
@@ -607,7 +607,7 @@ async function resolveToken(host, option) {
|
|
|
607
607
|
}
|
|
608
608
|
|
|
609
609
|
// src/core/version.ts
|
|
610
|
-
var VERSION = "0.6.
|
|
610
|
+
var VERSION = "0.6.2";
|
|
611
611
|
var API_VERSION = "2026-12-01";
|
|
612
612
|
|
|
613
613
|
// src/core/client.ts
|
|
@@ -1337,7 +1337,7 @@ var ops = {
|
|
|
1337
1337
|
path: "/api/orgs/{org}/caissons/{id}/test",
|
|
1338
1338
|
pathParams: ["org", "id"],
|
|
1339
1339
|
queryParams: [],
|
|
1340
|
-
bodyParams: ["command", "argv", "image", "minutes", "vcpus", "memoryMb", "host", "env", "waitSeconds", "timeoutSeconds", "freshWorkspace", "token"],
|
|
1340
|
+
bodyParams: ["command", "argv", "image", "minutes", "vcpus", "memoryMb", "host", "labels", "os", "env", "waitSeconds", "timeoutSeconds", "freshWorkspace", "token"],
|
|
1341
1341
|
effect: "write",
|
|
1342
1342
|
retry: "idempotent",
|
|
1343
1343
|
held: false,
|
|
@@ -2936,7 +2936,7 @@ var ops = {
|
|
|
2936
2936
|
path: "/api/orgs/{org}/sandboxes",
|
|
2937
2937
|
pathParams: ["org"],
|
|
2938
2938
|
queryParams: [],
|
|
2939
|
-
bodyParams: ["image", "vcpus", "memoryMb", "diskGb", "network", "minutes", "host", "env", "repo", "ref", "sparse", "caisson", "waitSeconds", "cache", "labels", "stop", "keepPaths", "class", "freshWorkspace", "token"],
|
|
2939
|
+
bodyParams: ["image", "vcpus", "memoryMb", "diskGb", "network", "minutes", "host", "env", "repo", "ref", "sparse", "caisson", "waitSeconds", "cache", "labels", "os", "stop", "keepPaths", "class", "freshWorkspace", "token"],
|
|
2940
2940
|
effect: "write",
|
|
2941
2941
|
retry: "idempotent",
|
|
2942
2942
|
held: false,
|
package/dist/index.js
CHANGED
|
@@ -500,7 +500,7 @@ async function resolveToken(host, option) {
|
|
|
500
500
|
}
|
|
501
501
|
|
|
502
502
|
// src/core/version.ts
|
|
503
|
-
var VERSION = "0.6.
|
|
503
|
+
var VERSION = "0.6.2";
|
|
504
504
|
var API_VERSION = "2026-12-01";
|
|
505
505
|
|
|
506
506
|
// src/core/client.ts
|
|
@@ -1230,7 +1230,7 @@ var ops = {
|
|
|
1230
1230
|
path: "/api/orgs/{org}/caissons/{id}/test",
|
|
1231
1231
|
pathParams: ["org", "id"],
|
|
1232
1232
|
queryParams: [],
|
|
1233
|
-
bodyParams: ["command", "argv", "image", "minutes", "vcpus", "memoryMb", "host", "env", "waitSeconds", "timeoutSeconds", "freshWorkspace", "token"],
|
|
1233
|
+
bodyParams: ["command", "argv", "image", "minutes", "vcpus", "memoryMb", "host", "labels", "os", "env", "waitSeconds", "timeoutSeconds", "freshWorkspace", "token"],
|
|
1234
1234
|
effect: "write",
|
|
1235
1235
|
retry: "idempotent",
|
|
1236
1236
|
held: false,
|
|
@@ -2829,7 +2829,7 @@ var ops = {
|
|
|
2829
2829
|
path: "/api/orgs/{org}/sandboxes",
|
|
2830
2830
|
pathParams: ["org"],
|
|
2831
2831
|
queryParams: [],
|
|
2832
|
-
bodyParams: ["image", "vcpus", "memoryMb", "diskGb", "network", "minutes", "host", "env", "repo", "ref", "sparse", "caisson", "waitSeconds", "cache", "labels", "stop", "keepPaths", "class", "freshWorkspace", "token"],
|
|
2832
|
+
bodyParams: ["image", "vcpus", "memoryMb", "diskGb", "network", "minutes", "host", "env", "repo", "ref", "sparse", "caisson", "waitSeconds", "cache", "labels", "os", "stop", "keepPaths", "class", "freshWorkspace", "token"],
|
|
2833
2833
|
effect: "write",
|
|
2834
2834
|
retry: "idempotent",
|
|
2835
2835
|
held: false,
|
package/dist/tools.cjs
CHANGED
|
@@ -430,7 +430,7 @@ var ops = {
|
|
|
430
430
|
path: "/api/orgs/{org}/caissons/{id}/test",
|
|
431
431
|
pathParams: ["org", "id"],
|
|
432
432
|
queryParams: [],
|
|
433
|
-
bodyParams: ["command", "argv", "image", "minutes", "vcpus", "memoryMb", "host", "env", "waitSeconds", "timeoutSeconds", "freshWorkspace", "token"],
|
|
433
|
+
bodyParams: ["command", "argv", "image", "minutes", "vcpus", "memoryMb", "host", "labels", "os", "env", "waitSeconds", "timeoutSeconds", "freshWorkspace", "token"],
|
|
434
434
|
effect: "write",
|
|
435
435
|
retry: "idempotent",
|
|
436
436
|
held: false,
|
|
@@ -2029,7 +2029,7 @@ var ops = {
|
|
|
2029
2029
|
path: "/api/orgs/{org}/sandboxes",
|
|
2030
2030
|
pathParams: ["org"],
|
|
2031
2031
|
queryParams: [],
|
|
2032
|
-
bodyParams: ["image", "vcpus", "memoryMb", "diskGb", "network", "minutes", "host", "env", "repo", "ref", "sparse", "caisson", "waitSeconds", "cache", "labels", "stop", "keepPaths", "class", "freshWorkspace", "token"],
|
|
2032
|
+
bodyParams: ["image", "vcpus", "memoryMb", "diskGb", "network", "minutes", "host", "env", "repo", "ref", "sparse", "caisson", "waitSeconds", "cache", "labels", "os", "stop", "keepPaths", "class", "freshWorkspace", "token"],
|
|
2033
2033
|
effect: "write",
|
|
2034
2034
|
retry: "idempotent",
|
|
2035
2035
|
held: false,
|
|
@@ -8461,9 +8461,17 @@ credentials or instructions to other agents in one: credential-shaped text is re
|
|
|
8461
8461
|
{
|
|
8462
8462
|
name: "sandbox_create",
|
|
8463
8463
|
op: "sandboxes.create",
|
|
8464
|
-
description: "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.",
|
|
8464
|
+
description: "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.",
|
|
8465
8465
|
schema: {
|
|
8466
8466
|
$defs: {
|
|
8467
|
+
HostOs: {
|
|
8468
|
+
description: "The operating system a host's sandboxes run: the guest OS of a macOS VM sandbox, else Linux.",
|
|
8469
|
+
enum: [
|
|
8470
|
+
"linux",
|
|
8471
|
+
"macos"
|
|
8472
|
+
],
|
|
8473
|
+
type: "string"
|
|
8474
|
+
},
|
|
8467
8475
|
SandboxClass: {
|
|
8468
8476
|
description: "How a sandbox holds its room on a host.",
|
|
8469
8477
|
oneOf: [
|
|
@@ -8513,7 +8521,7 @@ the same gVisor release, else restores the files only. Open network connections
|
|
|
8513
8521
|
}
|
|
8514
8522
|
},
|
|
8515
8523
|
additionalProperties: false,
|
|
8516
|
-
description: "Start a sandbox: an isolated Linux container on one of the
|
|
8524
|
+
description: "Start a sandbox: an isolated Linux container (or, with `os` set to `macos`, a macOS VM) on one of the\norganization'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\n`GET /api/sandboxes/{id}/events` or read it again until it runs.",
|
|
8517
8525
|
properties: {
|
|
8518
8526
|
cache: {
|
|
8519
8527
|
description: "`false` skips the host's dependency cache for the repository.",
|
|
@@ -8619,6 +8627,17 @@ the same gVisor release, else restores the files only. Open network connections
|
|
|
8619
8627
|
description: "The organization's handle, or your own handle for a personal sandbox.",
|
|
8620
8628
|
type: "string"
|
|
8621
8629
|
},
|
|
8630
|
+
os: {
|
|
8631
|
+
anyOf: [
|
|
8632
|
+
{
|
|
8633
|
+
$ref: "#/$defs/HostOs"
|
|
8634
|
+
},
|
|
8635
|
+
{
|
|
8636
|
+
type: "null"
|
|
8637
|
+
}
|
|
8638
|
+
],
|
|
8639
|
+
description: "The OS the sandbox runs: `linux` (the default) or `macos`, which only a macOS host takes."
|
|
8640
|
+
},
|
|
8622
8641
|
ref: {
|
|
8623
8642
|
description: "A branch, tag or commit of `repo`; the default branch when absent.",
|
|
8624
8643
|
type: [
|
|
@@ -8701,6 +8720,7 @@ the same gVisor release, else restores the files only. Open network connections
|
|
|
8701
8720
|
minutes: "minutes",
|
|
8702
8721
|
network: "network",
|
|
8703
8722
|
org: "org",
|
|
8723
|
+
os: "os",
|
|
8704
8724
|
ref: "ref",
|
|
8705
8725
|
repo: "repo",
|
|
8706
8726
|
sparse: "sparse",
|
package/dist/tools.js
CHANGED
|
@@ -383,7 +383,7 @@ var ops = {
|
|
|
383
383
|
path: "/api/orgs/{org}/caissons/{id}/test",
|
|
384
384
|
pathParams: ["org", "id"],
|
|
385
385
|
queryParams: [],
|
|
386
|
-
bodyParams: ["command", "argv", "image", "minutes", "vcpus", "memoryMb", "host", "env", "waitSeconds", "timeoutSeconds", "freshWorkspace", "token"],
|
|
386
|
+
bodyParams: ["command", "argv", "image", "minutes", "vcpus", "memoryMb", "host", "labels", "os", "env", "waitSeconds", "timeoutSeconds", "freshWorkspace", "token"],
|
|
387
387
|
effect: "write",
|
|
388
388
|
retry: "idempotent",
|
|
389
389
|
held: false,
|
|
@@ -1982,7 +1982,7 @@ var ops = {
|
|
|
1982
1982
|
path: "/api/orgs/{org}/sandboxes",
|
|
1983
1983
|
pathParams: ["org"],
|
|
1984
1984
|
queryParams: [],
|
|
1985
|
-
bodyParams: ["image", "vcpus", "memoryMb", "diskGb", "network", "minutes", "host", "env", "repo", "ref", "sparse", "caisson", "waitSeconds", "cache", "labels", "stop", "keepPaths", "class", "freshWorkspace", "token"],
|
|
1985
|
+
bodyParams: ["image", "vcpus", "memoryMb", "diskGb", "network", "minutes", "host", "env", "repo", "ref", "sparse", "caisson", "waitSeconds", "cache", "labels", "os", "stop", "keepPaths", "class", "freshWorkspace", "token"],
|
|
1986
1986
|
effect: "write",
|
|
1987
1987
|
retry: "idempotent",
|
|
1988
1988
|
held: false,
|
|
@@ -8414,9 +8414,17 @@ credentials or instructions to other agents in one: credential-shaped text is re
|
|
|
8414
8414
|
{
|
|
8415
8415
|
name: "sandbox_create",
|
|
8416
8416
|
op: "sandboxes.create",
|
|
8417
|
-
description: "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.",
|
|
8417
|
+
description: "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.",
|
|
8418
8418
|
schema: {
|
|
8419
8419
|
$defs: {
|
|
8420
|
+
HostOs: {
|
|
8421
|
+
description: "The operating system a host's sandboxes run: the guest OS of a macOS VM sandbox, else Linux.",
|
|
8422
|
+
enum: [
|
|
8423
|
+
"linux",
|
|
8424
|
+
"macos"
|
|
8425
|
+
],
|
|
8426
|
+
type: "string"
|
|
8427
|
+
},
|
|
8420
8428
|
SandboxClass: {
|
|
8421
8429
|
description: "How a sandbox holds its room on a host.",
|
|
8422
8430
|
oneOf: [
|
|
@@ -8466,7 +8474,7 @@ the same gVisor release, else restores the files only. Open network connections
|
|
|
8466
8474
|
}
|
|
8467
8475
|
},
|
|
8468
8476
|
additionalProperties: false,
|
|
8469
|
-
description: "Start a sandbox: an isolated Linux container on one of the
|
|
8477
|
+
description: "Start a sandbox: an isolated Linux container (or, with `os` set to `macos`, a macOS VM) on one of the\norganization'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\n`GET /api/sandboxes/{id}/events` or read it again until it runs.",
|
|
8470
8478
|
properties: {
|
|
8471
8479
|
cache: {
|
|
8472
8480
|
description: "`false` skips the host's dependency cache for the repository.",
|
|
@@ -8572,6 +8580,17 @@ the same gVisor release, else restores the files only. Open network connections
|
|
|
8572
8580
|
description: "The organization's handle, or your own handle for a personal sandbox.",
|
|
8573
8581
|
type: "string"
|
|
8574
8582
|
},
|
|
8583
|
+
os: {
|
|
8584
|
+
anyOf: [
|
|
8585
|
+
{
|
|
8586
|
+
$ref: "#/$defs/HostOs"
|
|
8587
|
+
},
|
|
8588
|
+
{
|
|
8589
|
+
type: "null"
|
|
8590
|
+
}
|
|
8591
|
+
],
|
|
8592
|
+
description: "The OS the sandbox runs: `linux` (the default) or `macos`, which only a macOS host takes."
|
|
8593
|
+
},
|
|
8575
8594
|
ref: {
|
|
8576
8595
|
description: "A branch, tag or commit of `repo`; the default branch when absent.",
|
|
8577
8596
|
type: [
|
|
@@ -8654,6 +8673,7 @@ the same gVisor release, else restores the files only. Open network connections
|
|
|
8654
8673
|
minutes: "minutes",
|
|
8655
8674
|
network: "network",
|
|
8656
8675
|
org: "org",
|
|
8676
|
+
os: "os",
|
|
8657
8677
|
ref: "ref",
|
|
8658
8678
|
repo: "repo",
|
|
8659
8679
|
sparse: "sparse",
|
|
@@ -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";
|
|
@@ -696,7 +696,7 @@ export declare class SandboxesResource {
|
|
|
696
696
|
private readonly core;
|
|
697
697
|
constructor(core: Core);
|
|
698
698
|
/**
|
|
699
|
-
* 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.
|
|
700
700
|
*/
|
|
701
701
|
create(input: T.SandboxesCreateInput, opts?: RequestOptions): Promise<T.SandboxesCreateOutput>;
|
|
702
702
|
/**
|
|
@@ -916,7 +916,7 @@ export declare class OrgSandboxesResource {
|
|
|
916
916
|
private readonly bound;
|
|
917
917
|
constructor(core: Core, bound: OrgBound);
|
|
918
918
|
/**
|
|
919
|
-
* 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.
|
|
920
920
|
*/
|
|
921
921
|
create(input?: Omit<T.SandboxesCreateInput, 'org'>, opts?: RequestOptions): Promise<T.SandboxesCreateOutput>;
|
|
922
922
|
/**
|
|
@@ -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, 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";
|
|
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";
|
|
@@ -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;
|
|
@@ -2234,7 +2236,7 @@ export type SandboxUsage = {
|
|
|
2234
2236
|
diskMb?: number | null;
|
|
2235
2237
|
memoryMb: number;
|
|
2236
2238
|
};
|
|
2237
|
-
/** 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). */
|
|
2238
2240
|
export type SandboxWait = {
|
|
2239
2241
|
code: string;
|
|
2240
2242
|
message: string;
|
|
@@ -2967,12 +2969,16 @@ export type CaissonsTestInput = {
|
|
|
2967
2969
|
id: string;
|
|
2968
2970
|
/** The container image; the host's default. */
|
|
2969
2971
|
image?: string | null;
|
|
2972
|
+
/** Host labels the sandbox needs: only a host carrying every one of them takes it. */
|
|
2973
|
+
labels?: string[];
|
|
2970
2974
|
/** Memory for the sandbox, in MB. */
|
|
2971
2975
|
memoryMb?: number | null;
|
|
2972
2976
|
/** How long the sandbox may live, in minutes. */
|
|
2973
2977
|
minutes?: number | null;
|
|
2974
2978
|
/** The org or user the caisson is under. */
|
|
2975
2979
|
org: string;
|
|
2980
|
+
/** The OS to run on: `linux` (the default) or `macos`, which only a macOS host takes. */
|
|
2981
|
+
os?: HostOs | null;
|
|
2976
2982
|
/** How long the command may run, in seconds. */
|
|
2977
2983
|
timeoutSeconds?: number | null;
|
|
2978
2984
|
/** `inherit` gives the command `SAILFORK_TOKEN` and `SAILFORK_HOST`: a token limited to this repository that ends with the test's sandbox. */
|
|
@@ -4786,7 +4792,7 @@ export type ReposUpdateInput = {
|
|
|
4786
4792
|
};
|
|
4787
4793
|
export type ReposUpdateOutput = RepoInfo;
|
|
4788
4794
|
/**
|
|
4789
|
-
* 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.
|
|
4790
4796
|
*/
|
|
4791
4797
|
export type SandboxesCreateInput = {
|
|
4792
4798
|
/** `false` skips the host's dependency cache for the repository. */
|
|
@@ -4815,6 +4821,8 @@ export type SandboxesCreateInput = {
|
|
|
4815
4821
|
network?: string | null;
|
|
4816
4822
|
/** The organization's handle, or your own handle for a personal sandbox. */
|
|
4817
4823
|
org: string;
|
|
4824
|
+
/** The OS the sandbox runs: `linux` (the default) or `macos`, which only a macOS host takes. */
|
|
4825
|
+
os?: HostOs | null;
|
|
4818
4826
|
/** A branch, tag or commit of `repo`; the default branch when absent. */
|
|
4819
4827
|
ref?: string | null;
|
|
4820
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";
|
|
@@ -696,7 +696,7 @@ export declare class SandboxesResource {
|
|
|
696
696
|
private readonly core;
|
|
697
697
|
constructor(core: Core);
|
|
698
698
|
/**
|
|
699
|
-
* 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.
|
|
700
700
|
*/
|
|
701
701
|
create(input: T.SandboxesCreateInput, opts?: RequestOptions): Promise<T.SandboxesCreateOutput>;
|
|
702
702
|
/**
|
|
@@ -916,7 +916,7 @@ export declare class OrgSandboxesResource {
|
|
|
916
916
|
private readonly bound;
|
|
917
917
|
constructor(core: Core, bound: OrgBound);
|
|
918
918
|
/**
|
|
919
|
-
* 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.
|
|
920
920
|
*/
|
|
921
921
|
create(input?: Omit<T.SandboxesCreateInput, 'org'>, opts?: RequestOptions): Promise<T.SandboxesCreateOutput>;
|
|
922
922
|
/**
|
|
@@ -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, 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";
|
|
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";
|
|
@@ -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;
|
|
@@ -2234,7 +2236,7 @@ export type SandboxUsage = {
|
|
|
2234
2236
|
diskMb?: number | null;
|
|
2235
2237
|
memoryMb: number;
|
|
2236
2238
|
};
|
|
2237
|
-
/** 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). */
|
|
2238
2240
|
export type SandboxWait = {
|
|
2239
2241
|
code: string;
|
|
2240
2242
|
message: string;
|
|
@@ -2967,12 +2969,16 @@ export type CaissonsTestInput = {
|
|
|
2967
2969
|
id: string;
|
|
2968
2970
|
/** The container image; the host's default. */
|
|
2969
2971
|
image?: string | null;
|
|
2972
|
+
/** Host labels the sandbox needs: only a host carrying every one of them takes it. */
|
|
2973
|
+
labels?: string[];
|
|
2970
2974
|
/** Memory for the sandbox, in MB. */
|
|
2971
2975
|
memoryMb?: number | null;
|
|
2972
2976
|
/** How long the sandbox may live, in minutes. */
|
|
2973
2977
|
minutes?: number | null;
|
|
2974
2978
|
/** The org or user the caisson is under. */
|
|
2975
2979
|
org: string;
|
|
2980
|
+
/** The OS to run on: `linux` (the default) or `macos`, which only a macOS host takes. */
|
|
2981
|
+
os?: HostOs | null;
|
|
2976
2982
|
/** How long the command may run, in seconds. */
|
|
2977
2983
|
timeoutSeconds?: number | null;
|
|
2978
2984
|
/** `inherit` gives the command `SAILFORK_TOKEN` and `SAILFORK_HOST`: a token limited to this repository that ends with the test's sandbox. */
|
|
@@ -4786,7 +4792,7 @@ export type ReposUpdateInput = {
|
|
|
4786
4792
|
};
|
|
4787
4793
|
export type ReposUpdateOutput = RepoInfo;
|
|
4788
4794
|
/**
|
|
4789
|
-
* 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.
|
|
4790
4796
|
*/
|
|
4791
4797
|
export type SandboxesCreateInput = {
|
|
4792
4798
|
/** `false` skips the host's dependency cache for the repository. */
|
|
@@ -4815,6 +4821,8 @@ export type SandboxesCreateInput = {
|
|
|
4815
4821
|
network?: string | null;
|
|
4816
4822
|
/** The organization's handle, or your own handle for a personal sandbox. */
|
|
4817
4823
|
org: string;
|
|
4824
|
+
/** The OS the sandbox runs: `linux` (the default) or `macos`, which only a macOS host takes. */
|
|
4825
|
+
os?: HostOs | null;
|
|
4818
4826
|
/** A branch, tag or commit of `repo`; the default branch when absent. */
|
|
4819
4827
|
ref?: string | null;
|
|
4820
4828
|
/** A repository as `owner/name` whose tree is put in `/work`; excludes `caisson`. */
|
package/llms.txt
CHANGED
|
@@ -218,7 +218,7 @@
|
|
|
218
218
|
|
|
219
219
|
## sandboxes
|
|
220
220
|
|
|
221
|
-
- `sf.sandboxes.create(input)`: 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.
|
|
221
|
+
- `sf.sandboxes.create(input)`: 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.
|
|
222
222
|
- `sf.sandboxes.delete(input)`: Destroy a sandbox now, kept files and checkpoints included.
|
|
223
223
|
- `sf.sandboxes.exec(input)`: Run a command in a running sandbox and answer when it ends, with its output and exit code. Give `command` (run by `/bin/sh -c`) or `argv`. A request with `Accept: application/x-ndjson` is answered as a stream of output lines ending with the exit instead; the JSON below is the answer otherwise.
|
|
224
224
|
- `sf.sandboxes.get(input)`: Show one sandbox.
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "sailfork",
|
|
3
|
-
"version": "0.6.
|
|
3
|
+
"version": "0.6.2",
|
|
4
4
|
"description": "Official TypeScript SDK for Sailfork, git hosting built for AI coding agents: a typed API client for repositories, pull requests, code review, issues, CI and sandboxes, with Anthropic and OpenAI tool definitions.",
|
|
5
5
|
"keywords": [
|
|
6
6
|
"sailfork",
|