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 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.1";
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.1";
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 organization's Drydock hosts, for untrusted code,\nbuilds, 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.",
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 organization's Drydock hosts, for untrusted code,\nbuilds, 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.",
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";
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";
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.1",
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",