@mossbear/protocol 0.1.0-alpha.93 → 0.1.0-alpha.94
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/artifact.test.js +16 -1
- package/dist/artifact.test.js.map +1 -1
- package/dist/schemas.d.ts +495 -9
- package/dist/schemas.d.ts.map +1 -1
- package/dist/schemas.js +170 -3
- package/dist/schemas.js.map +1 -1
- package/dist/schemas.test.js +41 -1
- package/dist/schemas.test.js.map +1 -1
- package/dist/types.d.ts +7 -1
- package/dist/types.d.ts.map +1 -1
- package/dist/types.js.map +1 -1
- package/package.json +1 -1
package/dist/schemas.d.ts
CHANGED
|
@@ -937,21 +937,44 @@ export declare const RevokeScopedTokenRequestSchema: v.ObjectSchema<{
|
|
|
937
937
|
* release step 2 sends; both are read, and the parsed value is always `artifactId`.
|
|
938
938
|
* Drop `itemId` once no such CLI is left to send it.
|
|
939
939
|
*/
|
|
940
|
+
/** The most artifacts one attach request may name. */
|
|
941
|
+
export declare const MAX_BUNDLE_MEMBERS_PER_ATTACH = 200;
|
|
940
942
|
export declare const AttachBundleMemberRequestSchema: v.SchemaWithPipe<readonly [v.ObjectSchema<{
|
|
941
943
|
readonly artifactId: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>;
|
|
942
944
|
readonly itemId: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>;
|
|
945
|
+
readonly artifactIds: v.OptionalSchema<v.SchemaWithPipe<readonly [v.ArraySchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>, v.TransformAction<string[], string[]>, v.MinLengthAction<string[], 1, undefined>, v.MaxLengthAction<string[], 200, undefined>]>, undefined>;
|
|
943
946
|
}, undefined>, v.CheckAction<{
|
|
944
947
|
artifactId?: string | undefined;
|
|
945
948
|
itemId?: string | undefined;
|
|
946
|
-
|
|
949
|
+
artifactIds?: string[] | undefined;
|
|
950
|
+
}, "A member needs an artifactId, or a list of artifactIds on its own.">, v.TransformAction<{
|
|
947
951
|
artifactId?: string | undefined;
|
|
948
952
|
itemId?: string | undefined;
|
|
953
|
+
artifactIds?: string[] | undefined;
|
|
949
954
|
}, {
|
|
950
955
|
artifactId: string;
|
|
956
|
+
} | {
|
|
957
|
+
artifactIds: string[];
|
|
951
958
|
}>]>;
|
|
952
959
|
export declare const AttachBundleMemberResponseSchema: v.ObjectSchema<{
|
|
953
960
|
readonly attached: v.BooleanSchema<undefined>;
|
|
954
961
|
}, undefined>;
|
|
962
|
+
/**
|
|
963
|
+
* One id's outcome in a list attach. `unavailable` is every refusal that is not
|
|
964
|
+
* a path collision, and reads the same whether the artifact is missing, not the
|
|
965
|
+
* caller's to file or in another workspace, so a list cannot probe which ids
|
|
966
|
+
* exist.
|
|
967
|
+
*/
|
|
968
|
+
export declare const AttachBundleMembersResultSchema: v.ObjectSchema<{
|
|
969
|
+
readonly artifactId: v.StringSchema<undefined>;
|
|
970
|
+
readonly status: v.PicklistSchema<["added", "already_there", "unavailable", "path_taken"], undefined>;
|
|
971
|
+
}, undefined>;
|
|
972
|
+
export declare const AttachBundleMembersResponseSchema: v.ObjectSchema<{
|
|
973
|
+
readonly results: v.ArraySchema<v.ObjectSchema<{
|
|
974
|
+
readonly artifactId: v.StringSchema<undefined>;
|
|
975
|
+
readonly status: v.PicklistSchema<["added", "already_there", "unavailable", "path_taken"], undefined>;
|
|
976
|
+
}, undefined>, undefined>;
|
|
977
|
+
}, undefined>;
|
|
955
978
|
export declare const DetachBundleMemberResponseSchema: v.ObjectSchema<{
|
|
956
979
|
readonly detached: v.BooleanSchema<undefined>;
|
|
957
980
|
}, undefined>;
|
|
@@ -1078,6 +1101,13 @@ export declare const MAX_ITEM_COMMENTS_ON_WIRE = 20;
|
|
|
1078
1101
|
* it says how many it held back (`repliesWithheld`), so a cut is never silent.
|
|
1079
1102
|
*/
|
|
1080
1103
|
export declare const MAX_REPLIES_PER_THREAD_ON_WIRE = 10;
|
|
1104
|
+
/**
|
|
1105
|
+
* The most entries one item's `comments` can hold once threads ride it: a
|
|
1106
|
+
* person's allowance of roots plus an agent's own, each followed by its replies.
|
|
1107
|
+
* A client that does not render threads is sent roots alone, which stay within
|
|
1108
|
+
* `MAX_ITEM_COMMENTS_ON_WIRE`.
|
|
1109
|
+
*/
|
|
1110
|
+
export declare const MAX_ITEM_THREAD_ENTRIES_ON_WIRE: number;
|
|
1081
1111
|
/**
|
|
1082
1112
|
* Who wrote a comment. An agent writes under its person's account, so the
|
|
1083
1113
|
* author's name alone cannot tell a person's answer from an agent's message.
|
|
@@ -1561,7 +1591,7 @@ export declare const ContextItemSchema: v.SchemaWithPipe<readonly [v.ObjectSchem
|
|
|
1561
1591
|
threadId: string;
|
|
1562
1592
|
replyToId: string | null;
|
|
1563
1593
|
repliesWithheld?: number | undefined;
|
|
1564
|
-
}[],
|
|
1594
|
+
}[], number, undefined>]>, undefined>;
|
|
1565
1595
|
readonly updatedAt: v.StringSchema<undefined>;
|
|
1566
1596
|
/**
|
|
1567
1597
|
* Present iff this artifact is owned by git. Absent means Mossbear owns it
|
|
@@ -1948,7 +1978,7 @@ export declare const ContextItemsResponseSchema: v.ObjectSchema<{
|
|
|
1948
1978
|
threadId: string;
|
|
1949
1979
|
replyToId: string | null;
|
|
1950
1980
|
repliesWithheld?: number | undefined;
|
|
1951
|
-
}[],
|
|
1981
|
+
}[], number, undefined>]>, undefined>;
|
|
1952
1982
|
readonly updatedAt: v.StringSchema<undefined>;
|
|
1953
1983
|
/**
|
|
1954
1984
|
* Present iff this artifact is owned by git. Absent means Mossbear owns it
|
|
@@ -2351,7 +2381,7 @@ export declare const BundleArtifactsResponseSchema: v.ObjectSchema<{
|
|
|
2351
2381
|
threadId: string;
|
|
2352
2382
|
replyToId: string | null;
|
|
2353
2383
|
repliesWithheld?: number | undefined;
|
|
2354
|
-
}[],
|
|
2384
|
+
}[], number, undefined>]>, undefined>;
|
|
2355
2385
|
readonly updatedAt: v.StringSchema<undefined>;
|
|
2356
2386
|
/**
|
|
2357
2387
|
* Present iff this artifact is owned by git. Absent means Mossbear owns it
|
|
@@ -2548,6 +2578,41 @@ export declare const BundleArtifactsResponseSchema: v.ObjectSchema<{
|
|
|
2548
2578
|
* losing the tail silently.
|
|
2549
2579
|
*/
|
|
2550
2580
|
export declare const MAX_COMMENT_BUNDLE_IDS = 100;
|
|
2581
|
+
/**
|
|
2582
|
+
* `POST /api/v1/context/comments/resolve`: close one open comment and leave the
|
|
2583
|
+
* agent's note as a reply in its thread.
|
|
2584
|
+
*
|
|
2585
|
+
* **Two ways to find the comment, never both at once.** Without `artifactId`,
|
|
2586
|
+
* the id is looked up among the comments the named bundles deliver, which is
|
|
2587
|
+
* what `list_comments` listed. With it, the id is looked up among that one
|
|
2588
|
+
* artifact's open comments, which is what its feedback read listed, after the
|
|
2589
|
+
* same read check that read makes. A request with `artifactId` does not fall
|
|
2590
|
+
* back to the bundles when the id is not on that artifact.
|
|
2591
|
+
*/
|
|
2592
|
+
export declare const ResolveItemCommentRequestSchema: v.ObjectSchema<{
|
|
2593
|
+
/** The comment's id, or a unique prefix of it as a read printed it. */
|
|
2594
|
+
readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 128, undefined>]>;
|
|
2595
|
+
/** One line, kept in the thread as the agent's reply. */
|
|
2596
|
+
readonly note: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 500, undefined>, v.RegexAction<string, undefined>]>;
|
|
2597
|
+
/** The bundles this repo receives. Ignored when `artifactId` is sent. */
|
|
2598
|
+
readonly bundleIds: v.OptionalSchema<v.SchemaWithPipe<readonly [v.ArraySchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>, v.MaxLengthAction<string[], 100, undefined>]>, readonly []>;
|
|
2599
|
+
/** The artifact the comment is on, as its feedback read was asked for it. */
|
|
2600
|
+
readonly artifactId: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 128, undefined>]>, undefined>;
|
|
2601
|
+
/**
|
|
2602
|
+
* The reader's repo, as its committed `project.id`. A comment drafted from
|
|
2603
|
+
* one repo's corrections is listed only to a read that declares that repo,
|
|
2604
|
+
* so it is resolvable only by one that declares it too.
|
|
2605
|
+
*/
|
|
2606
|
+
readonly projectId: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 128, undefined>, v.RegexAction<string, "projectId must contain only letters, digits, underscore, dot or hyphen">]>, undefined>;
|
|
2607
|
+
/** The CLI's version, so a draft resolves only for a client that marks drafts. */
|
|
2608
|
+
readonly cliVersion: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 64, undefined>]>, undefined>;
|
|
2609
|
+
}, undefined>;
|
|
2610
|
+
export type ResolveItemCommentRequest = v.InferInput<typeof ResolveItemCommentRequestSchema>;
|
|
2611
|
+
/** A resolve the server carried out. Every refusal is an error response instead. */
|
|
2612
|
+
export declare const ResolveItemCommentResponseSchema: v.ObjectSchema<{
|
|
2613
|
+
readonly resolved: v.LiteralSchema<true, undefined>;
|
|
2614
|
+
}, undefined>;
|
|
2615
|
+
export type ResolveItemCommentResponse = v.InferOutput<typeof ResolveItemCommentResponseSchema>;
|
|
2551
2616
|
/**
|
|
2552
2617
|
* How many times one subscriber is told, in one repo, that a given comment is
|
|
2553
2618
|
* waiting before the hook falls silent about it.
|
|
@@ -2594,6 +2659,12 @@ export declare const AnnounceItemCommentsRequestSchema: v.ObjectSchema<{
|
|
|
2594
2659
|
* filtered by the caller's own workspace membership.
|
|
2595
2660
|
*/
|
|
2596
2661
|
readonly bundleIds: v.SchemaWithPipe<readonly [v.ArraySchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>, v.MaxLengthAction<string[], 100, undefined>]>;
|
|
2662
|
+
/**
|
|
2663
|
+
* The release asking. A person's reply on a thread counts as waiting only
|
|
2664
|
+
* for a release that renders threads; without it the answer is the roots-only
|
|
2665
|
+
* count every older release was given.
|
|
2666
|
+
*/
|
|
2667
|
+
readonly cliVersion: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 64, undefined>]>, undefined>;
|
|
2597
2668
|
}, undefined>;
|
|
2598
2669
|
export type AnnounceItemCommentsRequest = v.InferOutput<typeof AnnounceItemCommentsRequestSchema>;
|
|
2599
2670
|
/**
|
|
@@ -3549,7 +3620,7 @@ export declare const ArtifactSchema: v.ObjectSchema<{
|
|
|
3549
3620
|
threadId: string;
|
|
3550
3621
|
replyToId: string | null;
|
|
3551
3622
|
repliesWithheld?: number | undefined;
|
|
3552
|
-
}[],
|
|
3623
|
+
}[], number, undefined>]>, undefined>;
|
|
3553
3624
|
readonly updatedAt: v.StringSchema<undefined>;
|
|
3554
3625
|
}, undefined>;
|
|
3555
3626
|
/**
|
|
@@ -3633,6 +3704,13 @@ export declare const CreateArtifactRequestSchema: v.StrictObjectSchema<{
|
|
|
3633
3704
|
*/
|
|
3634
3705
|
readonly branch: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 255, undefined>]>, undefined>;
|
|
3635
3706
|
}, undefined>, undefined>;
|
|
3707
|
+
/**
|
|
3708
|
+
* The agent session that wrote this revision, as its harness names it (the id
|
|
3709
|
+
* `create_comment` resolves). Recorded in the saved version's `metadata`, and
|
|
3710
|
+
* absent when the writer could not tell. Provenance only: it grants nothing
|
|
3711
|
+
* and is not shown as authorship.
|
|
3712
|
+
*/
|
|
3713
|
+
readonly agentSessionId: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 256, undefined>]>, undefined>;
|
|
3636
3714
|
}, undefined>;
|
|
3637
3715
|
/**
|
|
3638
3716
|
* Update an existing artifact's content. The id is in the route. The version the
|
|
@@ -3711,6 +3789,13 @@ export declare const UpdateArtifactRequestSchema: v.StrictObjectSchema<{
|
|
|
3711
3789
|
*/
|
|
3712
3790
|
readonly branch: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 255, undefined>]>, undefined>;
|
|
3713
3791
|
}, undefined>, undefined>;
|
|
3792
|
+
/**
|
|
3793
|
+
* The agent session that wrote this revision, as its harness names it (the id
|
|
3794
|
+
* `create_comment` resolves). Recorded in the saved version's `metadata`, and
|
|
3795
|
+
* absent when the writer could not tell. Provenance only: it grants nothing
|
|
3796
|
+
* and is not shown as authorship.
|
|
3797
|
+
*/
|
|
3798
|
+
readonly agentSessionId: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 256, undefined>]>, undefined>;
|
|
3714
3799
|
}, undefined>;
|
|
3715
3800
|
/**
|
|
3716
3801
|
* Tombstone an artifact: the commit that published it has since deleted the
|
|
@@ -3948,7 +4033,7 @@ export declare const ReadArtifactResponseSchema: v.ObjectSchema<{
|
|
|
3948
4033
|
threadId: string;
|
|
3949
4034
|
replyToId: string | null;
|
|
3950
4035
|
repliesWithheld?: number | undefined;
|
|
3951
|
-
}[],
|
|
4036
|
+
}[], number, undefined>]>, undefined>;
|
|
3952
4037
|
readonly updatedAt: v.StringSchema<undefined>;
|
|
3953
4038
|
}, undefined>;
|
|
3954
4039
|
readonly revision: v.ObjectSchema<{
|
|
@@ -4128,7 +4213,7 @@ export declare const CreateArtifactResponseSchema: v.ObjectSchema<{
|
|
|
4128
4213
|
threadId: string;
|
|
4129
4214
|
replyToId: string | null;
|
|
4130
4215
|
repliesWithheld?: number | undefined;
|
|
4131
|
-
}[],
|
|
4216
|
+
}[], number, undefined>]>, undefined>;
|
|
4132
4217
|
readonly updatedAt: v.StringSchema<undefined>;
|
|
4133
4218
|
}, undefined>;
|
|
4134
4219
|
}, undefined>;
|
|
@@ -4295,7 +4380,7 @@ export declare const UpdateArtifactResponseSchema: v.ObjectSchema<{
|
|
|
4295
4380
|
threadId: string;
|
|
4296
4381
|
replyToId: string | null;
|
|
4297
4382
|
repliesWithheld?: number | undefined;
|
|
4298
|
-
}[],
|
|
4383
|
+
}[], number, undefined>]>, undefined>;
|
|
4299
4384
|
readonly updatedAt: v.StringSchema<undefined>;
|
|
4300
4385
|
}, undefined>;
|
|
4301
4386
|
}, undefined>;
|
|
@@ -4463,7 +4548,7 @@ export declare const RemoveArtifactResponseSchema: v.ObjectSchema<{
|
|
|
4463
4548
|
threadId: string;
|
|
4464
4549
|
replyToId: string | null;
|
|
4465
4550
|
repliesWithheld?: number | undefined;
|
|
4466
|
-
}[],
|
|
4551
|
+
}[], number, undefined>]>, undefined>;
|
|
4467
4552
|
readonly updatedAt: v.StringSchema<undefined>;
|
|
4468
4553
|
}, undefined>;
|
|
4469
4554
|
}, undefined>;
|
|
@@ -4614,6 +4699,63 @@ export declare const ArtifactVersionConflictSchema: v.ObjectSchema<{
|
|
|
4614
4699
|
readonly expectedVersion: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>;
|
|
4615
4700
|
readonly requestId: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
|
|
4616
4701
|
}, undefined>;
|
|
4702
|
+
/**
|
|
4703
|
+
* Save a draft of an artifact from a git branch. One draft per artifact,
|
|
4704
|
+
* author and branch, so a second upload from the same branch replaces the
|
|
4705
|
+
* first. `baseVersion` is the artifact version the branch's bytes were
|
|
4706
|
+
* compared with; publishing the draft later sends it as `expectedVersion`.
|
|
4707
|
+
* Content equal to the artifact's current content stores nothing and removes
|
|
4708
|
+
* any draft from that branch, because it has landed.
|
|
4709
|
+
*/
|
|
4710
|
+
export declare const UpsertArtifactDraftRequestSchema: v.StrictObjectSchema<{
|
|
4711
|
+
readonly branch: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 255, undefined>]>;
|
|
4712
|
+
readonly content: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.CheckAction<string, "content must be at most 524288 bytes">]>;
|
|
4713
|
+
readonly baseVersion: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>;
|
|
4714
|
+
readonly gitCommit: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "commitSha must be 40 or 64 lowercase hex characters">]>, undefined>;
|
|
4715
|
+
}, undefined>;
|
|
4716
|
+
/**
|
|
4717
|
+
* One of the caller's drafts. `branch` is null for a draft written in the
|
|
4718
|
+
* dashboard or by an agent rather than uploaded from git.
|
|
4719
|
+
*/
|
|
4720
|
+
export declare const ArtifactDraftSchema: v.ObjectSchema<{
|
|
4721
|
+
readonly id: v.StringSchema<undefined>;
|
|
4722
|
+
readonly artifactId: v.StringSchema<undefined>;
|
|
4723
|
+
readonly branch: v.NullableSchema<v.StringSchema<undefined>, undefined>;
|
|
4724
|
+
readonly gitCommit: v.NullableSchema<v.StringSchema<undefined>, undefined>;
|
|
4725
|
+
readonly content: v.StringSchema<undefined>;
|
|
4726
|
+
readonly contentHash: v.StringSchema<undefined>;
|
|
4727
|
+
readonly baseVersion: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>;
|
|
4728
|
+
readonly createdAt: v.StringSchema<undefined>;
|
|
4729
|
+
readonly updatedAt: v.StringSchema<undefined>;
|
|
4730
|
+
}, undefined>;
|
|
4731
|
+
/** `draft` is null when the content had already landed and nothing was kept. */
|
|
4732
|
+
export declare const UpsertArtifactDraftResponseSchema: v.ObjectSchema<{
|
|
4733
|
+
readonly draft: v.NullableSchema<v.ObjectSchema<{
|
|
4734
|
+
readonly id: v.StringSchema<undefined>;
|
|
4735
|
+
readonly artifactId: v.StringSchema<undefined>;
|
|
4736
|
+
readonly branch: v.NullableSchema<v.StringSchema<undefined>, undefined>;
|
|
4737
|
+
readonly gitCommit: v.NullableSchema<v.StringSchema<undefined>, undefined>;
|
|
4738
|
+
readonly content: v.StringSchema<undefined>;
|
|
4739
|
+
readonly contentHash: v.StringSchema<undefined>;
|
|
4740
|
+
readonly baseVersion: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>;
|
|
4741
|
+
readonly createdAt: v.StringSchema<undefined>;
|
|
4742
|
+
readonly updatedAt: v.StringSchema<undefined>;
|
|
4743
|
+
}, undefined>, undefined>;
|
|
4744
|
+
}, undefined>;
|
|
4745
|
+
/** The caller's own drafts of one artifact, most recently updated first. */
|
|
4746
|
+
export declare const ListArtifactDraftsResponseSchema: v.ObjectSchema<{
|
|
4747
|
+
readonly drafts: v.ArraySchema<v.ObjectSchema<{
|
|
4748
|
+
readonly id: v.StringSchema<undefined>;
|
|
4749
|
+
readonly artifactId: v.StringSchema<undefined>;
|
|
4750
|
+
readonly branch: v.NullableSchema<v.StringSchema<undefined>, undefined>;
|
|
4751
|
+
readonly gitCommit: v.NullableSchema<v.StringSchema<undefined>, undefined>;
|
|
4752
|
+
readonly content: v.StringSchema<undefined>;
|
|
4753
|
+
readonly contentHash: v.StringSchema<undefined>;
|
|
4754
|
+
readonly baseVersion: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>;
|
|
4755
|
+
readonly createdAt: v.StringSchema<undefined>;
|
|
4756
|
+
readonly updatedAt: v.StringSchema<undefined>;
|
|
4757
|
+
}, undefined>, undefined>;
|
|
4758
|
+
}, undefined>;
|
|
4617
4759
|
export declare const ProposalCitationSchema: v.ObjectSchema<{
|
|
4618
4760
|
readonly agentSessionId: v.StringSchema<undefined>;
|
|
4619
4761
|
readonly timestamp: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
|
|
@@ -6147,6 +6289,11 @@ export declare const ArtifactFeedbackQuerySchema: v.ObjectSchema<{
|
|
|
6147
6289
|
* correction drafted for one repo is withheld, as on the comments read.
|
|
6148
6290
|
*/
|
|
6149
6291
|
readonly project: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>]>, undefined>;
|
|
6292
|
+
/**
|
|
6293
|
+
* The release asking. Replies on a thread are sent only to one that renders
|
|
6294
|
+
* threads; without it the page is roots only, as it was.
|
|
6295
|
+
*/
|
|
6296
|
+
readonly cli: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 64, undefined>]>, undefined>;
|
|
6150
6297
|
}, undefined>;
|
|
6151
6298
|
export type ArtifactFeedbackQuery = v.InferOutput<typeof ArtifactFeedbackQuerySchema>;
|
|
6152
6299
|
/**
|
|
@@ -6463,6 +6610,333 @@ export declare const ArtifactFeedbackResponseSchema: v.ObjectSchema<{
|
|
|
6463
6610
|
}, undefined>, undefined>;
|
|
6464
6611
|
}, undefined>;
|
|
6465
6612
|
export type ArtifactFeedbackResponse = v.InferOutput<typeof ArtifactFeedbackResponseSchema>;
|
|
6613
|
+
/** Most artifacts one batch feedback read may name. */
|
|
6614
|
+
export declare const MAX_ARTIFACT_FEEDBACK_BATCH = 25;
|
|
6615
|
+
/**
|
|
6616
|
+
* `POST /api/v1/artifacts/feedback` body: several artifacts read at once, each
|
|
6617
|
+
* paged as `GET .../:id/feedback` pages it (`cursor` is that artifact's own
|
|
6618
|
+
* `nextCursor`). `project` and `cli` mean what they mean on the single read.
|
|
6619
|
+
*/
|
|
6620
|
+
export declare const ArtifactFeedbackBatchRequestSchema: v.ObjectSchema<{
|
|
6621
|
+
readonly artifacts: v.SchemaWithPipe<readonly [v.ArraySchema<v.ObjectSchema<{
|
|
6622
|
+
readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 512, undefined>]>;
|
|
6623
|
+
readonly cursor: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "cursor is not a feedback cursor">]>, undefined>;
|
|
6624
|
+
}, undefined>, undefined>, v.MinLengthAction<{
|
|
6625
|
+
id: string;
|
|
6626
|
+
cursor?: string | undefined;
|
|
6627
|
+
}[], 1, undefined>, v.MaxLengthAction<{
|
|
6628
|
+
id: string;
|
|
6629
|
+
cursor?: string | undefined;
|
|
6630
|
+
}[], 25, undefined>]>;
|
|
6631
|
+
readonly project: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>]>, undefined>;
|
|
6632
|
+
readonly cli: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 64, undefined>]>, undefined>;
|
|
6633
|
+
}, undefined>;
|
|
6634
|
+
export type ArtifactFeedbackBatchRequest = v.InferOutput<typeof ArtifactFeedbackBatchRequestSchema>;
|
|
6635
|
+
/**
|
|
6636
|
+
* One entry per requested id, in request order. `feedback` is null for an id
|
|
6637
|
+
* the caller cannot read, missing or out of scope alike, and carries nothing
|
|
6638
|
+
* else about it; the other entries are unaffected. A read that failed is
|
|
6639
|
+
* `unavailable: true` instead, and nothing of it was counted as delivered.
|
|
6640
|
+
*/
|
|
6641
|
+
export declare const ArtifactFeedbackBatchResponseSchema: v.ObjectSchema<{
|
|
6642
|
+
readonly artifacts: v.ArraySchema<v.ObjectSchema<{
|
|
6643
|
+
readonly id: v.StringSchema<undefined>;
|
|
6644
|
+
readonly feedback: v.NullableSchema<v.ObjectSchema<{
|
|
6645
|
+
readonly artifactId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
6646
|
+
/** The artifact's current version, as `read` reports it. */
|
|
6647
|
+
readonly version: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>;
|
|
6648
|
+
/** Open comments, oldest first by `(createdAt, id)`. */
|
|
6649
|
+
readonly comments: v.ArraySchema<v.ObjectSchema<{
|
|
6650
|
+
readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
6651
|
+
readonly state: v.OptionalSchema<v.PicklistSchema<["open", "resolved"], undefined>, undefined>;
|
|
6652
|
+
/** Current source location of an anchored passage, or its lost quote. */
|
|
6653
|
+
readonly passage: v.OptionalSchema<v.ObjectSchema<{
|
|
6654
|
+
readonly quote: v.StringSchema<undefined>;
|
|
6655
|
+
readonly status: v.PicklistSchema<["located", "changed", "orphaned"], undefined>;
|
|
6656
|
+
readonly lines: v.NullableSchema<v.ObjectSchema<{
|
|
6657
|
+
readonly start: v.NumberSchema<undefined>;
|
|
6658
|
+
readonly end: v.NumberSchema<undefined>;
|
|
6659
|
+
}, undefined>, undefined>;
|
|
6660
|
+
}, undefined>, undefined>;
|
|
6661
|
+
/** The comment's text, already wrapped in the response's untrusted markers. */
|
|
6662
|
+
readonly body: v.StringSchema<undefined>;
|
|
6663
|
+
/**
|
|
6664
|
+
* What a comment Mossbear wrote is: a finding about the item, never an edit.
|
|
6665
|
+
* Present only on a Mossbear comment. The comment's `body` begins with the
|
|
6666
|
+
* claim (what goes wrong); this carries what the claim rests on.
|
|
6667
|
+
*/
|
|
6668
|
+
readonly finding: v.OptionalSchema<v.ObjectSchema<{
|
|
6669
|
+
readonly tier: v.PicklistSchema<["observed", "usage", "practice"], undefined>;
|
|
6670
|
+
/** How the finding is known, in one line: "Seen in 3 sessions (2026-09-15 – 2026-10-03)". */
|
|
6671
|
+
readonly tierLine: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 300, undefined>]>;
|
|
6672
|
+
/** What the drafter did not read, fixed per tier. */
|
|
6673
|
+
readonly blindSpot: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 300, undefined>]>;
|
|
6674
|
+
/** What should change in later sessions if the finding is fixed, wrapped in the untrusted markers. */
|
|
6675
|
+
readonly prediction: v.NullableSchema<v.StringSchema<undefined>, undefined>;
|
|
6676
|
+
}, undefined>, undefined>;
|
|
6677
|
+
/**
|
|
6678
|
+
* Whether the person approved a comment Mossbear drafted. Present on every
|
|
6679
|
+
* Mossbear comment and absent on a person's or an agent's, which are
|
|
6680
|
+
* requests as written. `false` is a draft nobody has read yet: a reader shows
|
|
6681
|
+
* it to the user and acts only on their go-ahead. Only a client that reports
|
|
6682
|
+
* a version able to mark drafts is ever listed one, so an older reader that
|
|
6683
|
+
* strips this field never receives a draft it would print as a request.
|
|
6684
|
+
*/
|
|
6685
|
+
readonly approved: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
|
|
6686
|
+
/** The author's display name as the workspace shows it, or null. Never an email. */
|
|
6687
|
+
readonly authorName: v.NullableSchema<v.StringSchema<undefined>, undefined>;
|
|
6688
|
+
/**
|
|
6689
|
+
* Who wrote it. Optional because a server that predates the field omits it;
|
|
6690
|
+
* a reader that meets a reply without it cannot tell whose it is, and a
|
|
6691
|
+
* server never sends a reply to a client too old to read this.
|
|
6692
|
+
*/
|
|
6693
|
+
readonly authorKind: v.OptionalSchema<v.PicklistSchema<["person", "agent", "mossbear"], undefined>, undefined>;
|
|
6694
|
+
/** ISO timestamp, machine format. */
|
|
6695
|
+
readonly createdAt: v.StringSchema<undefined>;
|
|
6696
|
+
/** The item's content version the comment was written against. */
|
|
6697
|
+
readonly itemVersion: v.NumberSchema<undefined>;
|
|
6698
|
+
/** True when the item's current version is greater than `itemVersion`. */
|
|
6699
|
+
readonly itemChangedSince: v.BooleanSchema<undefined>;
|
|
6700
|
+
/**
|
|
6701
|
+
* How many agent reads were handed this comment **before** this one — so a
|
|
6702
|
+
* comment reaching an agent for the first time reports `0`.
|
|
6703
|
+
*
|
|
6704
|
+
* It is the stored count as it read at the moment the response was built;
|
|
6705
|
+
* the serve this response *is* has not been counted yet. Excluded rather
|
|
6706
|
+
* than included because the count is recorded best-effort: a response that
|
|
6707
|
+
* claimed to include itself would be wrong whenever that record failed, and
|
|
6708
|
+
* a number that is sometimes off by one is worse than one that is
|
|
6709
|
+
* consistently the prior total.
|
|
6710
|
+
*
|
|
6711
|
+
* So `deliveredCount > 0` means an earlier read was handed this comment, and
|
|
6712
|
+
* `0` means this read is the first. Neither says a model took it in — only
|
|
6713
|
+
* that the server handed it over.
|
|
6714
|
+
*/
|
|
6715
|
+
readonly deliveredCount: v.NumberSchema<undefined>;
|
|
6716
|
+
/**
|
|
6717
|
+
* This comment's thread root: its own id on a root, the root's id on a reply.
|
|
6718
|
+
*
|
|
6719
|
+
* **Replies ride the same flat array**, each straight after its root, oldest
|
|
6720
|
+
* first. Only a client that reports a version able to render threads is
|
|
6721
|
+
* sent them; any other reader gets roots alone, as it always did. A person's
|
|
6722
|
+
* reply is part of the thread's request. An agent's reply is context: an
|
|
6723
|
+
* earlier message on the thread, never something to act on. A root an agent
|
|
6724
|
+
* wrote is delivered only once a person has replied to it, and is then the
|
|
6725
|
+
* question that reply answers, not a request of its own.
|
|
6726
|
+
*/
|
|
6727
|
+
readonly threadId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
6728
|
+
/**
|
|
6729
|
+
* `null` on a root; the root's id on a reply. Threads are one level deep, so
|
|
6730
|
+
* a reply's parent is always its root.
|
|
6731
|
+
*/
|
|
6732
|
+
readonly replyToId: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>;
|
|
6733
|
+
/**
|
|
6734
|
+
* On a root whose thread held more replies than
|
|
6735
|
+
* `MAX_REPLIES_PER_THREAD_ON_WIRE`: how many older ones were not sent.
|
|
6736
|
+
* Absent when the whole thread was sent.
|
|
6737
|
+
*/
|
|
6738
|
+
readonly repliesWithheld: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>, undefined>;
|
|
6739
|
+
}, undefined>, undefined>;
|
|
6740
|
+
/** Absent on the last page; pass it back as `cursor` for the next. */
|
|
6741
|
+
readonly nextCursor: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
|
|
6742
|
+
/** The markers every comment `body` is wrapped in; present when any comment came back. */
|
|
6743
|
+
readonly untrusted: v.OptionalSchema<v.NullableSchema<v.ObjectSchema<{
|
|
6744
|
+
readonly token: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
6745
|
+
readonly startMarker: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
6746
|
+
readonly endMarker: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
6747
|
+
readonly note: v.StringSchema<undefined>;
|
|
6748
|
+
}, undefined>, undefined>, undefined>;
|
|
6749
|
+
readonly grading: v.NullableSchema<v.ObjectSchema<{
|
|
6750
|
+
readonly guide: v.ObjectSchema<{
|
|
6751
|
+
readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
6752
|
+
readonly title: v.StringSchema<undefined>;
|
|
6753
|
+
readonly path: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 512, undefined>, v.CheckAction<string, "path must use forward slashes">, v.CheckAction<string, "path must be relative">, v.CheckAction<string, "path must not contain control characters">, v.CheckAction<string, "path must not contain empty, \".\" or \"..\" segments">]>, undefined>;
|
|
6754
|
+
readonly root: v.NullableSchema<v.PicklistSchema<["project", "global"], undefined>, undefined>;
|
|
6755
|
+
}, undefined>;
|
|
6756
|
+
/** The wording the window is about, or null when the guide has no revision identity. */
|
|
6757
|
+
readonly currentRevision: v.NullableSchema<v.ObjectSchema<{
|
|
6758
|
+
readonly bodyItemId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
6759
|
+
readonly version: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>]>;
|
|
6760
|
+
}, undefined>, undefined>;
|
|
6761
|
+
readonly state: v.PicklistSchema<["evaluated", "awaiting_current_revision", "unevaluated"], undefined>;
|
|
6762
|
+
readonly window: v.ObjectSchema<{
|
|
6763
|
+
/** Rows summarized, after the revision narrow. */
|
|
6764
|
+
readonly total: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>]>;
|
|
6765
|
+
readonly aligned: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>]>;
|
|
6766
|
+
readonly misaligned: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>]>;
|
|
6767
|
+
/** In context, never engaged. Neither a pass nor a failure. */
|
|
6768
|
+
readonly notApplicable: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>]>;
|
|
6769
|
+
/** `aligned + misaligned` — the rate's own denominator. */
|
|
6770
|
+
readonly applicable: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>]>;
|
|
6771
|
+
/** `aligned / applicable`, or **null when no run engaged the guide**. */
|
|
6772
|
+
readonly alignmentRate: v.NullableSchema<v.NumberSchema<undefined>, undefined>;
|
|
6773
|
+
/** The rows hit the per-guide cap: a bounded window, never a lifetime total. */
|
|
6774
|
+
readonly isWindowed: v.BooleanSchema<undefined>;
|
|
6775
|
+
/** The cap the rows were fetched under, so a reader can say what "windowed" means. */
|
|
6776
|
+
readonly windowSize: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>]>;
|
|
6777
|
+
/**
|
|
6778
|
+
* Verdicts fetched and then dropped by the revision narrow — about wording
|
|
6779
|
+
* that is no longer current, or citing no revision at all. A **floor** rather
|
|
6780
|
+
* than a total whenever `isWindowed`, because rows past the cap were never
|
|
6781
|
+
* fetched.
|
|
6782
|
+
*/
|
|
6783
|
+
readonly olderRevisionRows: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>]>;
|
|
6784
|
+
/**
|
|
6785
|
+
* `applicable` is too small for the percentage to mean anything — threshold
|
|
6786
|
+
* `applicable < 3` (founder, 2026-08-22). Read the counts, not the rate.
|
|
6787
|
+
*/
|
|
6788
|
+
readonly isLowConfidence: v.BooleanSchema<undefined>;
|
|
6789
|
+
}, undefined>;
|
|
6790
|
+
/**
|
|
6791
|
+
* The last edit's two windows, or **null when there is no earlier wording to
|
|
6792
|
+
* compare against**.
|
|
6793
|
+
*
|
|
6794
|
+
* Present-and-null rather than omitted: a guide on its first revision has no
|
|
6795
|
+
* delta, and that is an answer. An absent key would leave a reader unable to
|
|
6796
|
+
* tell "no edit to measure" from "this server does not report deltas".
|
|
6797
|
+
*/
|
|
6798
|
+
readonly change: v.NullableSchema<v.ObjectSchema<{
|
|
6799
|
+
/** The revision that preceded the change. */
|
|
6800
|
+
readonly before: v.ObjectSchema<{
|
|
6801
|
+
/** The wording this side judges. */
|
|
6802
|
+
readonly revision: v.ObjectSchema<{
|
|
6803
|
+
readonly bodyItemId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
6804
|
+
readonly version: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>]>;
|
|
6805
|
+
}, undefined>;
|
|
6806
|
+
/** Rows in this side's window, including the runs that never engaged it. */
|
|
6807
|
+
readonly total: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>]>;
|
|
6808
|
+
readonly aligned: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>]>;
|
|
6809
|
+
readonly misaligned: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>]>;
|
|
6810
|
+
readonly notApplicable: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>]>;
|
|
6811
|
+
/** `aligned + misaligned` — this side's own denominator. */
|
|
6812
|
+
readonly applicable: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>]>;
|
|
6813
|
+
/** `aligned / applicable`, or null when no run engaged this wording. */
|
|
6814
|
+
readonly alignmentRate: v.NullableSchema<v.NumberSchema<undefined>, undefined>;
|
|
6815
|
+
/** This side is below the sample floor, so read its counts and not its rate. */
|
|
6816
|
+
readonly isLowConfidence: v.BooleanSchema<undefined>;
|
|
6817
|
+
/**
|
|
6818
|
+
* This side is a bounded sample of its revision rather than the whole record.
|
|
6819
|
+
* A saturated side beside an unsaturated one is two different kinds of
|
|
6820
|
+
* number, and comparing them without saying so is the defect the flag exists
|
|
6821
|
+
* to stop.
|
|
6822
|
+
*/
|
|
6823
|
+
readonly isSaturated: v.BooleanSchema<undefined>;
|
|
6824
|
+
/** The span this side covers, ISO. Both null on a side with no rows. */
|
|
6825
|
+
readonly newestAt: v.NullableSchema<v.StringSchema<undefined>, undefined>;
|
|
6826
|
+
readonly oldestAt: v.NullableSchema<v.StringSchema<undefined>, undefined>;
|
|
6827
|
+
}, undefined>;
|
|
6828
|
+
/** The wording the guide stands at now. */
|
|
6829
|
+
readonly since: v.ObjectSchema<{
|
|
6830
|
+
/** The wording this side judges. */
|
|
6831
|
+
readonly revision: v.ObjectSchema<{
|
|
6832
|
+
readonly bodyItemId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
6833
|
+
readonly version: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>]>;
|
|
6834
|
+
}, undefined>;
|
|
6835
|
+
/** Rows in this side's window, including the runs that never engaged it. */
|
|
6836
|
+
readonly total: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>]>;
|
|
6837
|
+
readonly aligned: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>]>;
|
|
6838
|
+
readonly misaligned: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>]>;
|
|
6839
|
+
readonly notApplicable: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>]>;
|
|
6840
|
+
/** `aligned + misaligned` — this side's own denominator. */
|
|
6841
|
+
readonly applicable: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>]>;
|
|
6842
|
+
/** `aligned / applicable`, or null when no run engaged this wording. */
|
|
6843
|
+
readonly alignmentRate: v.NullableSchema<v.NumberSchema<undefined>, undefined>;
|
|
6844
|
+
/** This side is below the sample floor, so read its counts and not its rate. */
|
|
6845
|
+
readonly isLowConfidence: v.BooleanSchema<undefined>;
|
|
6846
|
+
/**
|
|
6847
|
+
* This side is a bounded sample of its revision rather than the whole record.
|
|
6848
|
+
* A saturated side beside an unsaturated one is two different kinds of
|
|
6849
|
+
* number, and comparing them without saying so is the defect the flag exists
|
|
6850
|
+
* to stop.
|
|
6851
|
+
*/
|
|
6852
|
+
readonly isSaturated: v.BooleanSchema<undefined>;
|
|
6853
|
+
/** The span this side covers, ISO. Both null on a side with no rows. */
|
|
6854
|
+
readonly newestAt: v.NullableSchema<v.StringSchema<undefined>, undefined>;
|
|
6855
|
+
readonly oldestAt: v.NullableSchema<v.StringSchema<undefined>, undefined>;
|
|
6856
|
+
}, undefined>;
|
|
6857
|
+
/**
|
|
6858
|
+
* `since` minus `before`, in `[-1, 1]`, or **null whenever the pair is
|
|
6859
|
+
* suppressed** or either side never engaged the guide. Null is not zero: one
|
|
6860
|
+
* says the evidence does not support a number, the other would be a claim.
|
|
6861
|
+
*/
|
|
6862
|
+
readonly alignmentRateDelta: v.NullableSchema<v.NumberSchema<undefined>, undefined>;
|
|
6863
|
+
/**
|
|
6864
|
+
* Which side is below the sample floor, or null when neither is and the delta
|
|
6865
|
+
* stands. `'since'` is the ordinary post-edit state — *not enough runs since
|
|
6866
|
+
* this change* — and is reported rather than omitted.
|
|
6867
|
+
*/
|
|
6868
|
+
readonly suppressedBy: v.NullableSchema<v.PicklistSchema<["since", "before", "both"], undefined>, undefined>;
|
|
6869
|
+
/** The delta's sign, or null while it is withheld. `unchanged` is exactly zero. */
|
|
6870
|
+
readonly direction: v.NullableSchema<v.PicklistSchema<["improved", "regressed", "unchanged"], undefined>, undefined>;
|
|
6871
|
+
/** Either side is a bounded sample, so neither is a lifetime total. */
|
|
6872
|
+
readonly isWindowed: v.BooleanSchema<undefined>;
|
|
6873
|
+
/** The per-revision cap each side was bounded by, so "sample" has a size. */
|
|
6874
|
+
readonly windowSize: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>]>;
|
|
6875
|
+
/**
|
|
6876
|
+
* When the current wording was recorded, ISO — the boundary between the two
|
|
6877
|
+
* windows, and null when no version row carries it.
|
|
6878
|
+
*
|
|
6879
|
+
* A date, never an attribution: it says when the window opened, not that the
|
|
6880
|
+
* edit caused what happened inside it.
|
|
6881
|
+
*/
|
|
6882
|
+
readonly changedAt: v.NullableSchema<v.StringSchema<undefined>, undefined>;
|
|
6883
|
+
}, undefined>, undefined>;
|
|
6884
|
+
readonly findings: v.ArraySchema<v.ObjectSchema<{
|
|
6885
|
+
readonly sessionId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
6886
|
+
readonly occurredAt: v.StringSchema<undefined>;
|
|
6887
|
+
readonly revision: v.NullableSchema<v.ObjectSchema<{
|
|
6888
|
+
readonly bodyItemId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
6889
|
+
readonly version: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>]>;
|
|
6890
|
+
}, undefined>, undefined>;
|
|
6891
|
+
readonly isCurrentRevision: v.BooleanSchema<undefined>;
|
|
6892
|
+
readonly reasoning: v.StringSchema<undefined>;
|
|
6893
|
+
}, undefined>, undefined>;
|
|
6894
|
+
/**
|
|
6895
|
+
* Misaligned rows in the window beyond the `MAX_GUIDE_HISTORY_FINDINGS`
|
|
6896
|
+
* returned. Reported rather than silently truncated: a caller reading five
|
|
6897
|
+
* findings has no other way to know it is reading five of forty.
|
|
6898
|
+
*/
|
|
6899
|
+
readonly findingsOmitted: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>]>;
|
|
6900
|
+
/**
|
|
6901
|
+
* The caller's newest stored failure-pattern analysis of this guide, or
|
|
6902
|
+
* **null when they have never asked for one**. Optional because a server
|
|
6903
|
+
* that predates it sends no key; a reader must not take absence for "never
|
|
6904
|
+
* analysed".
|
|
6905
|
+
*/
|
|
6906
|
+
readonly analysis: v.OptionalSchema<v.NullableSchema<v.ObjectSchema<{
|
|
6907
|
+
readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
6908
|
+
/** When it was written, ISO. */
|
|
6909
|
+
readonly createdAt: v.StringSchema<undefined>;
|
|
6910
|
+
readonly outcome: v.PicklistSchema<["pattern", "no_pattern"], undefined>;
|
|
6911
|
+
readonly summary: v.StringSchema<undefined>;
|
|
6912
|
+
/** Failed sessions the analysis read. */
|
|
6913
|
+
readonly sessionsAnalysed: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>]>;
|
|
6914
|
+
/** Failed sessions it left out to stay within its prompt's cap. */
|
|
6915
|
+
readonly sessionsOmitted: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>]>;
|
|
6916
|
+
readonly stale: v.BooleanSchema<undefined>;
|
|
6917
|
+
/** Why it is out of date, or null while it is current. */
|
|
6918
|
+
readonly staleReason: v.NullableSchema<v.PicklistSchema<["revision_changed", "new_failures"], undefined>, undefined>;
|
|
6919
|
+
/** Failures it has not read, when `staleReason` is `new_failures`; else null. */
|
|
6920
|
+
readonly newFailures: v.NullableSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>]>, undefined>;
|
|
6921
|
+
}, undefined>, undefined>, undefined>;
|
|
6922
|
+
readonly untrusted: v.ObjectSchema<{
|
|
6923
|
+
readonly token: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
6924
|
+
readonly startMarker: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
6925
|
+
readonly endMarker: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
6926
|
+
readonly note: v.StringSchema<undefined>;
|
|
6927
|
+
}, undefined>;
|
|
6928
|
+
}, undefined>, undefined>;
|
|
6929
|
+
/** Present exactly when `grading` is null. */
|
|
6930
|
+
readonly gradingUnavailable: v.OptionalSchema<v.ObjectSchema<{
|
|
6931
|
+
readonly code: v.PicklistSchema<["not-graded", "not-available-to-credential"], undefined>;
|
|
6932
|
+
readonly reason: v.StringSchema<undefined>;
|
|
6933
|
+
}, undefined>, undefined>;
|
|
6934
|
+
}, undefined>, undefined>;
|
|
6935
|
+
/** Set on a null `feedback` that is a failed read, not an unreadable id: ask again. */
|
|
6936
|
+
readonly unavailable: v.OptionalSchema<v.LiteralSchema<true, undefined>, undefined>;
|
|
6937
|
+
}, undefined>, undefined>;
|
|
6938
|
+
}, undefined>;
|
|
6939
|
+
export type ArtifactFeedbackBatchResponse = v.InferOutput<typeof ArtifactFeedbackBatchResponseSchema>;
|
|
6466
6940
|
export declare const SessionGradeRequestSchema: v.SchemaWithPipe<readonly [v.ObjectSchema<{
|
|
6467
6941
|
readonly session: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 256, undefined>, v.CheckAction<string, "identifier must not contain control characters">]>, undefined>;
|
|
6468
6942
|
readonly agent_session: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 256, undefined>, v.CheckAction<string, "identifier must not contain control characters">]>, undefined>;
|
|
@@ -7883,10 +8357,18 @@ export declare function parseCreateBundleResponse(data: unknown): {
|
|
|
7883
8357
|
};
|
|
7884
8358
|
export declare function parseAttachBundleMemberRequest(data: unknown): {
|
|
7885
8359
|
artifactId: string;
|
|
8360
|
+
} | {
|
|
8361
|
+
artifactIds: string[];
|
|
7886
8362
|
};
|
|
7887
8363
|
export declare function parseAttachBundleMemberResponse(data: unknown): {
|
|
7888
8364
|
attached: boolean;
|
|
7889
8365
|
};
|
|
8366
|
+
export declare function parseAttachBundleMembersResponse(data: unknown): {
|
|
8367
|
+
results: {
|
|
8368
|
+
artifactId: string;
|
|
8369
|
+
status: "added" | "already_there" | "unavailable" | "path_taken";
|
|
8370
|
+
}[];
|
|
8371
|
+
};
|
|
7890
8372
|
export declare function parseDetachBundleMemberResponse(data: unknown): {
|
|
7891
8373
|
detached: boolean;
|
|
7892
8374
|
};
|
|
@@ -8348,6 +8830,10 @@ export declare function parseGuideHistoryResponse(data: unknown): {
|
|
|
8348
8830
|
export declare function parseAnnounceItemCommentsRequest(data: unknown): {
|
|
8349
8831
|
projectId: string;
|
|
8350
8832
|
bundleIds: string[];
|
|
8833
|
+
cliVersion?: string | undefined;
|
|
8834
|
+
};
|
|
8835
|
+
export declare function parseResolveItemCommentResponse(data: unknown): {
|
|
8836
|
+
resolved: true;
|
|
8351
8837
|
};
|
|
8352
8838
|
export declare function parseAnnounceItemCommentsResponse(data: unknown): {
|
|
8353
8839
|
open: number;
|