@labelbox/recursion-sdk 0.0.154 → 0.0.155

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.
@@ -21561,7 +21561,7 @@ export const SDK_REFERENCE = {
21561
21561
  name: 'finalScore',
21562
21562
  required: true,
21563
21563
  type: 'number',
21564
- description: 'Aggregated final score in [0, 1] after grading. Null until grading completes.',
21564
+ description: 'Aggregated final score after grading. Null until grading completes.',
21565
21565
  example: 0.83,
21566
21566
  nullable: true,
21567
21567
  },
@@ -21644,6 +21644,12 @@ export const SDK_REFERENCE = {
21644
21644
  enum: ['taiga', 'v2'],
21645
21645
  nullable: true,
21646
21646
  },
21647
+ {
21648
+ name: 'hasRetainedSolverRun',
21649
+ required: false,
21650
+ type: 'boolean',
21651
+ description: 'Whether this run retains an agent-service solver workspace that can be reused for re-grading. Absent responses are treated as unavailable.',
21652
+ },
21647
21653
  {
21648
21654
  name: 'gradedAt',
21649
21655
  required: true,
@@ -21666,6 +21672,15 @@ export const SDK_REFERENCE = {
21666
21672
  description: 'Aggregated grader justification text. Null until grading completes.',
21667
21673
  nullable: true,
21668
21674
  },
21675
+ {
21676
+ name: 'regradeCount',
21677
+ required: false,
21678
+ type: 'integer',
21679
+ description: 'Number of re-grades represented by the run’s live grade-history snapshots. Absent responses are treated as zero.',
21680
+ example: 0,
21681
+ minimum: 0,
21682
+ maximum: 9007199254740991,
21683
+ },
21669
21684
  {
21670
21685
  name: 'gradingConfig',
21671
21686
  required: true,
@@ -28942,6 +28957,129 @@ export const SDK_REFERENCE = {
28942
28957
  ],
28943
28958
  },
28944
28959
  },
28960
+ listGradeHistoryForProblemRun: {
28961
+ operationId: 'listGradeHistoryForProblemRun',
28962
+ tag: 'problem-runs',
28963
+ callPath: ['problemRuns', 'listGradeHistory'],
28964
+ namespace: 'problemRuns',
28965
+ method: 'listGradeHistory',
28966
+ signature: 'rl.problemRuns.listGradeHistory({ problemRunId })',
28967
+ example: "const result = await rl.problemRuns.listGradeHistory({\n problemRunId: '<problemRunId>',\n // optional: limit, cursor\n});",
28968
+ cliInvocation: 'rl problem-runs list-grade-history',
28969
+ cliExample: 'rl problem-runs list-grade-history \\\n --problem-run-id <problemRunId>',
28970
+ curlExample: "curl -X GET 'https://api.recursion.labelbox.com/v1/problem-runs/<problemRunId>/grade-history' \\\n -H 'Authorization: Bearer $LABELBOX_API_KEY'",
28971
+ summary: 'List superseded grades for a problem run',
28972
+ description: 'Each re-grade archives the grade it replaced; this returns those superseded grades, most recent re-grade first. The run’s current grade is on the run itself.',
28973
+ httpMethod: 'get',
28974
+ path: '/v1/problem-runs/{problemRunId}/grade-history',
28975
+ requiredPermissions: ['runs:read'],
28976
+ params: [
28977
+ {
28978
+ name: 'problemRunId',
28979
+ in: 'path',
28980
+ required: true,
28981
+ type: 'string',
28982
+ description: 'Stable problem-run identifier (UUID). One solver attempt at one problem version.',
28983
+ format: 'uuid',
28984
+ },
28985
+ {
28986
+ name: 'limit',
28987
+ in: 'query',
28988
+ required: false,
28989
+ type: 'integer',
28990
+ description: 'Maximum number of items to return in the page (1-100).',
28991
+ default: 10,
28992
+ example: 20,
28993
+ minimum: 1,
28994
+ maximum: 100,
28995
+ },
28996
+ {
28997
+ name: 'cursor',
28998
+ in: 'query',
28999
+ required: false,
29000
+ type: 'string',
29001
+ description: 'Opaque cursor returned by a previous page response. Omit to fetch the first page.',
29002
+ minLength: 1,
29003
+ },
29004
+ ],
29005
+ response: {
29006
+ type: 'GradeHistoryResponseDto',
29007
+ description: 'Superseded grades for a problem run, most recent re-grade first.',
29008
+ fields: [
29009
+ {
29010
+ name: 'items',
29011
+ required: true,
29012
+ type: 'object[]',
29013
+ description: 'Items in this page, ordered per the requested sort.',
29014
+ items: {
29015
+ type: 'object',
29016
+ description: 'A superseded grade in a problem run’s re-grade history.',
29017
+ fields: [
29018
+ {
29019
+ name: 'id',
29020
+ required: true,
29021
+ type: 'string',
29022
+ description: 'Identifier of the archived grade snapshot.',
29023
+ format: 'uuid',
29024
+ },
29025
+ {
29026
+ name: 'finalScore',
29027
+ required: true,
29028
+ type: 'number',
29029
+ description: 'Aggregated final score of this superseded grade.',
29030
+ nullable: true,
29031
+ },
29032
+ {
29033
+ name: 'gradedAt',
29034
+ required: true,
29035
+ type: 'string',
29036
+ description: 'When this grade finished grading (ISO-8601, UTC).',
29037
+ format: 'date-time',
29038
+ nullable: true,
29039
+ },
29040
+ {
29041
+ name: 'justification',
29042
+ required: true,
29043
+ type: 'string',
29044
+ description: 'Aggregated grader justification of this superseded grade.',
29045
+ nullable: true,
29046
+ },
29047
+ {
29048
+ name: 'gradingModelName',
29049
+ required: true,
29050
+ type: 'string',
29051
+ description: 'Grader model recorded for this superseded grade, or null.',
29052
+ nullable: true,
29053
+ minLength: 1,
29054
+ },
29055
+ {
29056
+ name: 'archivedAt',
29057
+ required: true,
29058
+ type: 'string',
29059
+ description: 'When this grade was superseded by a re-grade (ISO-8601, UTC).',
29060
+ format: 'date-time',
29061
+ },
29062
+ ],
29063
+ },
29064
+ },
29065
+ {
29066
+ name: 'nextCursor',
29067
+ required: true,
29068
+ type: 'string',
29069
+ description: 'Cursor for fetching the next page, or null when this is the last page.',
29070
+ nullable: true,
29071
+ },
29072
+ {
29073
+ name: 'total',
29074
+ required: true,
29075
+ type: 'integer',
29076
+ description: 'Total number of items matching the filter across all pages.',
29077
+ minimum: 0,
29078
+ maximum: 9007199254740991,
29079
+ },
29080
+ ],
29081
+ },
29082
+ },
28945
29083
  listGradingSubRunsForProblemRun: {
28946
29084
  operationId: 'listGradingSubRunsForProblemRun',
28947
29085
  tag: 'problem-runs',
@@ -32022,7 +32160,7 @@ export const SDK_REFERENCE = {
32022
32160
  name: 'type',
32023
32161
  required: true,
32024
32162
  type: 'string',
32025
- description: 'Problem-run files only carry solver outputs.',
32163
+ description: 'Problem-run files carry persisted solver or grader outputs.',
32026
32164
  enum: ['output'],
32027
32165
  },
32028
32166
  {
@@ -32212,7 +32350,7 @@ export const SDK_REFERENCE = {
32212
32350
  name: 'finalScore',
32213
32351
  required: true,
32214
32352
  type: 'number',
32215
- description: 'Aggregated final score in [0, 1] after grading. Null until grading completes.',
32353
+ description: 'Aggregated final score after grading. Null until grading completes.',
32216
32354
  example: 0.83,
32217
32355
  nullable: true,
32218
32356
  },
@@ -32295,6 +32433,12 @@ export const SDK_REFERENCE = {
32295
32433
  enum: ['taiga', 'v2'],
32296
32434
  nullable: true,
32297
32435
  },
32436
+ {
32437
+ name: 'hasRetainedSolverRun',
32438
+ required: false,
32439
+ type: 'boolean',
32440
+ description: 'Whether this run retains an agent-service solver workspace that can be reused for re-grading. Absent responses are treated as unavailable.',
32441
+ },
32298
32442
  {
32299
32443
  name: 'gradedAt',
32300
32444
  required: true,
@@ -32317,6 +32461,15 @@ export const SDK_REFERENCE = {
32317
32461
  description: 'Aggregated grader justification text. Null until grading completes.',
32318
32462
  nullable: true,
32319
32463
  },
32464
+ {
32465
+ name: 'regradeCount',
32466
+ required: false,
32467
+ type: 'integer',
32468
+ description: 'Number of re-grades represented by the run’s live grade-history snapshots. Absent responses are treated as zero.',
32469
+ example: 0,
32470
+ minimum: 0,
32471
+ maximum: 9007199254740991,
32472
+ },
32320
32473
  {
32321
32474
  name: 'gradingConfig',
32322
32475
  required: true,
@@ -32875,7 +33028,7 @@ export const SDK_REFERENCE = {
32875
33028
  name: 'finalScore',
32876
33029
  required: true,
32877
33030
  type: 'number',
32878
- description: 'Aggregated final score in [0, 1] after grading. Null until grading completes.',
33031
+ description: 'Aggregated final score after grading. Null until grading completes.',
32879
33032
  example: 0.83,
32880
33033
  nullable: true,
32881
33034
  },
@@ -32958,6 +33111,12 @@ export const SDK_REFERENCE = {
32958
33111
  enum: ['taiga', 'v2'],
32959
33112
  nullable: true,
32960
33113
  },
33114
+ {
33115
+ name: 'hasRetainedSolverRun',
33116
+ required: false,
33117
+ type: 'boolean',
33118
+ description: 'Whether this run retains an agent-service solver workspace that can be reused for re-grading. Absent responses are treated as unavailable.',
33119
+ },
32961
33120
  {
32962
33121
  name: 'gradedAt',
32963
33122
  required: true,
@@ -32980,6 +33139,15 @@ export const SDK_REFERENCE = {
32980
33139
  description: 'Aggregated grader justification text. Null until grading completes.',
32981
33140
  nullable: true,
32982
33141
  },
33142
+ {
33143
+ name: 'regradeCount',
33144
+ required: false,
33145
+ type: 'integer',
33146
+ description: 'Number of re-grades represented by the run’s live grade-history snapshots. Absent responses are treated as zero.',
33147
+ example: 0,
33148
+ minimum: 0,
33149
+ maximum: 9007199254740991,
33150
+ },
32983
33151
  {
32984
33152
  name: 'gradingConfig',
32985
33153
  required: true,
@@ -58091,6 +58259,46 @@ export const SDK_REFERENCE = {
58091
58259
  ],
58092
58260
  },
58093
58261
  },
58262
+ regradeProblemRun: {
58263
+ operationId: 'regradeProblemRun',
58264
+ tag: 'problem-runs',
58265
+ callPath: ['problemRuns', 'regrade'],
58266
+ namespace: 'problemRuns',
58267
+ method: 'regrade',
58268
+ signature: 'rl.problemRuns.regrade({ problemRunId })',
58269
+ example: "const result = await rl.problemRuns.regrade({\n problemRunId: '<problemRunId>',\n});",
58270
+ cliInvocation: 'rl problem-runs regrade',
58271
+ cliExample: 'rl problem-runs regrade \\\n --problem-run-id <problemRunId>',
58272
+ curlExample: "curl -X POST 'https://api.recursion.labelbox.com/v1/problem-runs/<problemRunId>/regrade' \\\n -H 'Authorization: Bearer $LABELBOX_API_KEY'",
58273
+ summary: 'Re-grade an existing problem run',
58274
+ description: 'Enqueues an asynchronous re-grade that reuses the existing solver run — it does not re-run the solver. The response returns immediately with the new job id; poll the run to observe the new grade. The prior grade is archived and readable via the grade-history endpoint. Cancellation or an infrastructure failure before a new grade is produced restores the prior grade; a completed grading attempt whose computed outcome is failure remains the current failed outcome. The retained solver workspace it grades against expires roughly 24 hours after the run, after which a re-grade fails at the grader.',
58275
+ httpMethod: 'post',
58276
+ path: '/v1/problem-runs/{problemRunId}/regrade',
58277
+ requiredPermissions: ['runs:create'],
58278
+ params: [
58279
+ {
58280
+ name: 'problemRunId',
58281
+ in: 'path',
58282
+ required: true,
58283
+ type: 'string',
58284
+ description: 'Stable problem-run identifier (UUID). One solver attempt at one problem version.',
58285
+ format: 'uuid',
58286
+ },
58287
+ ],
58288
+ response: {
58289
+ type: 'RegradeProblemRunResponseDto',
58290
+ description: 'Result of enqueueing a re-grade of an existing problem run.',
58291
+ fields: [
58292
+ {
58293
+ name: 'jobV2Id',
58294
+ required: true,
58295
+ type: 'string',
58296
+ description: 'New jobs-v2 root job id, a regrade orchestration root. Use the jobs-v2 surface to poll status or cancel; the problem run is re-graded in place.',
58297
+ format: 'uuid',
58298
+ },
58299
+ ],
58300
+ },
58301
+ },
58094
58302
  requestQaStageClearance: {
58095
58303
  operationId: 'requestQaStageClearance',
58096
58304
  tag: 'qa-gates',
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@labelbox/recursion-sdk",
3
- "version": "0.0.154",
3
+ "version": "0.0.155",
4
4
  "type": "module",
5
5
  "main": "./dist/index.js",
6
6
  "types": "./dist/index.d.ts",