@spec as_changesets(t()) :: {:ok, [Dagger.Changeset.t()]} | {:error, term()}

Convert the selection to Changesets. Fail if any artifact is not a Changeset. Does not apply command filters.

@spec as_checks(t()) :: {:ok, [Dagger.Check.t()]} | {:error, term()}

Convert the selection to Checks. Fail if any artifact is not a Check. Does not apply command filters or run the checks.

@spec as_expertise(t()) :: {:ok, [Dagger.Expertise.t()]} | {:error, term()}

Convert the selection to expertise without running the functions. Fail if any artifact is not a source of expertise.

@spec as_generators(t()) :: {:ok, [Dagger.Generator.t()]} | {:error, term()}

Convert the selection to Generators without running them. Fail if any artifact is not a Generator.

@spec as_services(t()) :: {:ok, [Dagger.Service.t()]} | {:error, term()}

Convert the selection to Services. Fail if any artifact is not a Service. Does not apply command filters or start the services.

@spec dimension_definitions(t()) ::
  {:ok, [Dagger.ArtifactDimension.t()]} | {:error, term()}

List dimensions on the selected schema paths, including empty collections. Does not read runtime values.

@spec dimension_items(t(), String.t()) ::
  {:ok, [Dagger.Artifact.t()]} | {:error, term()}

List collection items represented in this selection for the given dimension. Preserve parent keys and remove duplicate item addresses. Does not evaluate item values.

@spec dimension_keys(t(), String.t()) :: {:ok, [String.t()]} | {:error, term()}

List keys represented in this selection for the given dimension, sorted with no duplicates.

@spec dimensions(t()) :: {:ok, [String.t()]} | {:error, term()}

List dimension identifiers represented in this selection, sorted with no duplicates.

@spec filter_dimension_keys(t(), String.t(), [String.t()]) :: t()

Keep artifacts with any listed key in this dimension.

@spec filter_dimensions(t(), [String.t()]) :: t()

Keep artifacts selected through any listed dimension.

@spec filter_directives(t(), [String.t()], [{:exclude, boolean() | nil}]) :: t()

Keep artifacts with any listed directive. Does not filter by type or workspace settings.

@spec filter_parent_directives(t(), [String.t()], [{:exclude, boolean() | nil}]) ::
  t()

Keep artifacts whose immediate parent has any listed directive. Artifacts without a parent do not match.

@spec filter_parent_types(t(), [String.t()], [{:exclude, boolean() | nil}]) :: t()

Keep artifacts whose immediate parent has any listed object type. Artifacts without a typed parent do not match.

@spec filter_path(t(), [String.t()]) :: t()

Match one complete, ordered field sequence exactly.

@spec filter_path_pattern(t(), String.t()) :: t()

Keep paths that match a glob pattern. A literal path matches exactly. Both module-qualified and entrypoint paths match.

@spec filter_types(t(), [String.t()], [{:exclude, boolean() | nil}]) :: t()

Keep artifacts of any listed concrete GraphQL type.

@spec filter_uri(t(), String.t()) :: t()

Apply a DAG address as one filter: the chain of path, type, and dimension-key filters it encodes.

The scheme is optional. The path may be a pattern; an empty path selects all artifacts.

@spec id(t()) :: {:ok, String.t()} | {:error, term()}

A unique identifier for this Artifacts.

@spec items(t()) :: {:ok, [Dagger.Artifact.t()]} | {:error, term()}

Enumerate complete artifacts without evaluating their values.

@spec modules(t()) :: {:ok, [Dagger.Module.t()]} | {:error, term()}

List the modules represented in this selection without evaluating artifact values.

@spec one(t()) :: Dagger.Artifact.t()

Require exactly one artifact; fail if there are zero or multiple matches. Several matches are listed, one address per line.

@spec path_definitions(t(),
  absolute: boolean() | nil,
  type_assertion: boolean() | nil,
  dimension: String.t() | nil
) :: {:ok, [Dagger.ArtifactPath.t()]} | {:error, term()}

List selected schema paths, including empty collections. Does not read runtime values. Applies type keys and collection presence; collection key values require items.

@spec types(t()) :: {:ok, [Dagger.TypeDef.t()]} | {:error, term()}

List concrete type definitions represented in this selection, sorted by name with no duplicates.

@spec uri(t()) :: {:ok, String.t()} | {:error, term()}

The DAG address that selects this whole selection: filterUri(uri) selects the same set.

@spec values(t(), fail_fast: boolean() | nil, arguments: Dagger.JSON.t() | nil) ::
  {:ok, [Dagger.ArtifactResult.t()]} | {:error, term()}

Evaluate the selection in parallel, retaining each result and error.

@spec with_artifacts(t(), t()) :: t()

Combine two selections, keeping each workspace address once. Different addresses remain distinct even if they return the same object.

@spec without_uri(t(), String.t()) :: t()

Remove artifacts selected by a DAG address.