@rig-c/review 2.7.1 → 3.7.0
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/docs/DESIGN.md +1 -1
- package/docs/REVIEW_PACKAGE.md +29 -13
- package/docs/STABILITY.md +81 -5
- package/docs/WORKFLOWS.md +2 -2
- package/package.json +3 -3
- package/skills/rig-review/SKILL.md +1 -1
- package/src/build.ts +10 -2
- package/src/front.ts +2 -1
- package/src/interview-project.ts +173 -10
- package/src/job-act.ts +59 -11
- package/src/job-api.ts +194 -13
- package/src/job-contract.ts +118 -8
- package/src/job-front.ts +165 -26
- package/src/job-host.ts +118 -1
- package/src/job-session.ts +193 -46
- package/src/job-source.ts +88 -16
- package/src/open-workspace-launch.ts +2 -2
- package/src/open.ts +2 -1
- package/src/versions.ts +7 -7
- package/web/catalog-en.ts +2 -1
- package/web/catalog-ko.ts +2 -1
- package/web/job-session.ts +483 -84
package/src/job-api.ts
CHANGED
|
@@ -5,7 +5,8 @@ import {
|
|
|
5
5
|
JOB_RESERVED_ACT_KINDS,
|
|
6
6
|
type AgentRequestV3, type FetchActRequestV3, type JobAgentRequest, type JobApiSchema,
|
|
7
7
|
type JobDisplayAcknowledgment, type JobErrorCode, type JobFetchActRequest, type JobFileIdentity,
|
|
8
|
-
type JobHostPorts, type JobHumanAuthority, type
|
|
8
|
+
type JobHostPorts, type JobHumanAuthority, type JobInterviewDiagnostic, type JobInterviewDiagnostics,
|
|
9
|
+
type JobInterviewJson, type JobInterviewRecord, type JobPlanIdentity, type JobPublicationMode,
|
|
9
10
|
type JobPublishRequest, type JobResult, type JobSelector, type JobSha256, type JobSubject,
|
|
10
11
|
type OptionContext, type OptionSource, type PlanContext, type PlanSource, type ProjectRecord,
|
|
11
12
|
type PublishRequestV3, type PublishResultV3, type RecordAct, type RecordFreeze,
|
|
@@ -16,6 +17,13 @@ import {
|
|
|
16
17
|
import { JobError } from './job-store.ts';
|
|
17
18
|
import type { JobSession } from './job-session.ts';
|
|
18
19
|
|
|
20
|
+
export type {
|
|
21
|
+
JobInterviewJson,
|
|
22
|
+
JobInterviewRecord,
|
|
23
|
+
JobInterviewDiagnostic,
|
|
24
|
+
JobInterviewDiagnostics,
|
|
25
|
+
} from './job-contract.ts';
|
|
26
|
+
|
|
19
27
|
export const jobBodyLimit = 256 * 1024;
|
|
20
28
|
export const jobWaitLimitMs = 30_000;
|
|
21
29
|
const requestDeadlineMs = 10_000;
|
|
@@ -219,7 +227,12 @@ export function parseRecordSubject(value: unknown): RecordSubject {
|
|
|
219
227
|
if ((JOB_RESERVED_ACT_KINDS as readonly unknown[]).includes(item.kind)) {
|
|
220
228
|
throw new JobError('JOB_ACT_KIND_DISABLED');
|
|
221
229
|
}
|
|
222
|
-
if (
|
|
230
|
+
if (
|
|
231
|
+
item.kind !== 'interview-picks' &&
|
|
232
|
+
item.kind !== 'checkpoint' &&
|
|
233
|
+
item.kind !== 'signoff' &&
|
|
234
|
+
item.kind !== 'reopen'
|
|
235
|
+
) {
|
|
223
236
|
throw new JobError('JOB_ASK_INVALID');
|
|
224
237
|
}
|
|
225
238
|
switch (item.kind) {
|
|
@@ -237,6 +250,9 @@ export function parseRecordSubject(value: unknown): RecordSubject {
|
|
|
237
250
|
}
|
|
238
251
|
return { kind: 'signoff', stage: stage as RecordSignoffStage };
|
|
239
252
|
}
|
|
253
|
+
case 'reopen':
|
|
254
|
+
jobObject(item, ['kind', 'stage']);
|
|
255
|
+
return { kind: 'reopen', stage: jobId(item.stage) };
|
|
240
256
|
}
|
|
241
257
|
}
|
|
242
258
|
|
|
@@ -248,6 +264,10 @@ export function parseJobRequest(
|
|
|
248
264
|
value: unknown,
|
|
249
265
|
mode: typeof JOB_API_V3_SCHEMA | 'record-and-package',
|
|
250
266
|
): AgentRequestV3 | FetchActRequestV3;
|
|
267
|
+
export function parseJobRequest(
|
|
268
|
+
value: unknown,
|
|
269
|
+
mode: JobApiSchema | JobPublicationMode,
|
|
270
|
+
): JobAgentRequest | JobFetchActRequest | AgentRequestV3 | FetchActRequestV3;
|
|
251
271
|
export function parseJobRequest(
|
|
252
272
|
value: unknown,
|
|
253
273
|
mode: JobApiSchema | JobPublicationMode = JOB_API_SCHEMA,
|
|
@@ -299,9 +319,20 @@ export function parseJobRequest(
|
|
|
299
319
|
};
|
|
300
320
|
return parsedRecordPublish;
|
|
301
321
|
}
|
|
302
|
-
case 'ask':
|
|
322
|
+
case 'ask': {
|
|
303
323
|
jobObject(item, ['schema', 'jobId', 'requestId', 'verb', 'expectedGeneration', 'idempotencyKey', 'publicationId', 'subject']);
|
|
304
|
-
|
|
324
|
+
const isReopenSubject =
|
|
325
|
+
item.subject !== null &&
|
|
326
|
+
typeof item.subject === 'object' &&
|
|
327
|
+
!Array.isArray(item.subject) &&
|
|
328
|
+
(item.subject as { kind?: unknown }).kind === 'reopen';
|
|
329
|
+
return {
|
|
330
|
+
...mutation,
|
|
331
|
+
verb: 'ask',
|
|
332
|
+
publicationId: jobId(item.publicationId),
|
|
333
|
+
subject: isReopenSubject ? parseRecordSubject(item.subject) : parseJobSubject(item.subject),
|
|
334
|
+
};
|
|
335
|
+
}
|
|
305
336
|
case 'close':
|
|
306
337
|
jobObject(item, ['schema', 'jobId', 'requestId', 'verb', 'expectedGeneration', 'idempotencyKey', 'reason']);
|
|
307
338
|
return { ...mutation, verb: 'close', reason: jobText(item.reason, 1024) };
|
|
@@ -377,6 +408,119 @@ function parseFileRow(value: unknown, code: JobErrorCode): JobFileIdentity {
|
|
|
377
408
|
return asCode(() => ({ path: jobPath(item.path), sha256: jobSha(item.sha256) }), code);
|
|
378
409
|
}
|
|
379
410
|
|
|
411
|
+
function parseInterviewJson(value: unknown, code: JobErrorCode, depth = 0): JobInterviewJson {
|
|
412
|
+
if (depth > 32) throw new JobError(code);
|
|
413
|
+
if (value === null || typeof value === 'boolean' || typeof value === 'string') return value;
|
|
414
|
+
if (typeof value === 'number') {
|
|
415
|
+
if (!Number.isFinite(value)) throw new JobError(code);
|
|
416
|
+
return value;
|
|
417
|
+
}
|
|
418
|
+
if (Array.isArray(value)) {
|
|
419
|
+
return value.map(entry => parseInterviewJson(entry, code, depth + 1));
|
|
420
|
+
}
|
|
421
|
+
if (typeof value === 'object') {
|
|
422
|
+
return Object.fromEntries(
|
|
423
|
+
Object.entries(value as Record<string, unknown>).map(([key, child]) => [
|
|
424
|
+
key,
|
|
425
|
+
parseInterviewJson(child, code, depth + 1),
|
|
426
|
+
]),
|
|
427
|
+
);
|
|
428
|
+
}
|
|
429
|
+
throw new JobError(code);
|
|
430
|
+
}
|
|
431
|
+
|
|
432
|
+
function parseInterviewJsonObject(
|
|
433
|
+
value: unknown,
|
|
434
|
+
code: JobErrorCode,
|
|
435
|
+
): { readonly [key: string]: JobInterviewJson } {
|
|
436
|
+
if (value === null || typeof value !== 'object' || Array.isArray(value)) {
|
|
437
|
+
throw new JobError(code);
|
|
438
|
+
}
|
|
439
|
+
return parseInterviewJson(value, code) as { readonly [key: string]: JobInterviewJson };
|
|
440
|
+
}
|
|
441
|
+
|
|
442
|
+
export function parseJobInterviewDiagnostics(
|
|
443
|
+
value: unknown,
|
|
444
|
+
code: JobErrorCode = 'JOB_REQUEST_INVALID',
|
|
445
|
+
): JobInterviewDiagnostics | null | undefined {
|
|
446
|
+
if (value === undefined) return undefined;
|
|
447
|
+
if (value === null) return null;
|
|
448
|
+
const item = exactObject(
|
|
449
|
+
value,
|
|
450
|
+
['schema', 'project', 'evaluatedAt', 'records', 'diagnostics'],
|
|
451
|
+
code,
|
|
452
|
+
);
|
|
453
|
+
if (item.schema !== 'rig-review/job-interview@1') throw new JobError(code);
|
|
454
|
+
const project = asCode(() => parseProjectRecord(item.project, code), code);
|
|
455
|
+
const evaluatedAt = asCode(() => jobText(item.evaluatedAt), code);
|
|
456
|
+
if (!Number.isFinite(Date.parse(evaluatedAt))) throw new JobError(code);
|
|
457
|
+
if (!Array.isArray(item.records) || item.records.length > maxRecordFiles ||
|
|
458
|
+
!Array.isArray(item.diagnostics) || item.diagnostics.length > maxRecordFiles) {
|
|
459
|
+
throw new JobError(code);
|
|
460
|
+
}
|
|
461
|
+
const recordsByLocator = new Map<string, JobInterviewRecord>();
|
|
462
|
+
const records: JobInterviewRecord[] = item.records.map(rawRow => {
|
|
463
|
+
const row = exactObject(
|
|
464
|
+
rawRow,
|
|
465
|
+
['questionId', 'record', 'setId', 'ref', 'observedSet', 'timeKind', 'at', 'original'],
|
|
466
|
+
code,
|
|
467
|
+
);
|
|
468
|
+
const questionId = asCode(() => jobId(row.questionId), code);
|
|
469
|
+
const record = asCode(() => jobText(row.record, 256), code);
|
|
470
|
+
if (recordsByLocator.has(record)) throw new JobError(code);
|
|
471
|
+
const setId = row.setId === null ? null : asCode(() => jobId(row.setId), code);
|
|
472
|
+
const ref = parseFileRow(row.ref, code);
|
|
473
|
+
const observedSet = row.observedSet === null ? null : parseFileRow(row.observedSet, code);
|
|
474
|
+
if (row.timeKind !== 'inspection' && row.timeKind !== 'answer' && row.timeKind !== 'decision') {
|
|
475
|
+
throw new JobError(code);
|
|
476
|
+
}
|
|
477
|
+
const timeKind = row.timeKind;
|
|
478
|
+
const at = row.at === null ? null : asCode(() => jobText(row.at), code);
|
|
479
|
+
if (timeKind === 'inspection') {
|
|
480
|
+
if (at !== evaluatedAt || row.original !== null) throw new JobError(code);
|
|
481
|
+
const parsed: JobInterviewRecord = { questionId, record, setId, ref, observedSet, timeKind, at, original: null };
|
|
482
|
+
recordsByLocator.set(record, parsed);
|
|
483
|
+
return parsed;
|
|
484
|
+
}
|
|
485
|
+
const original = parseInterviewJsonObject(row.original, code);
|
|
486
|
+
if (timeKind === 'decision') {
|
|
487
|
+
const completed = ['at', 'value', 'fragments'].some(key => Object.hasOwn(original, key));
|
|
488
|
+
if (!completed && at !== null) throw new JobError(code);
|
|
489
|
+
}
|
|
490
|
+
const parsed: JobInterviewRecord = { questionId, record, setId, ref, observedSet, timeKind, at, original };
|
|
491
|
+
recordsByLocator.set(record, parsed);
|
|
492
|
+
return parsed;
|
|
493
|
+
});
|
|
494
|
+
const seenDiagnosticRecords = new Set<string>();
|
|
495
|
+
const diagnostics: JobInterviewDiagnostic[] = item.diagnostics.map(rawDiag => {
|
|
496
|
+
const diag = exactObject(rawDiag, ['record', 'at', 'code', 'severity'], code);
|
|
497
|
+
const record = asCode(() => jobText(diag.record, 256), code);
|
|
498
|
+
const at = diag.at === null ? null : asCode(() => jobText(diag.at), code);
|
|
499
|
+
if (seenDiagnosticRecords.has(record)) throw new JobError(code);
|
|
500
|
+
const matching = recordsByLocator.get(record);
|
|
501
|
+
if (!matching || matching.at !== at) throw new JobError(code);
|
|
502
|
+
if (matching.timeKind === 'decision' && matching.original &&
|
|
503
|
+
!['at', 'value', 'fragments'].some(key => Object.hasOwn(matching.original!, key))) {
|
|
504
|
+
throw new JobError(code);
|
|
505
|
+
}
|
|
506
|
+
seenDiagnosticRecords.add(record);
|
|
507
|
+
if (diag.code === 'INTERVIEW_OPTIONS_STALE' && diag.severity === 'error') {
|
|
508
|
+
return { record, at, code: 'INTERVIEW_OPTIONS_STALE', severity: 'error' };
|
|
509
|
+
}
|
|
510
|
+
if (diag.code === 'INTERVIEW_OPTIONS_SCENE_LEGACY' && diag.severity === 'warning') {
|
|
511
|
+
return { record, at, code: 'INTERVIEW_OPTIONS_SCENE_LEGACY', severity: 'warning' };
|
|
512
|
+
}
|
|
513
|
+
throw new JobError(code);
|
|
514
|
+
});
|
|
515
|
+
return {
|
|
516
|
+
schema: 'rig-review/job-interview@1',
|
|
517
|
+
project,
|
|
518
|
+
evaluatedAt,
|
|
519
|
+
records,
|
|
520
|
+
diagnostics,
|
|
521
|
+
};
|
|
522
|
+
}
|
|
523
|
+
|
|
380
524
|
function parseFileClosure(
|
|
381
525
|
rawInputs: unknown,
|
|
382
526
|
rawFiles: unknown,
|
|
@@ -440,9 +584,6 @@ function parsePlanSubjects(
|
|
|
440
584
|
if (!Array.isArray(rawSubjects) || rawSubjects.length > maxRecordFiles) {
|
|
441
585
|
throw new JobError(code);
|
|
442
586
|
}
|
|
443
|
-
if (rawSubjects.length > 0 && stepIds.size === 0) {
|
|
444
|
-
throw new JobError(code);
|
|
445
|
-
}
|
|
446
587
|
const seen = new Set<string>();
|
|
447
588
|
return rawSubjects.map(raw => {
|
|
448
589
|
const parsed = asCode(() => parseRecordSubject(raw), code);
|
|
@@ -454,6 +595,13 @@ function parsePlanSubjects(
|
|
|
454
595
|
seen.add(key);
|
|
455
596
|
return { kind: 'checkpoint', checkpointId: parsed.checkpointId };
|
|
456
597
|
}
|
|
598
|
+
if (parsed.kind === 'reopen') {
|
|
599
|
+
const key = `reopen:${parsed.stage}`;
|
|
600
|
+
if (seen.has(key)) throw new JobError(code);
|
|
601
|
+
seen.add(key);
|
|
602
|
+
return { kind: 'reopen', stage: parsed.stage };
|
|
603
|
+
}
|
|
604
|
+
if (stepIds.size === 0) throw new JobError(code);
|
|
457
605
|
const key = `signoff:${parsed.stage}`;
|
|
458
606
|
if (seen.has(key)) throw new JobError(code);
|
|
459
607
|
seen.add(key);
|
|
@@ -872,14 +1020,17 @@ export function validateRecordAskSubject(subject: unknown, source: RecordSource)
|
|
|
872
1020
|
}
|
|
873
1021
|
return parsed;
|
|
874
1022
|
}
|
|
875
|
-
if (
|
|
1023
|
+
if (
|
|
1024
|
+
parsed.kind === 'interview-picks' ||
|
|
1025
|
+
((parsed.kind === 'checkpoint' || parsed.kind === 'signoff') && checkedSource.plan.steps.length === 0)
|
|
1026
|
+
) {
|
|
876
1027
|
throw new JobError('JOB_ASK_INVALID');
|
|
877
1028
|
}
|
|
878
1029
|
const declared = checkedSource.subjects.some(candidate =>
|
|
879
1030
|
candidate.kind === parsed.kind &&
|
|
880
1031
|
(candidate.kind === 'checkpoint'
|
|
881
1032
|
? candidate.checkpointId === (parsed as Extract<RecordPlanSubject, { kind: 'checkpoint' }>).checkpointId
|
|
882
|
-
: candidate.stage === (parsed as Extract<RecordPlanSubject, { kind: 'signoff' }>).stage),
|
|
1033
|
+
: candidate.stage === (parsed as Extract<RecordPlanSubject, { kind: 'signoff' | 'reopen' }>).stage),
|
|
883
1034
|
);
|
|
884
1035
|
if (!declared) throw new JobError('JOB_ASK_INVALID');
|
|
885
1036
|
return parsed;
|
|
@@ -993,6 +1144,25 @@ export function parseRecordAct(value: unknown): RecordAct {
|
|
|
993
1144
|
value: { stage: stage as RecordSignoffStage, decision: 'approved', words },
|
|
994
1145
|
};
|
|
995
1146
|
}
|
|
1147
|
+
case 'reopen': {
|
|
1148
|
+
if (source.subject !== 'plan') throw new JobError('JOB_ACT_INVALID');
|
|
1149
|
+
const rawValue = exactObject(item.value, ['stage', 'words'], 'JOB_ACT_INVALID');
|
|
1150
|
+
const stage = asCode(() => jobId(rawValue.stage), 'JOB_ACT_INVALID');
|
|
1151
|
+
asCode(() => validateRecordAskSubject({ kind: 'reopen', stage }, source), 'JOB_ACT_INVALID');
|
|
1152
|
+
const words = parseActWords(rawValue.words, 'JOB_ACT_INVALID');
|
|
1153
|
+
return {
|
|
1154
|
+
schema: JOB_RECORD_ACT_SCHEMA,
|
|
1155
|
+
actId,
|
|
1156
|
+
jobId: jobIdValue,
|
|
1157
|
+
askId,
|
|
1158
|
+
publicationId,
|
|
1159
|
+
kind: 'reopen',
|
|
1160
|
+
authority,
|
|
1161
|
+
at,
|
|
1162
|
+
source,
|
|
1163
|
+
value: { stage, words },
|
|
1164
|
+
};
|
|
1165
|
+
}
|
|
996
1166
|
}
|
|
997
1167
|
throw new JobError('JOB_ACT_INVALID');
|
|
998
1168
|
}
|
|
@@ -1069,10 +1239,21 @@ export function createJobHostPorts(session: JobSession, origin: string): JobHost
|
|
|
1069
1239
|
}
|
|
1070
1240
|
return {
|
|
1071
1241
|
async handleJobApi(request) {
|
|
1072
|
-
let input: JobAgentRequest | JobFetchActRequest | null = null;
|
|
1242
|
+
let input: JobAgentRequest | AgentRequestV3 | JobFetchActRequest | FetchActRequestV3 | null = null;
|
|
1243
|
+
let responseSchema: typeof JOB_API_SCHEMA | typeof JOB_API_V3_SCHEMA = session.apiSchema;
|
|
1073
1244
|
try {
|
|
1074
1245
|
gate(request, base + '/api', false);
|
|
1075
|
-
|
|
1246
|
+
const body = await jobBody(request);
|
|
1247
|
+
const mode: JobPublicationMode =
|
|
1248
|
+
session.publicationMode === 'record-and-package' &&
|
|
1249
|
+
body !== null &&
|
|
1250
|
+
typeof body === 'object' &&
|
|
1251
|
+
!Array.isArray(body) &&
|
|
1252
|
+
(body as { schema?: unknown }).schema === JOB_API_SCHEMA
|
|
1253
|
+
? 'package-only'
|
|
1254
|
+
: session.publicationMode;
|
|
1255
|
+
responseSchema = jobApiSchemaForMode(mode);
|
|
1256
|
+
input = parseJobRequest(body, mode);
|
|
1076
1257
|
if (input.jobId !== session.jobId) throw new JobError('JOB_UNKNOWN');
|
|
1077
1258
|
session.authorize(input.verb === 'fetch-act' ? 'consumer' : 'agent', request.headers.get('authorization'));
|
|
1078
1259
|
if (input.verb === 'fetch-act') {
|
|
@@ -1086,13 +1267,13 @@ export function createJobHostPorts(session: JobSession, origin: string): JobHost
|
|
|
1086
1267
|
if (accept && accept !== '*/*' && accept !== 'application/json') throw new JobError('JOB_REQUEST_INVALID');
|
|
1087
1268
|
}
|
|
1088
1269
|
const value = await session.execute(input, request.signal);
|
|
1089
|
-
return Response.json({ schema:
|
|
1270
|
+
return Response.json({ schema: responseSchema, verb: input.verb, jobId: input.jobId, requestId: input.requestId,
|
|
1090
1271
|
generation: session.status().generation, ok: true, value }, { headers: responseHeaders });
|
|
1091
1272
|
} catch (error) {
|
|
1092
1273
|
const failure = jobFailure(error);
|
|
1093
1274
|
const status = failure.error.code.includes('CAPABILITY') || failure.error.code === 'JOB_AUTHORITY_REFUSED' ? 403 :
|
|
1094
1275
|
failure.error.code === 'JOB_BODY_LIMIT' ? 413 : failure.error.code === 'JOB_REQUEST_INVALID' ? 400 : 409;
|
|
1095
|
-
return Response.json({ schema:
|
|
1276
|
+
return Response.json({ schema: responseSchema, verb: input?.verb ?? null, jobId: session.jobId,
|
|
1096
1277
|
requestId: input?.requestId ?? null, generation: session.lastObservedGeneration, ...failure }, { status, headers: responseHeaders });
|
|
1097
1278
|
}
|
|
1098
1279
|
},
|
package/src/job-contract.ts
CHANGED
|
@@ -29,7 +29,7 @@ export type JobApiSchema = typeof JOB_API_SCHEMA | typeof JOB_API_V3_SCHEMA;
|
|
|
29
29
|
export const jobStillByteLimit = 8 * 1024 * 1024;
|
|
30
30
|
export const jobCaptureBodyLimit = 12 * 1024 * 1024;
|
|
31
31
|
export const jobRawActMediaType = 'application/vnd.rig-review.act+json';
|
|
32
|
-
export const JOB_PARTS_ENUMERATOR_RANGE = '>=2.25.0 <
|
|
32
|
+
export const JOB_PARTS_ENUMERATOR_RANGE = '>=2.25.0 <4.0.0' as const;
|
|
33
33
|
|
|
34
34
|
export const JOB_ENABLED_ACT_KINDS = [
|
|
35
35
|
'interview-picks',
|
|
@@ -39,8 +39,16 @@ export const JOB_ENABLED_ACT_KINDS = [
|
|
|
39
39
|
'signoff',
|
|
40
40
|
] as const;
|
|
41
41
|
|
|
42
|
+
export const JOB_RECORD_ACT_KINDS = [
|
|
43
|
+
'interview-picks',
|
|
44
|
+
'checkpoint',
|
|
45
|
+
'signoff',
|
|
46
|
+
'reopen',
|
|
47
|
+
] as const;
|
|
48
|
+
|
|
42
49
|
export const JOB_RESERVED_ACT_KINDS = ['described-correction', 'mesh-edit'] as const;
|
|
43
50
|
export type JobEnabledActKind = typeof JOB_ENABLED_ACT_KINDS[number];
|
|
51
|
+
export type RecordActKind = typeof JOB_RECORD_ACT_KINDS[number];
|
|
44
52
|
export type JobReservedActKind = typeof JOB_RESERVED_ACT_KINDS[number];
|
|
45
53
|
export type JobActKind = JobEnabledActKind | JobReservedActKind;
|
|
46
54
|
|
|
@@ -384,6 +392,47 @@ export interface JobPendingAsk {
|
|
|
384
392
|
readonly status: 'pending' | 'answered' | 'superseded';
|
|
385
393
|
}
|
|
386
394
|
|
|
395
|
+
export type JobInterviewJson =
|
|
396
|
+
| null
|
|
397
|
+
| boolean
|
|
398
|
+
| number
|
|
399
|
+
| string
|
|
400
|
+
| readonly JobInterviewJson[]
|
|
401
|
+
| { readonly [key: string]: JobInterviewJson };
|
|
402
|
+
|
|
403
|
+
export interface JobInterviewRecord {
|
|
404
|
+
readonly questionId: string;
|
|
405
|
+
readonly record: string;
|
|
406
|
+
readonly setId: string | null;
|
|
407
|
+
readonly ref: JobFileIdentity;
|
|
408
|
+
readonly observedSet: JobFileIdentity | null;
|
|
409
|
+
readonly timeKind: 'inspection' | 'answer' | 'decision';
|
|
410
|
+
readonly at: string | null;
|
|
411
|
+
readonly original: { readonly [key: string]: JobInterviewJson } | null;
|
|
412
|
+
}
|
|
413
|
+
|
|
414
|
+
export type JobInterviewDiagnostic = {
|
|
415
|
+
readonly record: string;
|
|
416
|
+
readonly at: string | null;
|
|
417
|
+
} & (
|
|
418
|
+
| {
|
|
419
|
+
readonly code: 'INTERVIEW_OPTIONS_STALE';
|
|
420
|
+
readonly severity: 'error';
|
|
421
|
+
}
|
|
422
|
+
| {
|
|
423
|
+
readonly code: 'INTERVIEW_OPTIONS_SCENE_LEGACY';
|
|
424
|
+
readonly severity: 'warning';
|
|
425
|
+
}
|
|
426
|
+
);
|
|
427
|
+
|
|
428
|
+
export interface JobInterviewDiagnostics {
|
|
429
|
+
readonly schema: 'rig-review/job-interview@1';
|
|
430
|
+
readonly project: JobFileIdentity;
|
|
431
|
+
readonly evaluatedAt: string;
|
|
432
|
+
readonly records: readonly JobInterviewRecord[];
|
|
433
|
+
readonly diagnostics: readonly JobInterviewDiagnostic[];
|
|
434
|
+
}
|
|
435
|
+
|
|
387
436
|
export interface JobPublication {
|
|
388
437
|
readonly publicationId: JobPublicationId;
|
|
389
438
|
readonly instanceKey: JobSha256;
|
|
@@ -395,6 +444,7 @@ export interface JobPublication {
|
|
|
395
444
|
readonly status: 'unavailable';
|
|
396
445
|
readonly code: string;
|
|
397
446
|
};
|
|
447
|
+
readonly interview?: JobInterviewDiagnostics | null;
|
|
398
448
|
}
|
|
399
449
|
|
|
400
450
|
export interface JobStatus {
|
|
@@ -607,9 +657,9 @@ export interface JobHostPorts {
|
|
|
607
657
|
readonly jobId: JobId;
|
|
608
658
|
readonly after: JobCursor | null;
|
|
609
659
|
readonly signal: AbortSignal;
|
|
610
|
-
}): AsyncIterable<
|
|
611
|
-
readPublication(jobId: JobId, publicationId: JobPublicationId): Promise<JobResult<
|
|
612
|
-
commitUIAct(jobId: JobId, request: Request): Promise<JobResult<
|
|
660
|
+
}): AsyncIterable<EventV3>;
|
|
661
|
+
readPublication(jobId: JobId, publicationId: JobPublicationId): Promise<JobResult<DisplayPublicationV3>>;
|
|
662
|
+
commitUIAct(jobId: JobId, request: Request): Promise<JobResult<ActV3>>;
|
|
613
663
|
ackDisplayed(jobId: JobId, request: Request): Promise<JobResult<JobDisplayReceipt>>;
|
|
614
664
|
jobLiveness(jobId: JobId): Promise<JobResult<{
|
|
615
665
|
readonly active: boolean;
|
|
@@ -690,8 +740,9 @@ export type PublishRequestV3 = Omit<JobPublishRequest, 'schema' | 'result' | 'fr
|
|
|
690
740
|
}
|
|
691
741
|
);
|
|
692
742
|
|
|
693
|
-
export type AskRequestV3 = Omit<JobAskRequest, 'schema'> & {
|
|
743
|
+
export type AskRequestV3 = Omit<JobAskRequest, 'schema' | 'subject'> & {
|
|
694
744
|
readonly schema: typeof JOB_API_V3_SCHEMA;
|
|
745
|
+
readonly subject: JobSubject | RecordSubject;
|
|
695
746
|
};
|
|
696
747
|
|
|
697
748
|
export type NextRequestV3 = Omit<JobNextRequest, 'schema'> & {
|
|
@@ -730,7 +781,12 @@ export interface RecordSignoffSubject {
|
|
|
730
781
|
readonly stage: RecordSignoffStage;
|
|
731
782
|
}
|
|
732
783
|
|
|
733
|
-
export
|
|
784
|
+
export interface RecordReopenSubject {
|
|
785
|
+
readonly kind: 'reopen';
|
|
786
|
+
readonly stage: JobId;
|
|
787
|
+
}
|
|
788
|
+
|
|
789
|
+
export type RecordPlanSubject = RecordCheckpointSubject | RecordSignoffSubject | RecordReopenSubject;
|
|
734
790
|
export type RecordSubject = RecordPicksSubject | RecordPlanSubject;
|
|
735
791
|
|
|
736
792
|
export interface RecordPartsIdentity {
|
|
@@ -781,6 +837,15 @@ export interface RecordHostHooks {
|
|
|
781
837
|
}
|
|
782
838
|
|
|
783
839
|
export interface RecordSourceBase {
|
|
840
|
+
readonly package?: never;
|
|
841
|
+
readonly selector?: never;
|
|
842
|
+
readonly model?: never;
|
|
843
|
+
readonly direction?: never;
|
|
844
|
+
readonly appliedResult?: never;
|
|
845
|
+
readonly parts?: never;
|
|
846
|
+
readonly imageSet?: never;
|
|
847
|
+
readonly imageSetDigest?: never;
|
|
848
|
+
readonly duplicateHashes?: never;
|
|
784
849
|
readonly sourceHash: JobSha256;
|
|
785
850
|
readonly projectHash: JobSha256;
|
|
786
851
|
readonly record: ProjectRecord;
|
|
@@ -812,6 +877,34 @@ export type RecordSignoffValue = Omit<JobActValues['signoff'], 'stage'> & {
|
|
|
812
877
|
readonly stage: RecordSignoffStage;
|
|
813
878
|
};
|
|
814
879
|
|
|
880
|
+
export interface RecordReopenValue {
|
|
881
|
+
readonly stage: JobId;
|
|
882
|
+
readonly words: string;
|
|
883
|
+
}
|
|
884
|
+
|
|
885
|
+
export interface RecordUIActValues {
|
|
886
|
+
readonly 'interview-picks': JobUIActValues['interview-picks'];
|
|
887
|
+
readonly checkpoint: JobUIActValues['checkpoint'];
|
|
888
|
+
readonly signoff: JobUIActValues['signoff'];
|
|
889
|
+
readonly reopen: RecordReopenValue;
|
|
890
|
+
}
|
|
891
|
+
|
|
892
|
+
export type RecordUISubmission = {
|
|
893
|
+
[Kind in keyof RecordUIActValues]: {
|
|
894
|
+
readonly publicationId: JobPublicationId;
|
|
895
|
+
readonly askId: JobAskId;
|
|
896
|
+
readonly pageId: string;
|
|
897
|
+
readonly displayedNonce: string;
|
|
898
|
+
readonly expectedGeneration: number;
|
|
899
|
+
readonly submissionId: string;
|
|
900
|
+
readonly kind: Kind;
|
|
901
|
+
readonly value: RecordUIActValues[Kind];
|
|
902
|
+
readonly capture?: never;
|
|
903
|
+
};
|
|
904
|
+
}[keyof RecordUIActValues];
|
|
905
|
+
|
|
906
|
+
export type UISubmissionV3 = JobUISubmission | RecordUISubmission;
|
|
907
|
+
|
|
815
908
|
export type RecordAct = Pick<JobLegacyAct,
|
|
816
909
|
'actId' | 'jobId' | 'askId' | 'publicationId' | 'authority' | 'at'> & {
|
|
817
910
|
readonly schema: typeof JOB_RECORD_ACT_SCHEMA;
|
|
@@ -831,6 +924,11 @@ export type RecordAct = Pick<JobLegacyAct,
|
|
|
831
924
|
readonly source: PlanSource;
|
|
832
925
|
readonly value: RecordSignoffValue;
|
|
833
926
|
}
|
|
927
|
+
| {
|
|
928
|
+
readonly kind: 'reopen';
|
|
929
|
+
readonly source: PlanSource;
|
|
930
|
+
readonly value: RecordReopenValue;
|
|
931
|
+
}
|
|
834
932
|
);
|
|
835
933
|
|
|
836
934
|
export type SourceV3 = JobSourceBinding | RecordSource;
|
|
@@ -847,7 +945,8 @@ export const JOB_CAPABILITIES_V3: JobCapabilitiesV3 = Object.freeze({
|
|
|
847
945
|
recordActSchema: JOB_RECORD_ACT_SCHEMA,
|
|
848
946
|
});
|
|
849
947
|
|
|
850
|
-
export interface PendingAskV3 extends Omit<JobPendingAsk, 'source'> {
|
|
948
|
+
export interface PendingAskV3 extends Omit<JobPendingAsk, 'subject' | 'source'> {
|
|
949
|
+
readonly subject: JobSubject | RecordSubject;
|
|
851
950
|
readonly source: SourceV3;
|
|
852
951
|
}
|
|
853
952
|
|
|
@@ -855,6 +954,10 @@ export interface PublicationV3 extends Omit<JobPublication, 'source'> {
|
|
|
855
954
|
readonly source: SourceV3;
|
|
856
955
|
}
|
|
857
956
|
|
|
957
|
+
export interface DisplayPublicationV3 extends Omit<JobDisplayPublication, 'publication'> {
|
|
958
|
+
readonly publication: PublicationV3;
|
|
959
|
+
}
|
|
960
|
+
|
|
858
961
|
export interface StatusV3 extends Omit<JobStatus, 'publication' | 'pending'> {
|
|
859
962
|
readonly publication: PublicationV3 | null;
|
|
860
963
|
readonly pending: readonly PendingAskV3[];
|
|
@@ -872,7 +975,7 @@ export type EventV3 = {
|
|
|
872
975
|
);
|
|
873
976
|
|
|
874
977
|
export interface NextValueV3 {
|
|
875
|
-
readonly capabilities?: JobCapabilitiesV3;
|
|
978
|
+
readonly capabilities?: JobCapabilities | JobCapabilitiesV3;
|
|
876
979
|
readonly events: readonly EventV3[];
|
|
877
980
|
readonly cursor: JobCursor | null;
|
|
878
981
|
readonly status: 'events' | 'timeout' | 'closed';
|
|
@@ -912,8 +1015,10 @@ export type JobRecordPicksSubject = RecordPicksSubject;
|
|
|
912
1015
|
export type JobRecordCheckpointSubject = RecordCheckpointSubject;
|
|
913
1016
|
export type JobRecordSignoffStage = RecordSignoffStage;
|
|
914
1017
|
export type JobRecordSignoffSubject = RecordSignoffSubject;
|
|
1018
|
+
export type JobRecordReopenSubject = RecordReopenSubject;
|
|
915
1019
|
export type JobRecordPlanSubject = RecordPlanSubject;
|
|
916
1020
|
export type JobRecordSubject = RecordSubject;
|
|
1021
|
+
export type JobRecordActKind = RecordActKind;
|
|
917
1022
|
export type JobRecordPartsIdentity = RecordPartsIdentity;
|
|
918
1023
|
export type JobRecordContextBase = RecordContextBase;
|
|
919
1024
|
export type JobOptionContext = OptionContext;
|
|
@@ -927,11 +1032,16 @@ export type JobOptionSource = OptionSource;
|
|
|
927
1032
|
export type JobPlanSource = PlanSource;
|
|
928
1033
|
export type JobRecordSource = RecordSource;
|
|
929
1034
|
export type JobRecordSignoffValue = RecordSignoffValue;
|
|
1035
|
+
export type JobRecordReopenValue = RecordReopenValue;
|
|
1036
|
+
export type JobRecordUIActValues = RecordUIActValues;
|
|
1037
|
+
export type JobRecordUISubmission = RecordUISubmission;
|
|
1038
|
+
export type JobUISubmissionV3 = UISubmissionV3;
|
|
930
1039
|
export type JobRecordAct = RecordAct;
|
|
931
1040
|
export type JobSourceV3 = SourceV3;
|
|
932
1041
|
export type JobActV3 = ActV3;
|
|
933
1042
|
export type JobPendingAskV3 = PendingAskV3;
|
|
934
1043
|
export type JobPublicationV3 = PublicationV3;
|
|
1044
|
+
export type JobDisplayPublicationV3 = DisplayPublicationV3;
|
|
935
1045
|
export type JobStatusV3 = StatusV3;
|
|
936
1046
|
export type JobEventV3 = EventV3;
|
|
937
1047
|
export type JobNextValueV3 = NextValueV3;
|