@peasant-labs/schema 0.44.0 → 0.46.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/dist/fixtures/session-graph-capability.d.ts +49 -1
- package/dist/index.js +32 -4
- package/dist/internal/generated/content-capabilities.gen.d.ts +1 -0
- package/dist/internal/generated/content-capabilities.gen.js +4 -1
- package/dist/internal/generated/contract/zod.gen.d.ts +370 -1
- package/dist/internal/generated/contract/zod.gen.js +93 -2
- package/dist/internal/generated/enums.gen.d.ts +34 -7
- package/dist/internal/generated/enums.gen.js +31 -1
- package/dist/internal/generated/local-api.d.ts +291 -0
- package/dist/internal/generated/public-contract.gen.d.ts +2 -2
- package/dist/internal/generated/public-contract.gen.js +1 -1
- package/dist/internal/generated/session-graph-capability-fixtures.gen.d.ts +49 -1
- package/dist/internal/generated/session-graph-capability-fixtures.gen.js +62 -1
- package/dist/internal/generated/versions.gen.d.ts +3 -3
- package/dist/internal/generated/versions.gen.js +3 -3
- package/dist/internal/generated/village-api.d.ts +28 -0
- package/dist/internal/generated/wire-alias-shapes.gen.d.ts +23 -0
- package/dist/internal/generated/wire-alias-shapes.gen.js +23 -0
- package/package.json +1 -1
|
@@ -510,7 +510,7 @@ export const zConfidence = z.enum([
|
|
|
510
510
|
/**
|
|
511
511
|
* Content Capability
|
|
512
512
|
*
|
|
513
|
-
* Opaque, forward-open revision token in the deployment-specific content-capability set. Clients use exact set membership, never parse _v1 as Semantic Versioning or infer ranges, ignore unknown tokens, and tolerate duplicate or unordered input. Servers emit only their pinned known inventory, reject duplicates, and serialize lexicographically; token meanings are immutable. observed_model_v1 is required iff any root or nested assistant turn has observedModel, not for session model alone, and guarantees assistant-only value validation before persistence with no invalid DB/blob side effects plus byte-exact accepted observedModel strings through storage, typed migration, rewrite, serving, and pull; JSON whitespace and key order are excluded. thinking_level_v1 is required iff the session detail carries thinkingLevel, thinkingLevelRaw, or a non-empty thinkingLevelHistory, or any main or earlier-history turn carries thinkingLevel or thinkingLevelRaw, and guarantees canonical, raw-bound, and assistant-only validation before persistence with no invalid side effects plus byte-exact preservation of the values, their history order, and their absence through storage, typed migration, rewrite, serving, and pull.
|
|
513
|
+
* Opaque, forward-open revision token in the deployment-specific content-capability set. Clients use exact set membership, never parse _v1 as Semantic Versioning or infer ranges, ignore unknown tokens, and tolerate duplicate or unordered input. Servers emit only their pinned known inventory, reject duplicates, and serialize lexicographically; token meanings are immutable. observed_model_v1 is required iff any root or nested assistant turn has observedModel, not for session model alone, and guarantees assistant-only value validation before persistence with no invalid DB/blob side effects plus byte-exact accepted observedModel strings through storage, typed migration, rewrite, serving, and pull; JSON whitespace and key order are excluded. thinking_level_v1 is required iff the session detail carries thinkingLevel, thinkingLevelRaw, or a non-empty thinkingLevelHistory, or any main or earlier-history turn carries thinkingLevel or thinkingLevelRaw, and guarantees canonical, raw-bound, and assistant-only validation before persistence with no invalid side effects plus byte-exact preservation of the values, their history order, and their absence through storage, typed migration, rewrite, serving, and pull. content_parts_v1 is required iff any main or earlier-history turn carries a non-empty contentParts list, text-only or image-bearing, and guarantees ordered preservation of every part through storage, typed migration, rewrite, serving, and publication, including the published not_published image shape.
|
|
514
514
|
*/
|
|
515
515
|
export const zContentCapability = z.string();
|
|
516
516
|
/**
|
|
@@ -680,7 +680,8 @@ export const zEntryType = z.enum([
|
|
|
680
680
|
'thinking',
|
|
681
681
|
'system',
|
|
682
682
|
'error',
|
|
683
|
-
'result'
|
|
683
|
+
'result',
|
|
684
|
+
'image'
|
|
684
685
|
]);
|
|
685
686
|
/**
|
|
686
687
|
* Evidence Kind
|
|
@@ -774,6 +775,12 @@ export const zHealthResponse = z.object({
|
|
|
774
775
|
* Sanitized, filesystem-safe identifier derived from git remote; contains only [a-zA-Z0-9._<>-]
|
|
775
776
|
*/
|
|
776
777
|
export const zHostSlug = z.string().regex(/^[a-zA-Z0-9._<>-]+$/);
|
|
778
|
+
/**
|
|
779
|
+
* Image Media Type
|
|
780
|
+
*
|
|
781
|
+
* Recorded image media type: image/png or image/jpeg
|
|
782
|
+
*/
|
|
783
|
+
export const zImageMediaType = z.enum(['image/png', 'image/jpeg']);
|
|
777
784
|
/**
|
|
778
785
|
* Input Modality
|
|
779
786
|
*
|
|
@@ -1051,6 +1058,25 @@ export const zNativePiMessageRole = z.enum(['toolResult']);
|
|
|
1051
1058
|
* Exact UTF-8 model identifier observed on an assistant-generated turn; producer-enforced as assistant or subagent evidence. Values are non-empty and may not have a Unicode White_Space code point at either edge; all accepted bytes, including Unicode, mixed case, slashes, and internal spaces, are preserved.
|
|
1052
1059
|
*/
|
|
1053
1060
|
export const zObservedModelID = z.string().min(1).regex(/^(?:|[^\s])(?:[\s\S]*(?:|[^\s]))?$/).refine((value) => { const edge = (text) => text === "\uFEFF" || (!/\s/u.test(text) && text !== "\u0085"); return edge(value.charAt(0)) && edge(value.charAt(value.length - 1)); }, { error: "ObservedModelID must match pattern without edge whitespace" });
|
|
1061
|
+
/**
|
|
1062
|
+
* Omitted Reason
|
|
1063
|
+
*
|
|
1064
|
+
* Why an image part carries no bytes: unsupported (wins for a non-recorded media type), too_large, missing, or not_published
|
|
1065
|
+
*/
|
|
1066
|
+
export const zOmittedReason = z.enum([
|
|
1067
|
+
'too_large',
|
|
1068
|
+
'unsupported',
|
|
1069
|
+
'missing',
|
|
1070
|
+
'not_published'
|
|
1071
|
+
]);
|
|
1072
|
+
export const zImagePart = z.object({
|
|
1073
|
+
byteSize: z.int().gte(0).optional(),
|
|
1074
|
+
height: z.int().gte(0).optional(),
|
|
1075
|
+
mediaType: zImageMediaType.optional(),
|
|
1076
|
+
omittedReason: zOmittedReason.optional(),
|
|
1077
|
+
ref: z.string().length(64).regex(/^[0-9a-f]{64}$/).optional(),
|
|
1078
|
+
width: z.int().gte(0).optional()
|
|
1079
|
+
});
|
|
1054
1080
|
/**
|
|
1055
1081
|
* Operation Issue Code
|
|
1056
1082
|
*
|
|
@@ -2873,6 +2899,69 @@ export const zTrendsPayload = z.object({
|
|
|
2873
2899
|
totalSessions: z.int(),
|
|
2874
2900
|
totalTokens: z.int()
|
|
2875
2901
|
});
|
|
2902
|
+
/**
|
|
2903
|
+
* Turn Part Type
|
|
2904
|
+
*
|
|
2905
|
+
* Kind of one ordered turn content part: text or image
|
|
2906
|
+
*/
|
|
2907
|
+
export const zTurnPartType = z.enum(['text', 'image']);
|
|
2908
|
+
export const zTurnContentPart = z.object({
|
|
2909
|
+
image: zImagePart.optional(),
|
|
2910
|
+
text: z.string().optional(),
|
|
2911
|
+
type: zTurnPartType
|
|
2912
|
+
}).superRefine((part, ctx) => {
|
|
2913
|
+
const issue = (message) => ctx.addIssue({ code: "custom", message });
|
|
2914
|
+
if (part.type === "text") {
|
|
2915
|
+
if (part.image !== undefined)
|
|
2916
|
+
issue("a text part must not carry image");
|
|
2917
|
+
return;
|
|
2918
|
+
}
|
|
2919
|
+
if (part.image === undefined) {
|
|
2920
|
+
issue("an image part requires image");
|
|
2921
|
+
return;
|
|
2922
|
+
}
|
|
2923
|
+
if (part.text !== undefined)
|
|
2924
|
+
issue("an image part must not carry text");
|
|
2925
|
+
const image = part.image;
|
|
2926
|
+
if (image.byteSize !== undefined && image.byteSize < 0)
|
|
2927
|
+
issue("byteSize must be nonnegative");
|
|
2928
|
+
if (image.width !== undefined && image.width < 0)
|
|
2929
|
+
issue("width must be nonnegative");
|
|
2930
|
+
if (image.height !== undefined && image.height < 0)
|
|
2931
|
+
issue("height must be nonnegative");
|
|
2932
|
+
if (image.ref !== undefined && !/^[0-9a-f]{64}$/.test(image.ref))
|
|
2933
|
+
issue("ref must be lowercase 64-hex");
|
|
2934
|
+
if (image.omittedReason === "not_published") {
|
|
2935
|
+
if (image.ref !== undefined || image.mediaType !== undefined || (image.byteSize !== undefined && image.byteSize !== 0) || (image.width !== undefined && image.width !== 0) || (image.height !== undefined && image.height !== 0))
|
|
2936
|
+
issue("a published image must not carry local fields");
|
|
2937
|
+
return;
|
|
2938
|
+
}
|
|
2939
|
+
if (image.omittedReason === "unsupported") {
|
|
2940
|
+
if (image.mediaType !== undefined)
|
|
2941
|
+
issue("an unsupported image must not carry mediaType");
|
|
2942
|
+
if (image.ref !== undefined || (image.byteSize !== undefined && image.byteSize !== 0))
|
|
2943
|
+
issue("an unsupported image must not carry ref or byteSize");
|
|
2944
|
+
return;
|
|
2945
|
+
}
|
|
2946
|
+
if (image.mediaType !== "image/png" && image.mediaType !== "image/jpeg")
|
|
2947
|
+
issue("a local image requires image/png or image/jpeg");
|
|
2948
|
+
if (image.omittedReason === "too_large") {
|
|
2949
|
+
if (image.ref !== undefined)
|
|
2950
|
+
issue("a too_large image must not carry ref");
|
|
2951
|
+
if (image.byteSize !== undefined && image.byteSize !== 0)
|
|
2952
|
+
issue("a too_large image must not carry byteSize");
|
|
2953
|
+
return;
|
|
2954
|
+
}
|
|
2955
|
+
if (image.omittedReason === "missing") {
|
|
2956
|
+
if (image.byteSize !== undefined && image.byteSize !== 0)
|
|
2957
|
+
issue("a missing image must not carry byteSize");
|
|
2958
|
+
return;
|
|
2959
|
+
}
|
|
2960
|
+
if (image.ref === undefined)
|
|
2961
|
+
issue("an inline image requires ref");
|
|
2962
|
+
if (image.byteSize === undefined || image.byteSize === 0)
|
|
2963
|
+
issue("an inline image requires a positive byteSize");
|
|
2964
|
+
});
|
|
2876
2965
|
/**
|
|
2877
2966
|
* Type Origin
|
|
2878
2967
|
*
|
|
@@ -3017,6 +3106,7 @@ export const zTranscriptTurn = z.object({
|
|
|
3017
3106
|
byteLength: z.int().gte(0).lte(9007199254740991),
|
|
3018
3107
|
command: zCommandInvocation.optional(),
|
|
3019
3108
|
content: z.string(),
|
|
3109
|
+
contentParts: z.array(zTurnContentPart).optional(),
|
|
3020
3110
|
controlKind: z.string().nullish(),
|
|
3021
3111
|
depth: z.int(),
|
|
3022
3112
|
entryType: zEntryType.optional(),
|
|
@@ -3051,6 +3141,7 @@ export const zTurnDetail = z.object({
|
|
|
3051
3141
|
agentName: z.string().optional(),
|
|
3052
3142
|
command: zCommandInvocation.nullish(),
|
|
3053
3143
|
content: z.string(),
|
|
3144
|
+
contentParts: z.array(zTurnContentPart).optional(),
|
|
3054
3145
|
controlKind: z.string().nullish(),
|
|
3055
3146
|
depth: z.int(),
|
|
3056
3147
|
entryType: zEntryType.optional(),
|
|
@@ -33,6 +33,9 @@ import { type DecayLevel as DecayLevelContract } from "./contract/zod.gen.js";
|
|
|
33
33
|
import { type DiffLineKind as DiffLineKindContract } from "./contract/zod.gen.js";
|
|
34
34
|
import { type EdgeViolationKind as EdgeViolationKindContract } from "./contract/zod.gen.js";
|
|
35
35
|
import { type EntryType as EntryTypeContract } from "./contract/zod.gen.js";
|
|
36
|
+
import { type TurnPartType as TurnPartTypeContract } from "./contract/zod.gen.js";
|
|
37
|
+
import { type ImageMediaType as ImageMediaTypeContract } from "./contract/zod.gen.js";
|
|
38
|
+
import { type OmittedReason as OmittedReasonContract } from "./contract/zod.gen.js";
|
|
36
39
|
import { type FileChangeStatus as FileChangeStatusContract } from "./contract/zod.gen.js";
|
|
37
40
|
import { type Harness as HarnessContract } from "./contract/zod.gen.js";
|
|
38
41
|
import { type InsightKind as InsightKindContract } from "./contract/zod.gen.js";
|
|
@@ -418,16 +421,40 @@ export declare const AllEdgeViolationKinds: readonly EdgeViolationKind[];
|
|
|
418
421
|
export declare function isEdgeViolationKind(value: unknown): value is EdgeViolationKind;
|
|
419
422
|
export type EntryType = EntryTypeContract;
|
|
420
423
|
export declare const EntryType: Readonly<{
|
|
421
|
-
readonly Text: "error" | "text" | "tool_use" | "tool_result" | "thinking" | "system" | "result";
|
|
422
|
-
readonly ToolUse: "error" | "text" | "tool_use" | "tool_result" | "thinking" | "system" | "result";
|
|
423
|
-
readonly ToolResult: "error" | "text" | "tool_use" | "tool_result" | "thinking" | "system" | "result";
|
|
424
|
-
readonly Thinking: "error" | "text" | "tool_use" | "tool_result" | "thinking" | "system" | "result";
|
|
425
|
-
readonly System: "error" | "text" | "tool_use" | "tool_result" | "thinking" | "system" | "result";
|
|
426
|
-
readonly Error: "error" | "text" | "tool_use" | "tool_result" | "thinking" | "system" | "result";
|
|
427
|
-
readonly Result: "error" | "text" | "tool_use" | "tool_result" | "thinking" | "system" | "result";
|
|
424
|
+
readonly Text: "error" | "image" | "text" | "tool_use" | "tool_result" | "thinking" | "system" | "result";
|
|
425
|
+
readonly ToolUse: "error" | "image" | "text" | "tool_use" | "tool_result" | "thinking" | "system" | "result";
|
|
426
|
+
readonly ToolResult: "error" | "image" | "text" | "tool_use" | "tool_result" | "thinking" | "system" | "result";
|
|
427
|
+
readonly Thinking: "error" | "image" | "text" | "tool_use" | "tool_result" | "thinking" | "system" | "result";
|
|
428
|
+
readonly System: "error" | "image" | "text" | "tool_use" | "tool_result" | "thinking" | "system" | "result";
|
|
429
|
+
readonly Error: "error" | "image" | "text" | "tool_use" | "tool_result" | "thinking" | "system" | "result";
|
|
430
|
+
readonly Result: "error" | "image" | "text" | "tool_use" | "tool_result" | "thinking" | "system" | "result";
|
|
431
|
+
readonly Image: "error" | "image" | "text" | "tool_use" | "tool_result" | "thinking" | "system" | "result";
|
|
428
432
|
}>;
|
|
429
433
|
export declare const AllEntryTypes: readonly EntryType[];
|
|
430
434
|
export declare function isEntryType(value: unknown): value is EntryType;
|
|
435
|
+
export type TurnPartType = TurnPartTypeContract;
|
|
436
|
+
export declare const TurnPartType: Readonly<{
|
|
437
|
+
readonly Text: "image" | "text";
|
|
438
|
+
readonly Image: "image" | "text";
|
|
439
|
+
}>;
|
|
440
|
+
export declare const AllTurnPartTypes: readonly TurnPartType[];
|
|
441
|
+
export declare function isTurnPartType(value: unknown): value is TurnPartType;
|
|
442
|
+
export type ImageMediaType = ImageMediaTypeContract;
|
|
443
|
+
export declare const ImageMediaType: Readonly<{
|
|
444
|
+
readonly Png: "image/png" | "image/jpeg";
|
|
445
|
+
readonly Jpeg: "image/png" | "image/jpeg";
|
|
446
|
+
}>;
|
|
447
|
+
export declare const AllImageMediaTypes: readonly ImageMediaType[];
|
|
448
|
+
export declare function isImageMediaType(value: unknown): value is ImageMediaType;
|
|
449
|
+
export type OmittedReason = OmittedReasonContract;
|
|
450
|
+
export declare const OmittedReason: Readonly<{
|
|
451
|
+
readonly TooLarge: "too_large" | "unsupported" | "missing" | "not_published";
|
|
452
|
+
readonly Unsupported: "too_large" | "unsupported" | "missing" | "not_published";
|
|
453
|
+
readonly Missing: "too_large" | "unsupported" | "missing" | "not_published";
|
|
454
|
+
readonly NotPublished: "too_large" | "unsupported" | "missing" | "not_published";
|
|
455
|
+
}>;
|
|
456
|
+
export declare const AllOmittedReasons: readonly OmittedReason[];
|
|
457
|
+
export declare function isOmittedReason(value: unknown): value is OmittedReason;
|
|
431
458
|
export type FileChangeStatus = FileChangeStatusContract;
|
|
432
459
|
export declare const FileChangeStatus: Readonly<{
|
|
433
460
|
readonly Modified: "M" | "A" | "D" | "R";
|
|
@@ -34,6 +34,9 @@ import { zDecayLevel } from "./contract/zod.gen.js";
|
|
|
34
34
|
import { zDiffLineKind } from "./contract/zod.gen.js";
|
|
35
35
|
import { zEdgeViolationKind } from "./contract/zod.gen.js";
|
|
36
36
|
import { zEntryType } from "./contract/zod.gen.js";
|
|
37
|
+
import { zTurnPartType } from "./contract/zod.gen.js";
|
|
38
|
+
import { zImageMediaType } from "./contract/zod.gen.js";
|
|
39
|
+
import { zOmittedReason } from "./contract/zod.gen.js";
|
|
37
40
|
import { zFileChangeStatus } from "./contract/zod.gen.js";
|
|
38
41
|
import { zHarness } from "./contract/zod.gen.js";
|
|
39
42
|
import { zInsightKind } from "./contract/zod.gen.js";
|
|
@@ -459,11 +462,38 @@ export const EntryType = Object.freeze({
|
|
|
459
462
|
System: zEntryType.parse("system"),
|
|
460
463
|
Error: zEntryType.parse("error"),
|
|
461
464
|
Result: zEntryType.parse("result"),
|
|
465
|
+
Image: zEntryType.parse("image"),
|
|
462
466
|
});
|
|
463
|
-
export const AllEntryTypes = Object.freeze([EntryType.Text, EntryType.ToolUse, EntryType.ToolResult, EntryType.Thinking, EntryType.System, EntryType.Error, EntryType.Result]);
|
|
467
|
+
export const AllEntryTypes = Object.freeze([EntryType.Text, EntryType.ToolUse, EntryType.ToolResult, EntryType.Thinking, EntryType.System, EntryType.Error, EntryType.Result, EntryType.Image]);
|
|
464
468
|
export function isEntryType(value) {
|
|
465
469
|
return zEntryType.safeParse(value).success;
|
|
466
470
|
}
|
|
471
|
+
export const TurnPartType = Object.freeze({
|
|
472
|
+
Text: zTurnPartType.parse("text"),
|
|
473
|
+
Image: zTurnPartType.parse("image"),
|
|
474
|
+
});
|
|
475
|
+
export const AllTurnPartTypes = Object.freeze([TurnPartType.Text, TurnPartType.Image]);
|
|
476
|
+
export function isTurnPartType(value) {
|
|
477
|
+
return zTurnPartType.safeParse(value).success;
|
|
478
|
+
}
|
|
479
|
+
export const ImageMediaType = Object.freeze({
|
|
480
|
+
Png: zImageMediaType.parse("image/png"),
|
|
481
|
+
Jpeg: zImageMediaType.parse("image/jpeg"),
|
|
482
|
+
});
|
|
483
|
+
export const AllImageMediaTypes = Object.freeze([ImageMediaType.Png, ImageMediaType.Jpeg]);
|
|
484
|
+
export function isImageMediaType(value) {
|
|
485
|
+
return zImageMediaType.safeParse(value).success;
|
|
486
|
+
}
|
|
487
|
+
export const OmittedReason = Object.freeze({
|
|
488
|
+
TooLarge: zOmittedReason.parse("too_large"),
|
|
489
|
+
Unsupported: zOmittedReason.parse("unsupported"),
|
|
490
|
+
Missing: zOmittedReason.parse("missing"),
|
|
491
|
+
NotPublished: zOmittedReason.parse("not_published"),
|
|
492
|
+
});
|
|
493
|
+
export const AllOmittedReasons = Object.freeze([OmittedReason.TooLarge, OmittedReason.Unsupported, OmittedReason.Missing, OmittedReason.NotPublished]);
|
|
494
|
+
export function isOmittedReason(value) {
|
|
495
|
+
return zOmittedReason.safeParse(value).success;
|
|
496
|
+
}
|
|
467
497
|
export const FileChangeStatus = Object.freeze({
|
|
468
498
|
Modified: zFileChangeStatus.parse("M"),
|
|
469
499
|
Added: zFileChangeStatus.parse("A"),
|
|
@@ -392,6 +392,57 @@ export interface paths {
|
|
|
392
392
|
patch?: never;
|
|
393
393
|
trace?: never;
|
|
394
394
|
};
|
|
395
|
+
"/api/v1/sessions/{id}/transcript/segments": {
|
|
396
|
+
parameters: {
|
|
397
|
+
query?: never;
|
|
398
|
+
header?: never;
|
|
399
|
+
path?: never;
|
|
400
|
+
cookie?: never;
|
|
401
|
+
};
|
|
402
|
+
/** @description Read the transcript segment directory by session ID: the transcript's only global index, one ref per segment with the cut's revision and scalars and no turn content. Each ref names its segment ordinal and the closed range of sparse turn identities it covers; the segment read serves those turns. A session of zero segments answers an empty segments array with totalSegments 0. Above 10,000 segments the read serves one page of 10,000 refs, keeps the true totalSegments, and sets directoryPage and directoryPerPage; page is one-based, omitted defaults to 1, and a request past the last page is served the last page. The directory is cut under the store revision it reports; a segment cut under another revision must not be placed beside it. revision is optional and the current revision is served when it is omitted. The saved ingestion selection never narrows this stored read. */
|
|
403
|
+
get: operations["getSessionTranscriptSegments"];
|
|
404
|
+
put?: never;
|
|
405
|
+
post?: never;
|
|
406
|
+
delete?: never;
|
|
407
|
+
options?: never;
|
|
408
|
+
head?: never;
|
|
409
|
+
patch?: never;
|
|
410
|
+
trace?: never;
|
|
411
|
+
};
|
|
412
|
+
"/api/v1/sessions/{id}/transcript/segments/{index}": {
|
|
413
|
+
parameters: {
|
|
414
|
+
query?: never;
|
|
415
|
+
header?: never;
|
|
416
|
+
path?: never;
|
|
417
|
+
cookie?: never;
|
|
418
|
+
};
|
|
419
|
+
/** @description Read one transcript segment by its directory ordinal. The segment is cut on complete entries and whole turns, so every turn it serves is whole and its firstTurn and lastTurn are exactly the range the directory declared. Each turn row embeds the shared turn detail beside truncated and the pre-bound byteLength. hasOlder and hasNewer say whether the transcript continues on that side. revision is optional and the current revision is served when it is omitted. A non-numeric or negative index is a 400, an index at or past totalSegments is a 404 naming the directory's segment count, and a stale revision is a 409 naming both revisions. When the store returns fewer turns than the directory declared, the read answers 409 with the declared and returned ranges and the re-index command rather than serving a short segment. The saved ingestion selection never narrows this stored read. */
|
|
420
|
+
get: operations["getSessionTranscriptSegment"];
|
|
421
|
+
put?: never;
|
|
422
|
+
post?: never;
|
|
423
|
+
delete?: never;
|
|
424
|
+
options?: never;
|
|
425
|
+
head?: never;
|
|
426
|
+
patch?: never;
|
|
427
|
+
trace?: never;
|
|
428
|
+
};
|
|
429
|
+
"/api/v1/sessions/{id}/transcript/window": {
|
|
430
|
+
parameters: {
|
|
431
|
+
query?: never;
|
|
432
|
+
header?: never;
|
|
433
|
+
path?: never;
|
|
434
|
+
cookie?: never;
|
|
435
|
+
};
|
|
436
|
+
/** @description Resolve a turn identity to a contiguous transcript window and answer a descriptor that names where the window is, never what is in it. anchor is a non-negative turn identity: when the turn there is a user turn it is the anchor, otherwise the read snaps to the nearest lower user turn, or the nearest higher one when none is lower, and requestedAnchor and anchorTurn report both. span is the number of assistant turns collected on each side, 1..10, and omitted defaults to the design value 10; the parameter narrows a window and cannot widen it. The window is the contiguous range from the first collected turn to the last, so every interleaved user, system, and subagent turn is included. segments is the ordered contiguous run of segment ordinals that covers the range; the viewer loads exactly those through the segment read. hasOlder and hasNewer are true only when the transcript continues past that edge. revision is optional and the current revision is served when it is omitted. A missing, non-numeric, or negative anchor and a span outside 1..10 are 400; a session with no user turn is a 404, because a window requires one; a stale revision is a 409 naming both revisions. The saved ingestion selection never narrows this stored read. */
|
|
437
|
+
get: operations["getSessionTranscriptWindow"];
|
|
438
|
+
put?: never;
|
|
439
|
+
post?: never;
|
|
440
|
+
delete?: never;
|
|
441
|
+
options?: never;
|
|
442
|
+
head?: never;
|
|
443
|
+
patch?: never;
|
|
444
|
+
trace?: never;
|
|
445
|
+
};
|
|
395
446
|
"/api/v1/settings": {
|
|
396
447
|
parameters: {
|
|
397
448
|
query?: never;
|
|
@@ -1035,6 +1086,15 @@ export interface components {
|
|
|
1035
1086
|
SchemaHealthResponse: Schema.HealthResponse;
|
|
1036
1087
|
SchemaHelperContextSummary: Schema.HelperContextSummary;
|
|
1037
1088
|
SchemaHelperGroupSummary: Schema.HelperGroupSummary;
|
|
1089
|
+
/**
|
|
1090
|
+
* Image Media Type
|
|
1091
|
+
* @description Recorded image media type: image/png or image/jpeg
|
|
1092
|
+
* @example image/png
|
|
1093
|
+
* @example image/jpeg
|
|
1094
|
+
* @enum {string}
|
|
1095
|
+
*/
|
|
1096
|
+
SchemaImageMediaType: Schema.ImageMediaType;
|
|
1097
|
+
SchemaImagePart: Schema.ImagePart;
|
|
1038
1098
|
/**
|
|
1039
1099
|
* Input Modality
|
|
1040
1100
|
* @description Closed session graph value
|
|
@@ -1232,6 +1292,16 @@ export interface components {
|
|
|
1232
1292
|
* @example provider/Model Family
|
|
1233
1293
|
*/
|
|
1234
1294
|
SchemaObservedModelID: Schema.ObservedModelID;
|
|
1295
|
+
/**
|
|
1296
|
+
* Omitted Reason
|
|
1297
|
+
* @description Why an image part carries no bytes: unsupported (wins for a non-recorded media type), too_large, missing, or not_published
|
|
1298
|
+
* @example too_large
|
|
1299
|
+
* @example unsupported
|
|
1300
|
+
* @example missing
|
|
1301
|
+
* @example not_published
|
|
1302
|
+
* @enum {string}
|
|
1303
|
+
*/
|
|
1304
|
+
SchemaOmittedReason: Schema.OmittedReason;
|
|
1235
1305
|
SchemaOperationIssue: Schema.OperationIssue;
|
|
1236
1306
|
/**
|
|
1237
1307
|
* Operation Issue Code
|
|
@@ -1597,9 +1667,21 @@ export interface components {
|
|
|
1597
1667
|
* @example 99d59925-36bc-424c-a789-8be54d9702ba
|
|
1598
1668
|
*/
|
|
1599
1669
|
SchemaTranscriptID: Schema.TranscriptID;
|
|
1670
|
+
SchemaTranscriptSegment: Schema.TranscriptSegment;
|
|
1671
|
+
SchemaTranscriptSegmentDirectory: Schema.TranscriptSegmentDirectory;
|
|
1600
1672
|
SchemaTranscriptSegmentRef: Schema.TranscriptSegmentRef;
|
|
1601
1673
|
SchemaTranscriptTurn: Schema.TranscriptTurn;
|
|
1674
|
+
SchemaTranscriptWindow: Schema.TranscriptWindow;
|
|
1675
|
+
SchemaTurnContentPart: Schema.TurnContentPart;
|
|
1602
1676
|
SchemaTurnDetail: Schema.TurnDetail;
|
|
1677
|
+
/**
|
|
1678
|
+
* Turn Part Type
|
|
1679
|
+
* @description Kind of one ordered turn content part: text or image
|
|
1680
|
+
* @example text
|
|
1681
|
+
* @example image
|
|
1682
|
+
* @enum {string}
|
|
1683
|
+
*/
|
|
1684
|
+
SchemaTurnPartType: Schema.TurnPartType;
|
|
1603
1685
|
/**
|
|
1604
1686
|
* Type Origin
|
|
1605
1687
|
* @description Who created an annotation type: system (built-in), user (individual), or group (shared)
|
|
@@ -2380,6 +2462,215 @@ export interface operations {
|
|
|
2380
2462
|
};
|
|
2381
2463
|
};
|
|
2382
2464
|
};
|
|
2465
|
+
getSessionTranscriptSegments: {
|
|
2466
|
+
parameters: {
|
|
2467
|
+
query?: {
|
|
2468
|
+
/** @description One-based directory page; omitted defaults to 1 */
|
|
2469
|
+
page?: number;
|
|
2470
|
+
/** @description Store revision to read; omitted serves the current revision */
|
|
2471
|
+
revision?: string;
|
|
2472
|
+
};
|
|
2473
|
+
header?: never;
|
|
2474
|
+
path: {
|
|
2475
|
+
id: string;
|
|
2476
|
+
};
|
|
2477
|
+
cookie?: never;
|
|
2478
|
+
};
|
|
2479
|
+
requestBody?: never;
|
|
2480
|
+
responses: {
|
|
2481
|
+
/** @description OK */
|
|
2482
|
+
200: {
|
|
2483
|
+
headers: {
|
|
2484
|
+
[name: string]: unknown;
|
|
2485
|
+
};
|
|
2486
|
+
content: {
|
|
2487
|
+
"application/json": components["schemas"]["SchemaTranscriptSegmentDirectory"];
|
|
2488
|
+
};
|
|
2489
|
+
};
|
|
2490
|
+
/** @description Bad Request */
|
|
2491
|
+
400: {
|
|
2492
|
+
headers: {
|
|
2493
|
+
[name: string]: unknown;
|
|
2494
|
+
};
|
|
2495
|
+
content: {
|
|
2496
|
+
"application/json": components["schemas"]["OpenapiLocalErrorResponse"];
|
|
2497
|
+
};
|
|
2498
|
+
};
|
|
2499
|
+
/** @description Conflict */
|
|
2500
|
+
409: {
|
|
2501
|
+
headers: {
|
|
2502
|
+
[name: string]: unknown;
|
|
2503
|
+
};
|
|
2504
|
+
content: {
|
|
2505
|
+
"application/json": components["schemas"]["OpenapiLocalErrorResponse"];
|
|
2506
|
+
};
|
|
2507
|
+
};
|
|
2508
|
+
/** @description Internal Server Error */
|
|
2509
|
+
500: {
|
|
2510
|
+
headers: {
|
|
2511
|
+
[name: string]: unknown;
|
|
2512
|
+
};
|
|
2513
|
+
content: {
|
|
2514
|
+
"application/json": components["schemas"]["OpenapiLocalErrorResponse"];
|
|
2515
|
+
};
|
|
2516
|
+
};
|
|
2517
|
+
/** @description Service Unavailable */
|
|
2518
|
+
503: {
|
|
2519
|
+
headers: {
|
|
2520
|
+
[name: string]: unknown;
|
|
2521
|
+
};
|
|
2522
|
+
content: {
|
|
2523
|
+
"application/json": components["schemas"]["OpenapiLocalErrorResponse"];
|
|
2524
|
+
};
|
|
2525
|
+
};
|
|
2526
|
+
};
|
|
2527
|
+
};
|
|
2528
|
+
getSessionTranscriptSegment: {
|
|
2529
|
+
parameters: {
|
|
2530
|
+
query?: {
|
|
2531
|
+
/** @description Store revision to read; omitted serves the current revision */
|
|
2532
|
+
revision?: string;
|
|
2533
|
+
};
|
|
2534
|
+
header?: never;
|
|
2535
|
+
path: {
|
|
2536
|
+
id: string;
|
|
2537
|
+
/** @description Segment ordinal from the directory read */
|
|
2538
|
+
index: number;
|
|
2539
|
+
};
|
|
2540
|
+
cookie?: never;
|
|
2541
|
+
};
|
|
2542
|
+
requestBody?: never;
|
|
2543
|
+
responses: {
|
|
2544
|
+
/** @description OK */
|
|
2545
|
+
200: {
|
|
2546
|
+
headers: {
|
|
2547
|
+
[name: string]: unknown;
|
|
2548
|
+
};
|
|
2549
|
+
content: {
|
|
2550
|
+
"application/json": components["schemas"]["SchemaTranscriptSegment"];
|
|
2551
|
+
};
|
|
2552
|
+
};
|
|
2553
|
+
/** @description Bad Request */
|
|
2554
|
+
400: {
|
|
2555
|
+
headers: {
|
|
2556
|
+
[name: string]: unknown;
|
|
2557
|
+
};
|
|
2558
|
+
content: {
|
|
2559
|
+
"application/json": components["schemas"]["OpenapiLocalErrorResponse"];
|
|
2560
|
+
};
|
|
2561
|
+
};
|
|
2562
|
+
/** @description Not Found */
|
|
2563
|
+
404: {
|
|
2564
|
+
headers: {
|
|
2565
|
+
[name: string]: unknown;
|
|
2566
|
+
};
|
|
2567
|
+
content: {
|
|
2568
|
+
"application/json": components["schemas"]["OpenapiLocalErrorResponse"];
|
|
2569
|
+
};
|
|
2570
|
+
};
|
|
2571
|
+
/** @description Conflict */
|
|
2572
|
+
409: {
|
|
2573
|
+
headers: {
|
|
2574
|
+
[name: string]: unknown;
|
|
2575
|
+
};
|
|
2576
|
+
content: {
|
|
2577
|
+
"application/json": components["schemas"]["OpenapiLocalErrorResponse"];
|
|
2578
|
+
};
|
|
2579
|
+
};
|
|
2580
|
+
/** @description Internal Server Error */
|
|
2581
|
+
500: {
|
|
2582
|
+
headers: {
|
|
2583
|
+
[name: string]: unknown;
|
|
2584
|
+
};
|
|
2585
|
+
content: {
|
|
2586
|
+
"application/json": components["schemas"]["OpenapiLocalErrorResponse"];
|
|
2587
|
+
};
|
|
2588
|
+
};
|
|
2589
|
+
/** @description Service Unavailable */
|
|
2590
|
+
503: {
|
|
2591
|
+
headers: {
|
|
2592
|
+
[name: string]: unknown;
|
|
2593
|
+
};
|
|
2594
|
+
content: {
|
|
2595
|
+
"application/json": components["schemas"]["OpenapiLocalErrorResponse"];
|
|
2596
|
+
};
|
|
2597
|
+
};
|
|
2598
|
+
};
|
|
2599
|
+
};
|
|
2600
|
+
getSessionTranscriptWindow: {
|
|
2601
|
+
parameters: {
|
|
2602
|
+
query: {
|
|
2603
|
+
/** @description Turn identity to centre the window on */
|
|
2604
|
+
anchor: number;
|
|
2605
|
+
/** @description Assistant turns collected on each side, 1..10; omitted defaults to 10 */
|
|
2606
|
+
span?: number;
|
|
2607
|
+
/** @description Store revision to read; omitted serves the current revision */
|
|
2608
|
+
revision?: string;
|
|
2609
|
+
};
|
|
2610
|
+
header?: never;
|
|
2611
|
+
path: {
|
|
2612
|
+
id: string;
|
|
2613
|
+
};
|
|
2614
|
+
cookie?: never;
|
|
2615
|
+
};
|
|
2616
|
+
requestBody?: never;
|
|
2617
|
+
responses: {
|
|
2618
|
+
/** @description OK */
|
|
2619
|
+
200: {
|
|
2620
|
+
headers: {
|
|
2621
|
+
[name: string]: unknown;
|
|
2622
|
+
};
|
|
2623
|
+
content: {
|
|
2624
|
+
"application/json": components["schemas"]["SchemaTranscriptWindow"];
|
|
2625
|
+
};
|
|
2626
|
+
};
|
|
2627
|
+
/** @description Bad Request */
|
|
2628
|
+
400: {
|
|
2629
|
+
headers: {
|
|
2630
|
+
[name: string]: unknown;
|
|
2631
|
+
};
|
|
2632
|
+
content: {
|
|
2633
|
+
"application/json": components["schemas"]["OpenapiLocalErrorResponse"];
|
|
2634
|
+
};
|
|
2635
|
+
};
|
|
2636
|
+
/** @description Not Found */
|
|
2637
|
+
404: {
|
|
2638
|
+
headers: {
|
|
2639
|
+
[name: string]: unknown;
|
|
2640
|
+
};
|
|
2641
|
+
content: {
|
|
2642
|
+
"application/json": components["schemas"]["OpenapiLocalErrorResponse"];
|
|
2643
|
+
};
|
|
2644
|
+
};
|
|
2645
|
+
/** @description Conflict */
|
|
2646
|
+
409: {
|
|
2647
|
+
headers: {
|
|
2648
|
+
[name: string]: unknown;
|
|
2649
|
+
};
|
|
2650
|
+
content: {
|
|
2651
|
+
"application/json": components["schemas"]["OpenapiLocalErrorResponse"];
|
|
2652
|
+
};
|
|
2653
|
+
};
|
|
2654
|
+
/** @description Internal Server Error */
|
|
2655
|
+
500: {
|
|
2656
|
+
headers: {
|
|
2657
|
+
[name: string]: unknown;
|
|
2658
|
+
};
|
|
2659
|
+
content: {
|
|
2660
|
+
"application/json": components["schemas"]["OpenapiLocalErrorResponse"];
|
|
2661
|
+
};
|
|
2662
|
+
};
|
|
2663
|
+
/** @description Service Unavailable */
|
|
2664
|
+
503: {
|
|
2665
|
+
headers: {
|
|
2666
|
+
[name: string]: unknown;
|
|
2667
|
+
};
|
|
2668
|
+
content: {
|
|
2669
|
+
"application/json": components["schemas"]["OpenapiLocalErrorResponse"];
|
|
2670
|
+
};
|
|
2671
|
+
};
|
|
2672
|
+
};
|
|
2673
|
+
};
|
|
2383
2674
|
getSettings: {
|
|
2384
2675
|
parameters: {
|
|
2385
2676
|
query?: never;
|