release: 0.1.0-alpha.5

.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "0.1.0-alpha.4"
+  ".": "0.1.0-alpha.5"
 }

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 100
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/langsmith%2Flangsmith-api-624b469e0a8ed90f1574e609929702b6da43306d0681975f690ebda2d40a1c74.yml
-openapi_spec_hash: 389b1d06dd9a4b9e83d410d8d8ece950
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/langsmith%2Flangsmith-api-727e2aeb765fd2000313549d01ad950a2618797f18b897bc5dbdd73230e3f5e5.yml
+openapi_spec_hash: 44f991ff8d10a14680b1e6926f686976
 config_hash: 4c81a93850b2f9805605749a196ed2df

CHANGELOG.md

@@ -1,5 +1,31 @@
 # Changelog
 
+## 0.1.0-alpha.5 (2026-01-14)
+
+Full Changelog: [v0.1.0-alpha.4...v0.1.0-alpha.5](https://github.com/langchain-ai/langsmith-go/compare/v0.1.0-alpha.4...v0.1.0-alpha.5)
+
+### Features
+
+* **api:** api update ([925146c](https://github.com/langchain-ai/langsmith-go/commit/925146c93683a7b98324d8b1b2bf27b3d4deec8d))
+* **api:** api update ([40886b9](https://github.com/langchain-ai/langsmith-go/commit/40886b91e1471e64dff8dfb274b8bfe179ac99f9))
+* **api:** api update ([74c71ed](https://github.com/langchain-ai/langsmith-go/commit/74c71eda0feb1f9a5885404d8583671e34585fb1))
+* **api:** api update ([9dad560](https://github.com/langchain-ai/langsmith-go/commit/9dad56055048b0a1376c45d125de51a9da8f7446))
+* **api:** api update ([df983a3](https://github.com/langchain-ai/langsmith-go/commit/df983a31e6f0ded956237952f91aade41bed48aa))
+* **api:** api update ([13e585b](https://github.com/langchain-ai/langsmith-go/commit/13e585bda50d281da4a45d9968acdf37567555cf))
+* **api:** api update ([e7ba714](https://github.com/langchain-ai/langsmith-go/commit/e7ba714691bc74fb530a729ece4f1bf63159d2a4))
+* **api:** api update ([64f64ed](https://github.com/langchain-ai/langsmith-go/commit/64f64ed425d061c542cdc767c2991c3065b28f30))
+* **api:** manual updates ([13e2d39](https://github.com/langchain-ai/langsmith-go/commit/13e2d39dd5518d343d1dbd1fd5ef07744f9e0c9a))
+
+
+### Bug Fixes
+
+* skip usage tests that don't work with Prism ([6f397c4](https://github.com/langchain-ai/langsmith-go/commit/6f397c4441cd81e2d6ff8e85953502e1e39a8afb))
+
+
+### Chores
+
+* **internal:** codegen related update ([cbcbc79](https://github.com/langchain-ai/langsmith-go/commit/cbcbc790d92feb7a25fce8dcccdf363504e76a96))
+
 ## 0.1.0-alpha.4 (2025-12-10)
 
 Full Changelog: [v0.1.0-alpha.3...v0.1.0-alpha.4](https://github.com/langchain-ai/langsmith-go/compare/v0.1.0-alpha.3...v0.1.0-alpha.4)

LICENSE

@@ -1,4 +1,4 @@
-Copyright 2025 langChain
+Copyright 2026 langChain
 
 Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
 

README.md

@@ -24,7 +24,7 @@ Or to pin the version:
 <!-- x-release-please-start-version -->
 
 ```sh
-go get -u 'github.com/langchain-ai/langsmith-go@v0.1.0-alpha.4'
+go get -u 'github.com/langchain-ai/langsmith-go@v0.1.0-alpha.5'
 ```
 
 <!-- x-release-please-end -->

annotationqueuerun.go

@@ -141,13 +141,58 @@ type AnnotationQueueRunDeleteAllResponse = interface{}
 type AnnotationQueueRunDeleteQueueResponse = interface{}
 
 type AnnotationQueueRunNewParams struct {
-	Body []string `json:"body,required" format:"uuid"`
+	Body AnnotationQueueRunNewParamsBodyUnion `json:"body,required" format:"uuid"`
 }
 
 func (r AnnotationQueueRunNewParams) MarshalJSON() (data []byte, err error) {
 	return apijson.MarshalRoot(r.Body)
 }
 
+// Satisfied by [AnnotationQueueRunNewParamsBodyRunUuidList],
+// [AnnotationQueueRunNewParamsBodyRunAddSchemaList].
+type AnnotationQueueRunNewParamsBodyUnion interface {
+	implementsAnnotationQueueRunNewParamsBodyUnion()
+}
+
+type AnnotationQueueRunNewParamsBodyRunUuidList []string
+
+func (r AnnotationQueueRunNewParamsBodyRunUuidList) implementsAnnotationQueueRunNewParamsBodyUnion() {
+}
+
+type AnnotationQueueRunNewParamsBodyRunAddSchemaList []AnnotationQueueRunNewParamsBodyRunAddSchemaListItem
+
+func (r AnnotationQueueRunNewParamsBodyRunAddSchemaList) implementsAnnotationQueueRunNewParamsBodyUnion() {
+}
+
+// Schema for adding a run to an annotation queue with optional metadata.
+type AnnotationQueueRunNewParamsBodyRunAddSchemaListItem struct {
+	RunID       param.Field[string]                                                   `json:"run_id,required" format:"uuid"`
+	ParentRunID param.Field[string]                                                   `json:"parent_run_id" format:"uuid"`
+	SessionID   param.Field[string]                                                   `json:"session_id" format:"uuid"`
+	StartTime   param.Field[time.Time]                                                `json:"start_time" format:"date-time"`
+	TraceID     param.Field[string]                                                   `json:"trace_id" format:"uuid"`
+	TraceTier   param.Field[AnnotationQueueRunNewParamsBodyRunAddSchemaListTraceTier] `json:"trace_tier"`
+}
+
+func (r AnnotationQueueRunNewParamsBodyRunAddSchemaListItem) MarshalJSON() (data []byte, err error) {
+	return apijson.MarshalRoot(r)
+}
+
+type AnnotationQueueRunNewParamsBodyRunAddSchemaListTraceTier string
+
+const (
+	AnnotationQueueRunNewParamsBodyRunAddSchemaListTraceTierLonglived  AnnotationQueueRunNewParamsBodyRunAddSchemaListTraceTier = "longlived"
+	AnnotationQueueRunNewParamsBodyRunAddSchemaListTraceTierShortlived AnnotationQueueRunNewParamsBodyRunAddSchemaListTraceTier = "shortlived"
+)
+
+func (r AnnotationQueueRunNewParamsBodyRunAddSchemaListTraceTier) IsKnown() bool {
+	switch r {
+	case AnnotationQueueRunNewParamsBodyRunAddSchemaListTraceTierLonglived, AnnotationQueueRunNewParamsBodyRunAddSchemaListTraceTierShortlived:
+		return true
+	}
+	return false
+}
+
 type AnnotationQueueRunUpdateParams struct {
 	AddedAt          param.Field[time.Time] `json:"added_at" format:"date-time"`
 	LastReviewedTime param.Field[time.Time] `json:"last_reviewed_time" format:"date-time"`

annotationqueuerun_test.go

@@ -33,7 +33,7 @@ func TestAnnotationQueueRunNew(t *testing.T) {
 		context.TODO(),
 		"182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
 		langsmith.AnnotationQueueRunNewParams{
-			Body: []string{"182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e"},
+			Body: langsmith.AnnotationQueueRunNewParamsBodyRunUuidList([]string{"182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e"}),
 		},
 	)
 	if err != nil {

api.md

@@ -146,7 +146,6 @@ Methods:
 
 Params Types:
 
-- <a href="https://pkg.go.dev/github.com/langchain-ai/langsmith-go">langsmith</a>.<a href="https://pkg.go.dev/github.com/langchain-ai/langsmith-go#QueryExampleSchemaWithRunsParam">QueryExampleSchemaWithRunsParam</a>
 - <a href="https://pkg.go.dev/github.com/langchain-ai/langsmith-go">langsmith</a>.<a href="https://pkg.go.dev/github.com/langchain-ai/langsmith-go#QueryFeedbackDeltaParam">QueryFeedbackDeltaParam</a>
 - <a href="https://pkg.go.dev/github.com/langchain-ai/langsmith-go">langsmith</a>.<a href="https://pkg.go.dev/github.com/langchain-ai/langsmith-go#SortParamsForRunsComparisonView">SortParamsForRunsComparisonView</a>
 

commit.go

@@ -64,6 +64,8 @@ func (r *CommitService) Get(ctx context.Context, owner interface{}, repo interfa
 // Lists all commits for a repository with pagination support. This endpoint
 // supports both authenticated and unauthenticated access. Authenticated users can
 // access private repos, while unauthenticated users can only access public repos.
+// The include_stats parameter controls whether download and view statistics are
+// computed (defaults to true).
 func (r *CommitService) List(ctx context.Context, owner interface{}, repo interface{}, query CommitListParams, opts ...option.RequestOption) (res *pagination.OffsetPaginationCommits[CommitWithLookups], err error) {
 	var raw *http.Response
 	opts = slices.Concat(r.Options, opts)
@@ -84,6 +86,8 @@ func (r *CommitService) List(ctx context.Context, owner interface{}, repo interf
 // Lists all commits for a repository with pagination support. This endpoint
 // supports both authenticated and unauthenticated access. Authenticated users can
 // access private repos, while unauthenticated users can only access public repos.
+// The include_stats parameter controls whether download and view statistics are
+// computed (defaults to true).
 func (r *CommitService) ListAutoPaging(ctx context.Context, owner interface{}, repo interface{}, query CommitListParams, opts ...option.RequestOption) *pagination.OffsetPaginationCommitsAutoPager[CommitWithLookups] {
 	return pagination.NewOffsetPaginationCommitsAutoPager(r.List(ctx, owner, repo, query, opts...))
 }
@@ -304,6 +308,8 @@ func (r CommitGetParams) URLQuery() (v url.Values) {
 }
 
 type CommitListParams struct {
+	// IncludeStats determines whether to compute num_downloads and num_views
+	IncludeStats param.Field[bool] `query:"include_stats"`
 	// Limit is the pagination limit
 	Limit param.Field[int64] `query:"limit"`
 	// Offset is the pagination offset

commit_test.go

@@ -102,8 +102,9 @@ func TestCommitListWithOptionalParams(t *testing.T) {
 		map[string]interface{}{},
 		map[string]interface{}{},
 		langsmith.CommitListParams{
-			Limit:  langsmith.F(int64(1)),
-			Offset: langsmith.F(int64(0)),
+			IncludeStats: langsmith.F(true),
+			Limit:        langsmith.F(int64(1)),
+			Offset:       langsmith.F(int64(0)),
 		},
 	)
 	if err != nil {

dataset.go

@@ -637,8 +637,9 @@ type DatasetCloneParams struct {
 	TargetDatasetID param.Field[string] `json:"target_dataset_id,required" format:"uuid"`
 	// Only modifications made on or before this time are included. If None, the latest
 	// version of the dataset is used.
-	AsOf     param.Field[DatasetCloneParamsAsOfUnion] `json:"as_of" format:"date-time"`
-	Examples param.Field[[]string]                    `json:"examples" format:"uuid"`
+	AsOf     param.Field[DatasetCloneParamsAsOfUnion]  `json:"as_of" format:"date-time"`
+	Examples param.Field[[]string]                     `json:"examples" format:"uuid"`
+	Split    param.Field[DatasetCloneParamsSplitUnion] `json:"split"`
 }
 
 func (r DatasetCloneParams) MarshalJSON() (data []byte, err error) {
@@ -653,6 +654,15 @@ type DatasetCloneParamsAsOfUnion interface {
 	ImplementsDatasetCloneParamsAsOfUnion()
 }
 
+// Satisfied by [shared.UnionString], [DatasetCloneParamsSplitArray].
+type DatasetCloneParamsSplitUnion interface {
+	ImplementsDatasetCloneParamsSplitUnion()
+}
+
+type DatasetCloneParamsSplitArray []string
+
+func (r DatasetCloneParamsSplitArray) ImplementsDatasetCloneParamsSplitUnion() {}
+
 type DatasetGetCsvParams struct {
 	// Only modifications made on or before this time are included. If None, the latest
 	// version of the dataset is used.

dataset_test.go

@@ -237,6 +237,7 @@ func TestDatasetCloneWithOptionalParams(t *testing.T) {
 		TargetDatasetID: langsmith.F("182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e"),
 		AsOf:            langsmith.F[langsmith.DatasetCloneParamsAsOfUnion](shared.UnionTime(time.Now())),
 		Examples:        langsmith.F([]string{"182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e"}),
+		Split:           langsmith.F[langsmith.DatasetCloneParamsSplitUnion](shared.UnionString("string")),
 	})
 	if err != nil {
 		var apierr *langsmith.Error

datasetrun.go

@@ -344,6 +344,7 @@ type ExampleWithRunsChRun struct {
 	ExecutionOrder     int64                             `json:"execution_order"`
 	Extra              map[string]interface{}            `json:"extra,nullable"`
 	FeedbackStats      map[string]map[string]interface{} `json:"feedback_stats,nullable"`
+	Feedbacks          []FeedbackSchema                  `json:"feedbacks"`
 	Inputs             map[string]interface{}            `json:"inputs,nullable"`
 	InputsPreview      string                            `json:"inputs_preview,nullable"`
 	InputsS3URLs       map[string]interface{}            `json:"inputs_s3_urls,nullable"`
@@ -386,6 +387,7 @@ type exampleWithRunsChRunJSON struct {
 	ExecutionOrder     apijson.Field
 	Extra              apijson.Field
 	FeedbackStats      apijson.Field
+	Feedbacks          apijson.Field
 	Inputs             apijson.Field
 	InputsPreview      apijson.Field
 	InputsS3URLs       apijson.Field
@@ -439,20 +441,6 @@ func (r ExampleWithRunsChRunsRunType) IsKnown() bool {
 	return false
 }
 
-type QueryExampleSchemaWithRunsParam struct {
-	SessionIDs              param.Field[[]string]                        `json:"session_ids,required" format:"uuid"`
-	ComparativeExperimentID param.Field[string]                          `json:"comparative_experiment_id" format:"uuid"`
-	Filters                 param.Field[map[string][]string]             `json:"filters"`
-	Limit                   param.Field[int64]                           `json:"limit"`
-	Offset                  param.Field[int64]                           `json:"offset"`
-	Preview                 param.Field[bool]                            `json:"preview"`
-	SortParams              param.Field[SortParamsForRunsComparisonView] `json:"sort_params"`
-}
-
-func (r QueryExampleSchemaWithRunsParam) MarshalJSON() (data []byte, err error) {
-	return apijson.MarshalRoot(r)
-}
-
 type QueryFeedbackDeltaParam struct {
 	BaselineSessionID       param.Field[string]              `json:"baseline_session_id,required" format:"uuid"`
 	ComparisonSessionIDs    param.Field[[]string]            `json:"comparison_session_ids,required" format:"uuid"`
@@ -567,13 +555,20 @@ type DatasetRunNewResponseArray []ExampleWithRunsCh
 func (r DatasetRunNewResponseArray) implementsDatasetRunNewResponseUnion() {}
 
 type DatasetRunNewParams struct {
-	QueryExampleSchemaWithRuns QueryExampleSchemaWithRunsParam `json:"query_example_schema_with_runs,required"`
+	SessionIDs param.Field[[]string] `json:"session_ids,required" format:"uuid"`
 	// Response format, e.g., 'csv'
-	Format param.Field[string] `query:"format"`
+	Format                  param.Field[DatasetRunNewParamsFormat]       `query:"format"`
+	ComparativeExperimentID param.Field[string]                          `json:"comparative_experiment_id" format:"uuid"`
+	Filters                 param.Field[map[string][]string]             `json:"filters"`
+	Limit                   param.Field[int64]                           `json:"limit"`
+	Offset                  param.Field[int64]                           `json:"offset"`
+	Preview                 param.Field[bool]                            `json:"preview"`
+	SortParams              param.Field[SortParamsForRunsComparisonView] `json:"sort_params"`
+	Stream                  param.Field[bool]                            `json:"stream"`
 }
 
 func (r DatasetRunNewParams) MarshalJSON() (data []byte, err error) {
-	return apijson.MarshalRoot(r.QueryExampleSchemaWithRuns)
+	return apijson.MarshalRoot(r)
 }
 
 // URLQuery serializes [DatasetRunNewParams]'s query parameters as `url.Values`.
@@ -584,6 +579,21 @@ func (r DatasetRunNewParams) URLQuery() (v url.Values) {
 	})
 }
 
+// Response format, e.g., 'csv'
+type DatasetRunNewParamsFormat string
+
+const (
+	DatasetRunNewParamsFormatCsv DatasetRunNewParamsFormat = "csv"
+)
+
+func (r DatasetRunNewParamsFormat) IsKnown() bool {
+	switch r {
+	case DatasetRunNewParamsFormatCsv:
+		return true
+	}
+	return false
+}
+
 type DatasetRunDeltaParams struct {
 	QueryFeedbackDelta QueryFeedbackDeltaParam `json:"query_feedback_delta,required"`
 }

datasetrun_test.go

@@ -32,21 +32,20 @@ func TestDatasetRunNewWithOptionalParams(t *testing.T) {
 		context.TODO(),
 		"182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
 		langsmith.DatasetRunNewParams{
-			QueryExampleSchemaWithRuns: langsmith.QueryExampleSchemaWithRunsParam{
-				SessionIDs:              langsmith.F([]string{"182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e"}),
-				ComparativeExperimentID: langsmith.F("182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e"),
-				Filters: langsmith.F(map[string][]string{
-					"foo": {"string"},
-				}),
-				Limit:   langsmith.F(int64(1)),
-				Offset:  langsmith.F(int64(0)),
-				Preview: langsmith.F(true),
-				SortParams: langsmith.F(langsmith.SortParamsForRunsComparisonView{
-					SortBy:    langsmith.F("sort_by"),
-					SortOrder: langsmith.F(langsmith.SortParamsForRunsComparisonViewSortOrderAsc),
-				}),
-			},
-			Format: langsmith.F("format"),
+			SessionIDs:              langsmith.F([]string{"182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e"}),
+			Format:                  langsmith.F(langsmith.DatasetRunNewParamsFormatCsv),
+			ComparativeExperimentID: langsmith.F("182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e"),
+			Filters: langsmith.F(map[string][]string{
+				"foo": {"string"},
+			}),
+			Limit:   langsmith.F(int64(1)),
+			Offset:  langsmith.F(int64(0)),
+			Preview: langsmith.F(true),
+			SortParams: langsmith.F(langsmith.SortParamsForRunsComparisonView{
+				SortBy:    langsmith.F("sort_by"),
+				SortOrder: langsmith.F(langsmith.SortParamsForRunsComparisonViewSortOrderAsc),
+			}),
+			Stream: langsmith.F(true),
 		},
 	)
 	if err != nil {

example.go

@@ -257,7 +257,8 @@ func (r ExampleNewParamsSplitArray) ImplementsExampleNewParamsSplitUnion() {}
 type ExampleGetParams struct {
 	// Only modifications made on or before this time are included. If None, the latest
 	// version of the dataset is used.
-	AsOf param.Field[ExampleGetParamsAsOfUnion] `query:"as_of" format:"date-time"`
+	AsOf    param.Field[ExampleGetParamsAsOfUnion] `query:"as_of" format:"date-time"`
+	Dataset param.Field[string]                    `query:"dataset" format:"uuid"`
 }
 
 // URLQuery serializes [ExampleGetParams]'s query parameters as `url.Values`.

example_test.go

@@ -79,7 +79,8 @@ func TestExampleGetWithOptionalParams(t *testing.T) {
 		context.TODO(),
 		"182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
 		langsmith.ExampleGetParams{
-			AsOf: langsmith.F[langsmith.ExampleGetParamsAsOfUnion](shared.UnionTime(time.Now())),
+			AsOf:    langsmith.F[langsmith.ExampleGetParamsAsOfUnion](shared.UnionTime(time.Now())),
+			Dataset: langsmith.F("182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e"),
 		},
 	)
 	if err != nil {

examplevalidate.go

@@ -43,7 +43,7 @@ func (r *ExampleValidateService) New(ctx context.Context, opts ...option.Request
 	return
 }
 
-// Validate an example.
+// Validate examples in bulk.
 func (r *ExampleValidateService) Bulk(ctx context.Context, opts ...option.RequestOption) (res *[]ExampleValidationResult, err error) {
 	opts = slices.Concat(r.Options, opts)
 	path := "api/v1/examples/validate/bulk"

feedback.go

@@ -207,6 +207,7 @@ type FeedbackCreateSchemaParam struct {
 	RunID          param.Field[string]                                       `json:"run_id" format:"uuid"`
 	Score          param.Field[FeedbackCreateSchemaScoreUnionParam]          `json:"score"`
 	SessionID      param.Field[string]                                       `json:"session_id" format:"uuid"`
+	StartTime      param.Field[time.Time]                                    `json:"start_time" format:"date-time"`
 	TraceID        param.Field[string]                                       `json:"trace_id" format:"uuid"`
 	Value          param.Field[FeedbackCreateSchemaValueUnionParam]          `json:"value"`
 }

feedback_test.go

@@ -61,6 +61,7 @@ func TestFeedbackNewWithOptionalParams(t *testing.T) {
 			RunID:      langsmith.F("182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e"),
 			Score:      langsmith.F[langsmith.FeedbackCreateSchemaScoreUnionParam](shared.UnionFloat(0.000000)),
 			SessionID:  langsmith.F("182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e"),
+			StartTime:  langsmith.F(time.Now()),
 			TraceID:    langsmith.F("182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e"),
 			Value:      langsmith.F[langsmith.FeedbackCreateSchemaValueUnionParam](shared.UnionFloat(0.000000)),
 		},

internal/version.go

@@ -2,4 +2,4 @@
 
 package internal
 
-const PackageVersion = "0.1.0-alpha.4" // x-release-please-version
+const PackageVersion = "0.1.0-alpha.5" // x-release-please-version