@dagger.io/core 1.0.0-beta.25.2 → 1.0.0-beta.28

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.
@@ -632,9 +632,9 @@ export function FileTypeNameToValue(name) {
632
632
  */
633
633
  export var FunctionCachePolicy;
634
634
  (function (FunctionCachePolicy) {
635
- FunctionCachePolicy["Default"] = "Default";
636
- FunctionCachePolicy["Never"] = "Never";
637
- FunctionCachePolicy["PerSession"] = "PerSession";
635
+ FunctionCachePolicy["Default"] = "DEFAULT";
636
+ FunctionCachePolicy["Never"] = "NEVER";
637
+ FunctionCachePolicy["PerSession"] = "PER_SESSION";
638
638
  })(FunctionCachePolicy || (FunctionCachePolicy = {}));
639
639
  /**
640
640
  * Utility function to convert a FunctionCachePolicy value to its name so
@@ -643,11 +643,11 @@ export var FunctionCachePolicy;
643
643
  export function FunctionCachePolicyValueToName(value) {
644
644
  switch (value) {
645
645
  case FunctionCachePolicy.Default:
646
- return "Default";
646
+ return "DEFAULT";
647
647
  case FunctionCachePolicy.Never:
648
- return "Never";
648
+ return "NEVER";
649
649
  case FunctionCachePolicy.PerSession:
650
- return "PerSession";
650
+ return "PER_SESSION";
651
651
  default:
652
652
  return value;
653
653
  }
@@ -658,11 +658,11 @@ export function FunctionCachePolicyValueToName(value) {
658
658
  */
659
659
  export function FunctionCachePolicyNameToValue(name) {
660
660
  switch (name) {
661
- case "Default":
661
+ case "DEFAULT":
662
662
  return FunctionCachePolicy.Default;
663
- case "Never":
663
+ case "NEVER":
664
664
  return FunctionCachePolicy.Never;
665
- case "PerSession":
665
+ case "PER_SESSION":
666
666
  return FunctionCachePolicy.PerSession;
667
667
  default:
668
668
  return name;
@@ -781,11 +781,10 @@ export function IdentifierWordKindNameToValue(name) {
781
781
  */
782
782
  export var ImageLayerCompression;
783
783
  (function (ImageLayerCompression) {
784
- ImageLayerCompression["EStarGz"] = "EStarGZ";
785
- ImageLayerCompression["Estargz"] = "EStarGZ";
786
- ImageLayerCompression["Gzip"] = "Gzip";
787
- ImageLayerCompression["Uncompressed"] = "Uncompressed";
788
- ImageLayerCompression["Zstd"] = "Zstd";
784
+ ImageLayerCompression["Estargz"] = "ESTARGZ";
785
+ ImageLayerCompression["Gzip"] = "GZIP";
786
+ ImageLayerCompression["Uncompressed"] = "UNCOMPRESSED";
787
+ ImageLayerCompression["Zstd"] = "ZSTD";
789
788
  })(ImageLayerCompression || (ImageLayerCompression = {}));
790
789
  /**
791
790
  * Utility function to convert a ImageLayerCompression value to its name so
@@ -793,14 +792,14 @@ export var ImageLayerCompression;
793
792
  */
794
793
  export function ImageLayerCompressionValueToName(value) {
795
794
  switch (value) {
796
- case ImageLayerCompression.EStarGz:
797
- return "EStarGZ";
795
+ case ImageLayerCompression.Estargz:
796
+ return "ESTARGZ";
798
797
  case ImageLayerCompression.Gzip:
799
- return "Gzip";
798
+ return "GZIP";
800
799
  case ImageLayerCompression.Uncompressed:
801
- return "Uncompressed";
800
+ return "UNCOMPRESSED";
802
801
  case ImageLayerCompression.Zstd:
803
- return "Zstd";
802
+ return "ZSTD";
804
803
  default:
805
804
  return value;
806
805
  }
@@ -811,13 +810,13 @@ export function ImageLayerCompressionValueToName(value) {
811
810
  */
812
811
  export function ImageLayerCompressionNameToValue(name) {
813
812
  switch (name) {
814
- case "EStarGZ":
815
- return ImageLayerCompression.EStarGz;
816
- case "Gzip":
813
+ case "ESTARGZ":
814
+ return ImageLayerCompression.Estargz;
815
+ case "GZIP":
817
816
  return ImageLayerCompression.Gzip;
818
- case "Uncompressed":
817
+ case "UNCOMPRESSED":
819
818
  return ImageLayerCompression.Uncompressed;
820
- case "Zstd":
819
+ case "ZSTD":
821
820
  return ImageLayerCompression.Zstd;
822
821
  default:
823
822
  return name;
@@ -828,10 +827,8 @@ export function ImageLayerCompressionNameToValue(name) {
828
827
  */
829
828
  export var ImageMediaTypes;
830
829
  (function (ImageMediaTypes) {
831
- ImageMediaTypes["Docker"] = "DockerMediaTypes";
832
- ImageMediaTypes["DockerMediaTypes"] = "DockerMediaTypes";
833
- ImageMediaTypes["Oci"] = "OCIMediaTypes";
834
- ImageMediaTypes["OciMediaTypes"] = "OCIMediaTypes";
830
+ ImageMediaTypes["Docker"] = "DOCKER";
831
+ ImageMediaTypes["Oci"] = "OCI";
835
832
  })(ImageMediaTypes || (ImageMediaTypes = {}));
836
833
  /**
837
834
  * Utility function to convert a ImageMediaTypes value to its name so
@@ -2959,14 +2956,14 @@ export class ClientFilesyncMirror extends BaseClient {
2959
2956
  */
2960
2957
  export class Cloud extends BaseClient {
2961
2958
  _id = undefined;
2962
- _traceURL = undefined;
2959
+ _traceUrl = undefined;
2963
2960
  /**
2964
2961
  * Constructor is used for internal usage only, do not create object from it.
2965
2962
  */
2966
- constructor(ctx, _id, _traceURL) {
2963
+ constructor(ctx, _id, _traceUrl) {
2967
2964
  super(ctx);
2968
2965
  this._id = _id;
2969
- this._traceURL = _traceURL;
2966
+ this._traceUrl = _traceUrl;
2970
2967
  }
2971
2968
  /**
2972
2969
  * A unique identifier for this Cloud.
@@ -2982,11 +2979,11 @@ export class Cloud extends BaseClient {
2982
2979
  /**
2983
2980
  * The trace URL for the current session
2984
2981
  */
2985
- traceURL = async () => {
2986
- if (this._traceURL) {
2987
- return this._traceURL;
2982
+ traceUrl = async () => {
2983
+ if (this._traceUrl) {
2984
+ return this._traceUrl;
2988
2985
  }
2989
- const ctx = this._ctx.select("traceURL");
2986
+ const ctx = this._ctx.select("traceUrl");
2990
2987
  const response = await ctx.execute();
2991
2988
  return response;
2992
2989
  };
@@ -3271,6 +3268,7 @@ export class Container extends BaseClient {
3271
3268
  * Mounts are included.
3272
3269
  * @param path The path of the directory to retrieve (e.g., "./src").
3273
3270
  * @param opts.expand Replace "${VAR}" or "$VAR" in the value of path according to the current environment variables defined in the container (e.g. "/$VAR/foo").
3271
+ * @param opts.resolveBrokenSymlinks Repair symlinks that directory selection would break. Resolve targets across the root filesystem and directory or file mounts. Preserve working relative links and links that already have no target. Cache, volume, tmpfs, secret, and socket mounts cause an error if selection, a resolved link, or mount target resolution needs their contents.
3274
3272
  */
3275
3273
  directory = (path, opts) => {
3276
3274
  const ctx = this._ctx.select("directory", { path, ...opts });
@@ -3350,10 +3348,10 @@ export class Container extends BaseClient {
3350
3348
  * Configures all available GPUs on the host to be accessible to this container.
3351
3349
  *
3352
3350
  * This currently works for Nvidia devices only.
3353
- * @deprecated Use "withGPU" instead.
3351
+ * @deprecated Use "withGpu" instead.
3354
3352
  */
3355
- experimentalWithAllGPUs = () => {
3356
- const ctx = this._ctx.select("experimentalWithAllGPUs");
3353
+ experimentalWithAllGpus = () => {
3354
+ const ctx = this._ctx.select("experimentalWithAllGpus");
3357
3355
  return new Container(ctx);
3358
3356
  };
3359
3357
  /**
@@ -3361,10 +3359,10 @@ export class Container extends BaseClient {
3361
3359
  *
3362
3360
  * This currently works for Nvidia devices only.
3363
3361
  * @param devices List of devices to be accessible to this container.
3364
- * @deprecated Use "withGPU" instead, which exposes all GPUs available on the host.
3362
+ * @deprecated Use "withGpu" instead, which exposes all GPUs available on the host.
3365
3363
  */
3366
- experimentalWithGPU = (devices) => {
3367
- const ctx = this._ctx.select("experimentalWithGPU", { devices });
3364
+ experimentalWithGpu = (devices) => {
3365
+ const ctx = this._ctx.select("experimentalWithGpu", { devices });
3368
3366
  return new Container(ctx);
3369
3367
  };
3370
3368
  /**
@@ -3460,7 +3458,7 @@ export class Container extends BaseClient {
3460
3458
  * @param opts.protocol Protocol to use for registry communication.
3461
3459
  *
3462
3460
  * Defaults to "HTTPS". Use "HTTP" only for plain HTTP registries.
3463
- * @param opts.insecureSkipTLSVerify Allow HTTPS registry communication without verifying the server certificate.
3461
+ * @param opts.insecureSkipTlsVerify Allow HTTPS registry communication without verifying the server certificate.
3464
3462
  * @param opts.noLock Ignore the workspace lockfile for this lookup.
3465
3463
  */
3466
3464
  from = (address, opts) => {
@@ -3582,7 +3580,7 @@ export class Container extends BaseClient {
3582
3580
  * @param opts.protocol Protocol to use for registry communication.
3583
3581
  *
3584
3582
  * Defaults to "HTTPS". Use "HTTP" only for plain HTTP registries.
3585
- * @param opts.insecureSkipTLSVerify Allow HTTPS registry communication without verifying the server certificate.
3583
+ * @param opts.insecureSkipTlsVerify Allow HTTPS registry communication without verifying the server certificate.
3586
3584
  * @param opts.sourceDateEpoch Clamp the image's timestamps to this time, so that rebuilding unchanged files produces identical layers.
3587
3585
  *
3588
3586
  * Formatted in seconds following Unix epoch (e.g., 1672531199). File timestamps in every layer and the image's creation times that are later than this are set to it, as with BuildKit's rewrite-timestamp and SOURCE_DATE_EPOCH. Every layer is rewritten, so this costs time on each export.
@@ -3910,8 +3908,8 @@ export class Container extends BaseClient {
3910
3908
  *
3911
3909
  * This currently works with NVIDIA devices only, and requires the engine to run with GPU support enabled.
3912
3910
  */
3913
- withGPU = () => {
3914
- const ctx = this._ctx.select("withGPU");
3911
+ withGpu = () => {
3912
+ const ctx = this._ctx.select("withGpu");
3915
3913
  return new Container(ctx);
3916
3914
  };
3917
3915
  /**
@@ -4396,6 +4394,16 @@ export class CurrentModule extends BaseClient {
4396
4394
  const response = await ctx.execute();
4397
4395
  return response;
4398
4396
  };
4397
+ /**
4398
+ * The names the engine gives this module's own declarations: the same as its source's ModuleSource.naming, for module runtimes, which have no ModuleSource.
4399
+ *
4400
+ * It answers for the module under its own name (ModuleSource.moduleName), by the naming rules of the version the module is named by. A workspace or toolchain that loads the module under another name namespaces its types under that name instead, which this doesn't reflect.
4401
+ * @experimental
4402
+ */
4403
+ naming = () => {
4404
+ const ctx = this._ctx.select("naming");
4405
+ return new ModuleNaming(ctx);
4406
+ };
4399
4407
  /**
4400
4408
  * The directory containing the module's source code loaded into the engine (plus any generated code that may have been created).
4401
4409
  */
@@ -4635,9 +4643,10 @@ export class Directory extends BaseClient {
4635
4643
  /**
4636
4644
  * Retrieves a directory at the given path.
4637
4645
  * @param path Location of the directory to retrieve. Example: "/src"
4646
+ * @param opts.resolveBrokenSymlinks Repair symlinks that directory selection would break. Copy targets from this directory into the result. Preserve working relative links and links that already have no target.
4638
4647
  */
4639
- directory = (path) => {
4640
- const ctx = this._ctx.select("directory", { path });
4648
+ directory = (path, opts) => {
4649
+ const ctx = this._ctx.select("directory", { path, ...opts });
4641
4650
  return new Directory(ctx);
4642
4651
  };
4643
4652
  /**
@@ -4909,6 +4918,18 @@ export class Directory extends BaseClient {
4909
4918
  const ctx = this._ctx.select("withPatchFile", { patch, ...opts, __metadata: metadata });
4910
4919
  return new Directory(ctx);
4911
4920
  };
4921
+ /**
4922
+ * Retrieves this directory, declared as made for the given platform.
4923
+ *
4924
+ * Declare a result whose contents are the same whichever platform made them, such as a Go package compiled for a platform by any platform's Go toolchain. An engine of another platform that makes the same directory for the same platform then finds this one, and the other way around.
4925
+ *
4926
+ * The contents are not checked: a declared result that depends on the platform it was made on can be found where it doesn't belong.
4927
+ * @param platform The platform the directory's contents are for (e.g., "linux/arm64").
4928
+ */
4929
+ withPlatform = (platform) => {
4930
+ const ctx = this._ctx.select("withPlatform", { platform });
4931
+ return new Directory(ctx);
4932
+ };
4912
4933
  /**
4913
4934
  * Return a snapshot with a symlink
4914
4935
  * @param target Location of the file or directory to link to (e.g., "/existing/file").
@@ -5968,8 +5989,8 @@ export class File extends BaseClient {
5968
5989
  /**
5969
5990
  * Parse the file contents as JSON.
5970
5991
  */
5971
- asJSON = () => {
5972
- const ctx = this._ctx.select("asJSON");
5992
+ asJson = () => {
5993
+ const ctx = this._ctx.select("asJson");
5973
5994
  return new JSONValue(ctx);
5974
5995
  };
5975
5996
  /**
@@ -6096,9 +6117,10 @@ export class File extends BaseClient {
6096
6117
  };
6097
6118
  /**
6098
6119
  * Force evaluation in the engine.
6120
+ * @param opts.keyByContent Also key the file by its content, so that what consumes it is cached across any two recipes that produce the same file. This hashes the file unless it already has a content key.
6099
6121
  */
6100
- sync = async () => {
6101
- const ctx = this._ctx.select("sync");
6122
+ sync = async (opts) => {
6123
+ const ctx = this._ctx.select("sync", { ...opts });
6102
6124
  const response = await ctx.execute();
6103
6125
  return new File(ctx.copy().selectNode(response, "File"));
6104
6126
  };
@@ -6666,15 +6688,15 @@ export class GeneratedCode extends BaseClient {
6666
6688
  /**
6667
6689
  * Set the list of paths to mark generated in version control.
6668
6690
  */
6669
- withVCSGeneratedPaths = (paths) => {
6670
- const ctx = this._ctx.select("withVCSGeneratedPaths", { paths });
6691
+ withVcsGeneratedPaths = (paths) => {
6692
+ const ctx = this._ctx.select("withVcsGeneratedPaths", { paths });
6671
6693
  return new GeneratedCode(ctx);
6672
6694
  };
6673
6695
  /**
6674
6696
  * Set the list of paths to ignore in version control.
6675
6697
  */
6676
- withVCSIgnoredPaths = (paths) => {
6677
- const ctx = this._ctx.select("withVCSIgnoredPaths", { paths });
6698
+ withVcsIgnoredPaths = (paths) => {
6699
+ const ctx = this._ctx.select("withVcsIgnoredPaths", { paths });
6678
6700
  return new GeneratedCode(ctx);
6679
6701
  };
6680
6702
  /**
@@ -6787,8 +6809,8 @@ export class GitBundle extends BaseClient {
6787
6809
  /**
6788
6810
  * Commits that must already exist wherever this bundle is applied.
6789
6811
  */
6790
- prerequisiteSHAs = async () => {
6791
- const ctx = this._ctx.select("prerequisiteSHAs");
6812
+ prerequisiteShas = async () => {
6813
+ const ctx = this._ctx.select("prerequisiteShas");
6792
6814
  const response = await ctx.execute();
6793
6815
  return response;
6794
6816
  };
@@ -6893,11 +6915,11 @@ export class GitCommit extends BaseClient {
6893
6915
  _messageHeadline = undefined;
6894
6916
  _sha = undefined;
6895
6917
  _shortSha = undefined;
6896
- _treeSHA = undefined;
6918
+ _treeSha = undefined;
6897
6919
  /**
6898
6920
  * Constructor is used for internal usage only, do not create object from it.
6899
6921
  */
6900
- constructor(ctx, _id, _authorEmail, _authorName, _authoredDate, _committedDate, _committerEmail, _committerName, _message, _messageBody, _messageHeadline, _sha, _shortSha, _treeSHA) {
6922
+ constructor(ctx, _id, _authorEmail, _authorName, _authoredDate, _committedDate, _committerEmail, _committerName, _message, _messageBody, _messageHeadline, _sha, _shortSha, _treeSha) {
6901
6923
  super(ctx);
6902
6924
  this._id = _id;
6903
6925
  this._authorEmail = _authorEmail;
@@ -6911,7 +6933,7 @@ export class GitCommit extends BaseClient {
6911
6933
  this._messageHeadline = _messageHeadline;
6912
6934
  this._sha = _sha;
6913
6935
  this._shortSha = _shortSha;
6914
- this._treeSHA = _treeSHA;
6936
+ this._treeSha = _treeSha;
6915
6937
  }
6916
6938
  /**
6917
6939
  * A unique identifier for this GitCommit.
@@ -7102,11 +7124,11 @@ export class GitCommit extends BaseClient {
7102
7124
  *
7103
7125
  * Commits with identical trees have identical contents and file modes.
7104
7126
  */
7105
- treeSHA = async () => {
7106
- if (this._treeSHA) {
7107
- return this._treeSHA;
7127
+ treeSha = async () => {
7128
+ if (this._treeSha) {
7129
+ return this._treeSha;
7108
7130
  }
7109
- const ctx = this._ctx.select("treeSHA");
7131
+ const ctx = this._ctx.select("treeSha");
7110
7132
  const response = await ctx.execute();
7111
7133
  return response;
7112
7134
  };
@@ -7117,17 +7139,17 @@ export class GitCommit extends BaseClient {
7117
7139
  export class GitPushResult extends BaseClient {
7118
7140
  _id = undefined;
7119
7141
  _disposition = undefined;
7120
- _previousSHA = undefined;
7142
+ _previousSha = undefined;
7121
7143
  _ref = undefined;
7122
7144
  _sha = undefined;
7123
7145
  /**
7124
7146
  * Constructor is used for internal usage only, do not create object from it.
7125
7147
  */
7126
- constructor(ctx, _id, _disposition, _previousSHA, _ref, _sha) {
7148
+ constructor(ctx, _id, _disposition, _previousSha, _ref, _sha) {
7127
7149
  super(ctx);
7128
7150
  this._id = _id;
7129
7151
  this._disposition = _disposition;
7130
- this._previousSHA = _previousSHA;
7152
+ this._previousSha = _previousSha;
7131
7153
  this._ref = _ref;
7132
7154
  this._sha = _sha;
7133
7155
  }
@@ -7156,11 +7178,11 @@ export class GitPushResult extends BaseClient {
7156
7178
  /**
7157
7179
  * The previous remote object ID; empty when the ref was created.
7158
7180
  */
7159
- previousSHA = async () => {
7160
- if (this._previousSHA) {
7161
- return this._previousSHA;
7181
+ previousSha = async () => {
7182
+ if (this._previousSha) {
7183
+ return this._previousSha;
7162
7184
  }
7163
- const ctx = this._ctx.select("previousSHA");
7185
+ const ctx = this._ctx.select("previousSha");
7164
7186
  const response = await ctx.execute();
7165
7187
  return response;
7166
7188
  };
@@ -7193,18 +7215,18 @@ export class GitPushResult extends BaseClient {
7193
7215
  export class GitRef extends BaseClient {
7194
7216
  _id = undefined;
7195
7217
  _commit = undefined;
7196
- _commitSHA = undefined;
7218
+ _commitSha = undefined;
7197
7219
  _contains = undefined;
7198
7220
  _name = undefined;
7199
7221
  _ref = undefined;
7200
7222
  /**
7201
7223
  * Constructor is used for internal usage only, do not create object from it.
7202
7224
  */
7203
- constructor(ctx, _id, _commit, _commitSHA, _contains, _name, _ref) {
7225
+ constructor(ctx, _id, _commit, _commitSha, _contains, _name, _ref) {
7204
7226
  super(ctx);
7205
7227
  this._id = _id;
7206
7228
  this._commit = _commit;
7207
- this._commitSHA = _commitSHA;
7229
+ this._commitSha = _commitSha;
7208
7230
  this._contains = _contains;
7209
7231
  this._name = _name;
7210
7232
  this._ref = _ref;
@@ -7239,7 +7261,7 @@ export class GitRef extends BaseClient {
7239
7261
  };
7240
7262
  /**
7241
7263
  * The resolved commit id at this ref.
7242
- * @deprecated Use "commitSHA" instead.
7264
+ * @deprecated Use "commitSha" instead.
7243
7265
  */
7244
7266
  commit = async () => {
7245
7267
  if (this._commit) {
@@ -7252,11 +7274,11 @@ export class GitRef extends BaseClient {
7252
7274
  /**
7253
7275
  * The resolved commit SHA at this ref.
7254
7276
  */
7255
- commitSHA = async () => {
7256
- if (this._commitSHA) {
7257
- return this._commitSHA;
7277
+ commitSha = async () => {
7278
+ if (this._commitSha) {
7279
+ return this._commitSha;
7258
7280
  }
7259
- const ctx = this._ctx.select("commitSHA");
7281
+ const ctx = this._ctx.select("commitSha");
7260
7282
  const response = await ctx.execute();
7261
7283
  return response;
7262
7284
  };
@@ -7313,7 +7335,7 @@ export class GitRef extends BaseClient {
7313
7335
  * @param opts.to Destination remote repository. Defaults to the origin remote's push routing, or the source's repository URL when none is registered. Required when the source has no remote URL.
7314
7336
  * @param opts.remote Name of a registered remote to push to (see GitRepository.withRemote). Defaults to origin. The remote's push URLs, or its URL, become the destination; more than one push URL requires an explicit to instead.
7315
7337
  * @param opts.branch Destination branch; a refs/ prefix is used verbatim. Defaults to this ref's branch name. Required for detached and non-branch refs.
7316
- * @param opts.expectedRemoteSHA Optional lease: a full lowercase object ID allows replacement only if the remote ref still has that value. Checked even for up-to-date pushes. Empty or omitted uses normal non-force rules, creating the ref if it does not exist.
7338
+ * @param opts.expectedRemoteSha Optional lease: a full lowercase object ID allows replacement only if the remote ref still has that value. Checked even for up-to-date pushes. Empty or omitted uses normal non-force rules, creating the ref if it does not exist.
7317
7339
  */
7318
7340
  push = (opts) => {
7319
7341
  const ctx = this._ctx.select("push", { ...opts });
@@ -7490,7 +7512,7 @@ export class GitRepository extends BaseClient {
7490
7512
  * Returns details of a commit.
7491
7513
  * @param id Identifier of the commit (e.g., "b6315d8f2810962c601af73f86831f6866ea798b").
7492
7514
  *
7493
- * May be abbreviated to an unambiguous hex prefix (4-40 characters), which is expanded against locally available objects. Remote repositories (resolved via ls-remote) can only expand prefixes of already-fetched commits; use the full SHA otherwise.
7515
+ * May be abbreviated to an unambiguous hex prefix (4-40 characters), which is expanded to the full SHA. A remote repository that has not fetched the commit yet fetches the history of the refs it advertises to find it.
7494
7516
  */
7495
7517
  commit = (id) => {
7496
7518
  const ctx = this._ctx.select("commit", { id });
@@ -7532,7 +7554,7 @@ export class GitRepository extends BaseClient {
7532
7554
  * Returns details of a ref.
7533
7555
  * @param name Ref's name (can be a commit identifier, a tag name, a branch name, or a fully-qualified ref).
7534
7556
  *
7535
- * Commit identifiers may be abbreviated: an unambiguous hex prefix (4-40 characters) of a commit SHA resolves like git rev-parse, with named refs taking precedence. Abbreviated SHAs resolve against locally available objects, so remote repositories (resolved via ls-remote) can only expand prefixes of already-fetched commits; use the full SHA or a named ref otherwise.
7557
+ * Commit identifiers may be abbreviated: an unambiguous hex prefix (4-40 characters) of a commit SHA resolves like git rev-parse, with named refs taking precedence, to the full SHA. A remote repository that has not fetched the commit yet fetches the history of the refs it advertises to find it, so only commits reachable from those refs can be abbreviated.
7536
7558
  *
7537
7559
  * The name may be followed by git revision suffixes, applied left to right: `~N` follows first parents N times and `^N` selects the Nth parent (`~` and `^` mean 1, `^0` is the commit itself), e.g. `HEAD~3`, `main^2` or `abc1234~2`. The result is a detached ref of the resulting commit; remote repositories fetch the history the walk needs. Other git revision syntax (`^{...}`, `@{...}`, `:path`, ranges) is not supported.
7538
7560
  *
@@ -8596,8 +8618,8 @@ export class LLM extends BaseClient {
8596
8618
  * @param name The name of the MCP server
8597
8619
  * @param service The MCP service to run and communicate with over stdio
8598
8620
  */
8599
- withMCPServer = (name, service) => {
8600
- const ctx = this._ctx.select("withMCPServer", { name, service });
8621
+ withMcpServer = (name, service) => {
8622
+ const ctx = this._ctx.select("withMcpServer", { name, service });
8601
8623
  return new LLM(ctx);
8602
8624
  };
8603
8625
  /**
@@ -9412,8 +9434,8 @@ export class Module_ extends BaseClient {
9412
9434
  *
9413
9435
  * Note: this is in the context of a module, so some core types may be hidden.
9414
9436
  */
9415
- introspectionSchemaJSON = () => {
9416
- const ctx = this._ctx.select("introspectionSchemaJSON");
9437
+ introspectionSchemaJson = () => {
9438
+ const ctx = this._ctx.select("introspectionSchemaJson");
9417
9439
  return new File(ctx);
9418
9440
  };
9419
9441
  /**
@@ -9588,6 +9610,128 @@ export class ModuleConfigClient extends BaseClient {
9588
9610
  return response;
9589
9611
  };
9590
9612
  }
9613
+ /**
9614
+ * The names the engine gives a module's own declarations, by the naming rules of the version the module is named by.
9615
+ *
9616
+ * Every list-taking field answers in input order.
9617
+ */
9618
+ export class ModuleNaming extends BaseClient {
9619
+ _id = undefined;
9620
+ _mainObject = undefined;
9621
+ _name = undefined;
9622
+ _originalName = undefined;
9623
+ _version = undefined;
9624
+ /**
9625
+ * Constructor is used for internal usage only, do not create object from it.
9626
+ */
9627
+ constructor(ctx, _id, _mainObject, _name, _originalName, _version) {
9628
+ super(ctx);
9629
+ this._id = _id;
9630
+ this._mainObject = _mainObject;
9631
+ this._name = _name;
9632
+ this._originalName = _originalName;
9633
+ this._version = _version;
9634
+ }
9635
+ /**
9636
+ * A unique identifier for this ModuleNaming.
9637
+ */
9638
+ id = async () => {
9639
+ if (this._id) {
9640
+ return this._id;
9641
+ }
9642
+ const ctx = this._ctx.select("id");
9643
+ const response = await ctx.execute();
9644
+ return response;
9645
+ };
9646
+ /**
9647
+ * The schema names of enum members this module declares, in input order: SCREAMING_SNAKE_CASE.
9648
+ *
9649
+ * A name already written in GraphQL's enum member convention (HTTP2, P_256) is kept as it is. With the engine's identifier naming rules, Arm64 is ARM64 and GitHub is GITHUB; with the legacy strcase rules, Arm64 is ARM_64.
9650
+ *
9651
+ * Errors on a name the module's naming rules can't parse (non-ASCII, no letters or digits, or over 256 bytes). The legacy rules name anything.
9652
+ * @param names The enum member names as the module's source declares them.
9653
+ */
9654
+ enumMemberNames = async (names) => {
9655
+ const ctx = this._ctx.select("enumMemberNames", { names });
9656
+ const response = await ctx.execute();
9657
+ return response;
9658
+ };
9659
+ /**
9660
+ * The schema names of functions, object fields and function arguments this module declares, including interface functions and their arguments, in input order.
9661
+ *
9662
+ * With the engine's identifier naming rules, acronyms are written like words: getURL is getUrl, baseURL is baseUrl, HTTPClient is httpClient. With the legacy strcase rules, HTTPClient is httpclient and e2eTest is e2ETest.
9663
+ *
9664
+ * Errors on a name the module's naming rules can't parse (non-ASCII, no letters or digits, or over 256 bytes). The legacy rules name anything.
9665
+ * @param names The function, field and argument names as the module's source declares them.
9666
+ */
9667
+ fieldNames = async (names) => {
9668
+ const ctx = this._ctx.select("fieldNames", { names });
9669
+ const response = await ctx.execute();
9670
+ return response;
9671
+ };
9672
+ /**
9673
+ * Which of the candidates, the names of objects this module declares, the engine takes as the module's main object; null if none.
9674
+ *
9675
+ * The engine finds the main object by the module's name, in any casing: the first candidate, in input order, whose name normalizes to the same type name as the module's, or is spelled as that type name already (K8STools for module k8s-tools, by either rules: strcase spells k8s-tools K8STools, though it would normalize K8STools again to K8Stools). Failing that, with the engine's identifier naming rules only, the only candidate spelled the same once lowercased without word boundaries (Sha256Sum for module sha256sum); several such candidates are ambiguous, and give null.
9676
+ *
9677
+ * Errors on a name the module's naming rules can't parse (non-ASCII, no letters or digits, or over 256 bytes). The legacy rules name anything.
9678
+ * @param candidates The object names as the module's source declares them.
9679
+ */
9680
+ mainObject = async (candidates) => {
9681
+ if (this._mainObject) {
9682
+ return this._mainObject;
9683
+ }
9684
+ const ctx = this._ctx.select("mainObject", { candidates });
9685
+ const response = await ctx.execute();
9686
+ return response;
9687
+ };
9688
+ /**
9689
+ * The module's name, which namespaces its types.
9690
+ */
9691
+ name = async () => {
9692
+ if (this._name) {
9693
+ return this._name;
9694
+ }
9695
+ const ctx = this._ctx.select("name");
9696
+ const response = await ctx.execute();
9697
+ return response;
9698
+ };
9699
+ /**
9700
+ * The module's original name, which its main object and namespaced type names are spelled after. It differs from name when the module is loaded under another name, as a dependency alias.
9701
+ */
9702
+ originalName = async () => {
9703
+ if (this._originalName) {
9704
+ return this._originalName;
9705
+ }
9706
+ const ctx = this._ctx.select("originalName");
9707
+ const response = await ctx.execute();
9708
+ return response;
9709
+ };
9710
+ /**
9711
+ * The schema names of objects, interfaces and enums this module declares, as the engine installs them: namespaced under the module's name, in input order.
9712
+ *
9713
+ * A name is prefixed with the module's name unless it already starts with the module's name on a word boundary. With the engine's identifier naming rules: HttpClient in module my-mod is MyModHTTPClient; Postman in module post is PostPostman, while PostMan stays PostMan; K8STools in module k8s-tools is K8sTools, the module's own name. With the legacy strcase rules, HttpClient in module my-mod is MyModHttpClient.
9714
+ *
9715
+ * Errors on a name the module's naming rules can't parse (non-ASCII, no letters or digits, or over 256 bytes). The legacy rules name anything.
9716
+ * @param names The type names as the module's source declares them.
9717
+ */
9718
+ typeNames = async (names) => {
9719
+ const ctx = this._ctx.select("typeNames", { names });
9720
+ const response = await ctx.execute();
9721
+ return response;
9722
+ };
9723
+ /**
9724
+ * The normalized engine version whose naming rules name the module.
9725
+ */
9726
+ version = async () => {
9727
+ if (this._version) {
9728
+ return this._version;
9729
+ }
9730
+ const ctx = this._ctx.select("version");
9731
+ const response = await ctx.execute();
9732
+ return response;
9733
+ };
9734
+ }
9591
9735
  /**
9592
9736
  * The source needed to load and run a module, along with any metadata about the source such as versions/urls/etc.
9593
9737
  */
@@ -9599,8 +9743,8 @@ export class ModuleSource extends BaseClient {
9599
9743
  _configExists = undefined;
9600
9744
  _digest = undefined;
9601
9745
  _engineVersion = undefined;
9602
- _htmlRepoURL = undefined;
9603
- _htmlURL = undefined;
9746
+ _htmlRepoUrl = undefined;
9747
+ _htmlUrl = undefined;
9604
9748
  _kind = undefined;
9605
9749
  _localContextDirectoryPath = undefined;
9606
9750
  _moduleName = undefined;
@@ -9615,7 +9759,7 @@ export class ModuleSource extends BaseClient {
9615
9759
  /**
9616
9760
  * Constructor is used for internal usage only, do not create object from it.
9617
9761
  */
9618
- constructor(ctx, _id, _asString, _cloneRef, _commit, _configExists, _digest, _engineVersion, _htmlRepoURL, _htmlURL, _kind, _localContextDirectoryPath, _moduleName, _moduleOriginalName, _originalSubpath, _pin, _repoRootPath, _sourceRootSubpath, _sourceSubpath, _sync, _version) {
9762
+ constructor(ctx, _id, _asString, _cloneRef, _commit, _configExists, _digest, _engineVersion, _htmlRepoUrl, _htmlUrl, _kind, _localContextDirectoryPath, _moduleName, _moduleOriginalName, _originalSubpath, _pin, _repoRootPath, _sourceRootSubpath, _sourceSubpath, _sync, _version) {
9619
9763
  super(ctx);
9620
9764
  this._id = _id;
9621
9765
  this._asString = _asString;
@@ -9624,8 +9768,8 @@ export class ModuleSource extends BaseClient {
9624
9768
  this._configExists = _configExists;
9625
9769
  this._digest = _digest;
9626
9770
  this._engineVersion = _engineVersion;
9627
- this._htmlRepoURL = _htmlRepoURL;
9628
- this._htmlURL = _htmlURL;
9771
+ this._htmlRepoUrl = _htmlRepoUrl;
9772
+ this._htmlUrl = _htmlUrl;
9629
9773
  this._kind = _kind;
9630
9774
  this._localContextDirectoryPath = _localContextDirectoryPath;
9631
9775
  this._moduleName = _moduleName;
@@ -9678,10 +9822,15 @@ export class ModuleSource extends BaseClient {
9678
9822
  /**
9679
9823
  * The client-facing introspection schema JSON file for this module source.
9680
9824
  *
9681
- * This is the schema consumed by client codegen: unlike introspectionSchemaJSON (the module-facing schema), it hides no core types and installs this module (reached via dag.<moduleName>) so a generated client can bind it. The module's dependencies are excluded: a client is generated for a single module plus core, not its dependency graph.
9825
+ * This is the schema consumed by client codegen: unlike introspectionSchemaJson (the module-facing schema), it hides no core types and installs this module (reached via dag.<moduleName>) so a generated client can bind it. The module's dependencies are excluded: a client is generated for a single module plus core, not its dependency graph.
9826
+ * @param opts.clientVersion The engine version of the client the schema is generated for, e.g. the engineVersion of the module that depends on this one: core is described as that client sees it, capped at this engine's version.
9827
+ *
9828
+ * This module is still loaded at the engine version it declares, and so named by its own naming rules, as the engine serves it to such a client. Defaults to this module's own engine version.
9829
+ *
9830
+ * Use this rather than withEngineVersion, which makes this module declare another version and so changes its names.
9682
9831
  */
9683
- clientSchemaIntrospectionJSON = () => {
9684
- const ctx = this._ctx.select("clientSchemaIntrospectionJSON");
9832
+ clientSchemaIntrospectionJson = (opts) => {
9833
+ const ctx = this._ctx.select("clientSchemaIntrospectionJson", { ...opts });
9685
9834
  return new File(ctx);
9686
9835
  };
9687
9836
  /**
@@ -9797,22 +9946,22 @@ export class ModuleSource extends BaseClient {
9797
9946
  /**
9798
9947
  * The URL to access the web view of the repository (e.g., GitHub, GitLab, Bitbucket).
9799
9948
  */
9800
- htmlRepoURL = async () => {
9801
- if (this._htmlRepoURL) {
9802
- return this._htmlRepoURL;
9949
+ htmlRepoUrl = async () => {
9950
+ if (this._htmlRepoUrl) {
9951
+ return this._htmlRepoUrl;
9803
9952
  }
9804
- const ctx = this._ctx.select("htmlRepoURL");
9953
+ const ctx = this._ctx.select("htmlRepoUrl");
9805
9954
  const response = await ctx.execute();
9806
9955
  return response;
9807
9956
  };
9808
9957
  /**
9809
9958
  * The URL to the source's git repo in a web browser. Only valid for git sources.
9810
9959
  */
9811
- htmlURL = async () => {
9812
- if (this._htmlURL) {
9813
- return this._htmlURL;
9960
+ htmlUrl = async () => {
9961
+ if (this._htmlUrl) {
9962
+ return this._htmlUrl;
9814
9963
  }
9815
- const ctx = this._ctx.select("htmlURL");
9964
+ const ctx = this._ctx.select("htmlUrl");
9816
9965
  const response = await ctx.execute();
9817
9966
  return response;
9818
9967
  };
@@ -9823,8 +9972,8 @@ export class ModuleSource extends BaseClient {
9823
9972
  *
9824
9973
  * Note: this is in the context of a module, so some core types may be hidden.
9825
9974
  */
9826
- introspectionSchemaJSON = () => {
9827
- const ctx = this._ctx.select("introspectionSchemaJSON");
9975
+ introspectionSchemaJson = () => {
9976
+ const ctx = this._ctx.select("introspectionSchemaJson");
9828
9977
  return new File(ctx);
9829
9978
  };
9830
9979
  /**
@@ -9871,6 +10020,20 @@ export class ModuleSource extends BaseClient {
9871
10020
  const response = await ctx.execute();
9872
10021
  return response;
9873
10022
  };
10023
+ /**
10024
+ * The names the engine gives this module's own declarations, by the naming rules of the version the module is named by: its engine version, capped at the engine's own.
10025
+ *
10026
+ * Modules declaring a version before the identifier casing cut get the legacy strcase names; later ones get the engine's identifier naming rules.
10027
+ *
10028
+ * For SDK codegen, which must reproduce these names before the module is loaded: this reads only the source's name, original name and engine version, so it answers before the module's entrypoint is generated.
10029
+ *
10030
+ * It answers for the module under its own name (moduleName). A workspace or toolchain that loads the module under another name namespaces its types under that name instead, which this doesn't reflect.
10031
+ * @experimental
10032
+ */
10033
+ naming = () => {
10034
+ const ctx = this._ctx.select("naming");
10035
+ return new ModuleNaming(ctx);
10036
+ };
9874
10037
  /**
9875
10038
  * The original subpath used when instantiating this module source, relative to the context directory.
9876
10039
  */
@@ -10043,8 +10206,8 @@ export class ModuleSource extends BaseClient {
10043
10206
  * Update the module source with a new SDK.
10044
10207
  * @param source The SDK source to set.
10045
10208
  */
10046
- withSDK = (source) => {
10047
- const ctx = this._ctx.select("withSDK", { source });
10209
+ withSdk = (source) => {
10210
+ const ctx = this._ctx.select("withSdk", { source });
10048
10211
  return new ModuleSource(ctx);
10049
10212
  };
10050
10213
  /**
@@ -10147,6 +10310,85 @@ export class ModuleSource extends BaseClient {
10147
10310
  return arg(this);
10148
10311
  };
10149
10312
  }
10313
+ /**
10314
+ * The engine's identifier naming rules at an engine version.
10315
+ */
10316
+ export class Naming extends BaseClient {
10317
+ _id = undefined;
10318
+ _version = undefined;
10319
+ /**
10320
+ * Constructor is used for internal usage only, do not create object from it.
10321
+ */
10322
+ constructor(ctx, _id, _version) {
10323
+ super(ctx);
10324
+ this._id = _id;
10325
+ this._version = _version;
10326
+ }
10327
+ /**
10328
+ * A unique identifier for this Naming.
10329
+ */
10330
+ id = async () => {
10331
+ if (this._id) {
10332
+ return this._id;
10333
+ }
10334
+ const ctx = this._ctx.select("id");
10335
+ const response = await ctx.execute();
10336
+ return response;
10337
+ };
10338
+ /**
10339
+ * The acronyms and terms used to parse and format identifiers.
10340
+ */
10341
+ dictionary = async () => {
10342
+ const ctx = this._ctx.select("dictionary").select("id");
10343
+ const response = await ctx.execute();
10344
+ return response.map((r) => new NamingTerm(ctx.copy().selectNode(r.id, "NamingTerm")));
10345
+ };
10346
+ /**
10347
+ * Format many names at once, for codegen. Returns them in input order.
10348
+ * @param names The names to format, in any casing.
10349
+ * @param casing The casing to format the names in.
10350
+ * @param opts.acronyms How to write acronyms and terms where a word starts with a capital.
10351
+ */
10352
+ formatIdentifiers = async (names, casing, opts) => {
10353
+ const metadata = {
10354
+ casing: { is_enum: true, value_to_name: CasingValueToName },
10355
+ acronyms: { is_enum: true, value_to_name: AcronymStyleValueToName },
10356
+ };
10357
+ const ctx = this._ctx.select("formatIdentifiers", { names, casing, ...opts, __metadata: metadata });
10358
+ const response = await ctx.execute();
10359
+ return response;
10360
+ };
10361
+ /**
10362
+ * Parse a name in any casing into words.
10363
+ *
10364
+ * Known acronyms and terms come from the naming dictionary; everything else falls back to the case heuristic. Errors on non-ASCII input, input with no letters or digits, or input over 256 bytes.
10365
+ * @param name The name to parse.
10366
+ */
10367
+ identifier = (name) => {
10368
+ const ctx = this._ctx.select("identifier", { name });
10369
+ return new Identifier(ctx);
10370
+ };
10371
+ /**
10372
+ * The names the engine gives the declarations of a module named by these rules.
10373
+ * @param name The module's name, which namespaces its types.
10374
+ * @param opts.originalName The module's original name, when it's loaded under another (as a dependency alias): its main object and namespaced type names are spelled after it. Defaults to name.
10375
+ */
10376
+ module_ = (name, opts) => {
10377
+ const ctx = this._ctx.select("module", { name, ...opts });
10378
+ return new ModuleNaming(ctx);
10379
+ };
10380
+ /**
10381
+ * The normalized engine version these rules answer for.
10382
+ */
10383
+ version = async () => {
10384
+ if (this._version) {
10385
+ return this._version;
10386
+ }
10387
+ const ctx = this._ctx.select("version");
10388
+ const response = await ctx.execute();
10389
+ return response;
10390
+ };
10391
+ }
10150
10392
  /**
10151
10393
  * An entry in the naming dictionary.
10152
10394
  */
@@ -10608,23 +10850,6 @@ export class Client extends BaseClient {
10608
10850
  const ctx = this._ctx.select("file", { name, contents, ...opts });
10609
10851
  return new File(ctx);
10610
10852
  };
10611
- /**
10612
- * Format many names at once, for codegen. Returns them in input order.
10613
- * @param names The names to format, in any casing.
10614
- * @param casing The casing to format the names in.
10615
- * @param opts.acronyms How to write acronyms and terms where a word starts with a capital.
10616
- * @param opts.version The engine version whose naming dictionary to parse the names with, e.g. the __schemaVersion of a schema being generated. Defaults to the caller's engine version.
10617
- * @experimental
10618
- */
10619
- formatIdentifiers = async (names, casing, opts) => {
10620
- const metadata = {
10621
- casing: { is_enum: true, value_to_name: CasingValueToName },
10622
- acronyms: { is_enum: true, value_to_name: AcronymStyleValueToName },
10623
- };
10624
- const ctx = this._ctx.select("formatIdentifiers", { names, casing, ...opts, __metadata: metadata });
10625
- const response = await ctx.execute();
10626
- return response;
10627
- };
10628
10853
  /**
10629
10854
  * Creates a function.
10630
10855
  * @param name Name of the function, in its original format from the implementation language.
@@ -10680,17 +10905,6 @@ export class Client extends BaseClient {
10680
10905
  const ctx = this._ctx.select("http", { url, ...opts });
10681
10906
  return new File(ctx);
10682
10907
  };
10683
- /**
10684
- * Parse a name in any casing into words.
10685
- *
10686
- * Known acronyms and terms come from the naming dictionary; everything else falls back to the case heuristic. Errors on non-ASCII input, input with no letters or digits, or input over 256 bytes.
10687
- * @param name The name to parse.
10688
- * @experimental
10689
- */
10690
- identifier = (name) => {
10691
- const ctx = this._ctx.select("identifier", { name });
10692
- return new Identifier(ctx);
10693
- };
10694
10908
  /**
10695
10909
  * Initialize a JSON value
10696
10910
  */
@@ -10742,13 +10956,13 @@ export class Client extends BaseClient {
10742
10956
  return new ModuleSource(ctx);
10743
10957
  };
10744
10958
  /**
10745
- * The acronyms and terms used to parse and format identifiers.
10959
+ * The engine's identifier naming rules at an engine version.
10960
+ * @param opts.version The engine version to answer for, e.g. the engine version a module declares. Defaults to the caller's. Normalized as a module's is: a version past the engine's is capped at the engine's own.
10746
10961
  * @experimental
10747
10962
  */
10748
- namingDictionary = async () => {
10749
- const ctx = this._ctx.select("namingDictionary").select("id");
10750
- const response = await ctx.execute();
10751
- return response.map((r) => new NamingTerm(ctx.copy().selectNode(r.id, "NamingTerm")));
10963
+ naming = (opts) => {
10964
+ const ctx = this._ctx.select("naming", { ...opts });
10965
+ return new Naming(ctx);
10752
10966
  };
10753
10967
  /**
10754
10968
  * Load any object by its ID.
@@ -12518,9 +12732,9 @@ export class Workspace extends BaseClient {
12518
12732
  return new Workspace(ctx);
12519
12733
  };
12520
12734
  /**
12521
- * Return this workspace with a directory mounted read-only at the given path, without mutating the source.
12735
+ * Return this workspace with a directory mounted at the given path, without mutating the source.
12522
12736
  *
12523
- * Mounted content is readable through the normal workspace file tools but shadows the source at the mount path and stays out of the pending changeset: it never appears in changes, is never exported, and cannot be modified.
12737
+ * Mounted content is readable and editable through the normal workspace file tools but shadows the source at the mount path and stays out of the pending changeset: neither it nor edits to it appear in changes or are exported. Use withoutMount to remove the mount.
12524
12738
  * @param path Location of the mounted directory. Relative paths resolve from the workspace cwd.
12525
12739
  * @param source Directory to mount.
12526
12740
  */
@@ -12529,9 +12743,9 @@ export class Workspace extends BaseClient {
12529
12743
  return new Workspace(ctx);
12530
12744
  };
12531
12745
  /**
12532
- * Return this workspace with a file mounted read-only at the given path, without mutating the source.
12746
+ * Return this workspace with a file mounted at the given path, without mutating the source.
12533
12747
  *
12534
- * Mounted content is readable through the normal workspace file tools but shadows the source at the mount path and stays out of the pending changeset: it never appears in changes, is never exported, and cannot be modified.
12748
+ * Mounted content is readable and editable through the normal workspace file tools but shadows the source at the mount path and stays out of the pending changeset: neither it nor edits to it appear in changes or are exported. Use withoutMount to remove the mount.
12535
12749
  * @param path Location of the mounted file. Relative paths resolve from the workspace cwd.
12536
12750
  * @param source File to mount.
12537
12751
  */
@@ -12563,7 +12777,7 @@ export class Workspace extends BaseClient {
12563
12777
  /**
12564
12778
  * Return this workspace with the given Git-compatible patch file applied, without mutating the source.
12565
12779
  *
12566
- * Paths in the patch are relative to the workspace root, whatever its cwd, as `git diff` writes them. Patching a path at or under a mount is an error.
12780
+ * Paths in the patch are relative to the workspace root, whatever its cwd, as `git diff` writes them. Sections for paths in a mount apply to the mounted content; a section cannot move a file across a mount boundary or delete a mount point.
12567
12781
  * @param patch File containing the patch to apply
12568
12782
  * @param opts.onConflict How to handle hunks that no longer apply to the target content: fail (default), or apply what fits and leave git-style conflict markers where it doesn't.
12569
12783
  * @experimental
@@ -12597,8 +12811,8 @@ export class Workspace extends BaseClient {
12597
12811
  * @param opts.here Write to the workspace config directory at the workspace cwd.
12598
12812
  * @param opts.asSdkName Optional override for the SDK name conventionally derived from the installed module name.
12599
12813
  */
12600
- withSDK = (ref, opts) => {
12601
- const ctx = this._ctx.select("withSDK", { ref, ...opts });
12814
+ withSdk = (ref, opts) => {
12815
+ const ctx = this._ctx.select("withSdk", { ref, ...opts });
12602
12816
  return new Workspace(ctx);
12603
12817
  };
12604
12818
  /**
@@ -12758,8 +12972,8 @@ export class Workspace extends BaseClient {
12758
12972
  * @param name Name of the installed SDK entry to remove.
12759
12973
  * @param opts.here Write to the workspace config directory at the workspace cwd.
12760
12974
  */
12761
- withoutSDK = (name, opts) => {
12762
- const ctx = this._ctx.select("withoutSDK", { name, ...opts });
12975
+ withoutSdk = (name, opts) => {
12976
+ const ctx = this._ctx.select("withoutSdk", { name, ...opts });
12763
12977
  return new Workspace(ctx);
12764
12978
  };
12765
12979
  /**
@@ -13290,5 +13504,24 @@ export class WorkspaceSDK extends BaseClient {
13290
13504
  const response = await ctx.execute();
13291
13505
  return response;
13292
13506
  };
13507
+ /**
13508
+ * The value a setting records in this SDK's scope settings, as a native JSON value.
13509
+ *
13510
+ * Reads [sdks.<name>.scopes."<scope>".settings] from the workspace config, in the scope whose key resolves to path. The setting key is matched without regard to case.
13511
+ *
13512
+ * Null when no scope resolves to path, or the scope records no such setting. Fails when the config is invalid, path escapes the workspace root, key matches several recorded settings, or the value cannot be represented as JSON.
13513
+ *
13514
+ * Fails when this SDK is no longer installed in the workspace config, even if Workspace.sdk returned it earlier.
13515
+ * @param path Scope path, relative to the workspace cwd or absolute from the workspace root.
13516
+ * @param key Setting name, matched without regard to case.
13517
+ */
13518
+ scopeSetting = async (path, key) => {
13519
+ const ctx = this._ctx.select("scopeSetting", { path, key }).select("id");
13520
+ const response = await ctx.execute();
13521
+ if (response === null) {
13522
+ return null;
13523
+ }
13524
+ return new JSONValue(ctx.copy().selectNode(response, "JSONValue"));
13525
+ };
13293
13526
  }
13294
13527
  export const dag = new Client();