@mossbear/protocol 0.1.0-alpha.87 → 0.1.0-alpha.89
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 +5 -0
- package/dist/artifact.test.js.map +1 -1
- package/dist/bundleSlug.d.ts +11 -0
- package/dist/bundleSlug.d.ts.map +1 -1
- package/dist/bundleSlug.js +16 -6
- package/dist/bundleSlug.js.map +1 -1
- package/dist/contextKinds.d.ts +5 -8
- package/dist/contextKinds.d.ts.map +1 -1
- package/dist/contextKinds.js +5 -8
- package/dist/contextKinds.js.map +1 -1
- package/dist/contextKinds.test.js +2 -10
- package/dist/contextKinds.test.js.map +1 -1
- package/dist/limits.d.ts +12 -0
- package/dist/limits.d.ts.map +1 -0
- package/dist/limits.js +12 -0
- package/dist/limits.js.map +1 -0
- package/dist/schemas.d.ts +784 -2778
- package/dist/schemas.d.ts.map +1 -1
- package/dist/schemas.js +62 -355
- package/dist/schemas.js.map +1 -1
- package/dist/schemas.test.js +35 -142
- package/dist/schemas.test.js.map +1 -1
- package/dist/types.d.ts +5 -10
- 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
|
@@ -8,6 +8,7 @@
|
|
|
8
8
|
* input) or call `v.safeParse(Schema, data)` directly for non-throwing checks.
|
|
9
9
|
*/
|
|
10
10
|
import * as v from 'valibot';
|
|
11
|
+
import { MAX_CONTEXT_CONTENT_BYTES, MAX_RAW_GUIDE_CONTENT_BYTES } from './limits.js';
|
|
11
12
|
export declare const VerdictSchema: v.PicklistSchema<["aligned", "unguided", "misaligned"], undefined>;
|
|
12
13
|
export declare const GuidingTierSchema: v.PicklistSchema<["pattern_match", "cached", "llm", "batch"], undefined>;
|
|
13
14
|
/**
|
|
@@ -56,8 +57,7 @@ export type HarnessId = v.InferOutput<typeof HarnessIdSchema>;
|
|
|
56
57
|
export declare const SessionEnvironmentSchema: v.PicklistSchema<["cloud"], undefined>;
|
|
57
58
|
export type SessionEnvironment = v.InferOutput<typeof SessionEnvironmentSchema>;
|
|
58
59
|
export declare const GuideFileFormatSchema: v.PicklistSchema<["agents-md", "agents-dir", "claude-md", "claude-rules", "cursorrules", "cursor-rules", "skill-md"], undefined>;
|
|
59
|
-
|
|
60
|
-
export declare const MAX_RAW_GUIDE_CONTENT_BYTES: number;
|
|
60
|
+
export { MAX_RAW_GUIDE_CONTENT_BYTES };
|
|
61
61
|
/** Max member files a single skill-md payload may carry. */
|
|
62
62
|
export declare const MAX_SKILL_MEMBER_FILES = 64;
|
|
63
63
|
export declare const SafeRelativePosixPathSchema: 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">]>;
|
|
@@ -291,7 +291,7 @@ export declare const RulesImportRequestSchema: v.ObjectSchema<{
|
|
|
291
291
|
* Deliberately looser than `RepoIdSchema`: a generated id is
|
|
292
292
|
* `proj_`+hex, but a *declared* one is whatever a human committed —
|
|
293
293
|
* `readRepoProjectId` accepts any non-empty trimmed string
|
|
294
|
-
* (`packages/cli/src/
|
|
294
|
+
* (`packages/cli/src/artifacts/repo-config.ts`), and rejecting those here would
|
|
295
295
|
* break a shipped contract. Constrained only as far as it must be to serve as
|
|
296
296
|
* a storage key: no whitespace, no path separators, no control characters,
|
|
297
297
|
* bounded length.
|
|
@@ -555,10 +555,10 @@ export declare const DISPLAY_NAME_CONTROL_CHARACTER_MESSAGE = "Remove the invisi
|
|
|
555
555
|
export declare function displayNameSchema(maxLength: number): v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, number, undefined>, v.CheckAction<string, "Remove the invisible characters from this name — copying text from another app often brings them along.">, v.RegexAction<string, "Remove the invisible characters from this name — copying text from another app often brings them along.">]>;
|
|
556
556
|
/** A bundle's display name. Bundles are addressed by slug; this is the label. */
|
|
557
557
|
export declare const BUNDLE_NAME_MAX_LENGTH = 200;
|
|
558
|
-
export declare const BundleSlugSchema: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.
|
|
558
|
+
export declare const BundleSlugSchema: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.CheckAction<string, "slug must be lowercase alphanumeric with hyphens, at most 64 characters">]>;
|
|
559
559
|
export declare const BundleSchema: v.ObjectSchema<{
|
|
560
560
|
readonly id: v.StringSchema<undefined>;
|
|
561
|
-
readonly slug: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.
|
|
561
|
+
readonly slug: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.CheckAction<string, "slug must be lowercase alphanumeric with hyphens, at most 64 characters">]>;
|
|
562
562
|
readonly name: v.StringSchema<undefined>;
|
|
563
563
|
readonly createdAt: v.StringSchema<undefined>;
|
|
564
564
|
/**
|
|
@@ -577,7 +577,7 @@ export declare const BundleSchema: v.ObjectSchema<{
|
|
|
577
577
|
export declare const BundleListResponseSchema: v.ObjectSchema<{
|
|
578
578
|
readonly bundles: v.ArraySchema<v.ObjectSchema<{
|
|
579
579
|
readonly id: v.StringSchema<undefined>;
|
|
580
|
-
readonly slug: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.
|
|
580
|
+
readonly slug: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.CheckAction<string, "slug must be lowercase alphanumeric with hyphens, at most 64 characters">]>;
|
|
581
581
|
readonly name: v.StringSchema<undefined>;
|
|
582
582
|
readonly createdAt: v.StringSchema<undefined>;
|
|
583
583
|
/**
|
|
@@ -652,7 +652,7 @@ export declare const SubscriptionScopeSchema: v.PicklistSchema<["repo", "user"],
|
|
|
652
652
|
export declare const DeliverTargetSchema: v.PicklistSchema<["repo", "global"], undefined>;
|
|
653
653
|
export declare const ResolvedSubscriptionSchema: v.ObjectSchema<{
|
|
654
654
|
readonly id: v.StringSchema<undefined>;
|
|
655
|
-
readonly slug: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.
|
|
655
|
+
readonly slug: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.CheckAction<string, "slug must be lowercase alphanumeric with hyphens, at most 64 characters">]>;
|
|
656
656
|
readonly name: v.StringSchema<undefined>;
|
|
657
657
|
/** Every scope that names this bundle. Never empty; may hold both. */
|
|
658
658
|
readonly scopes: v.SchemaWithPipe<readonly [v.ArraySchema<v.PicklistSchema<["repo", "user"], undefined>, undefined>, v.MinLengthAction<("repo" | "user")[], 1, undefined>]>;
|
|
@@ -666,7 +666,7 @@ export declare const ResolvedSubscriptionSchema: v.ObjectSchema<{
|
|
|
666
666
|
* trip at all. Echoing a value the caller just sent would make the server look
|
|
667
667
|
* like the authority on a fact it does not hold. The caller pairs this with
|
|
668
668
|
* its own committed `deliver` to build the per-scope target set
|
|
669
|
-
* (`packages/cli/src/
|
|
669
|
+
* (`packages/cli/src/artifacts/delivery.ts` → `deliveryBundles`).
|
|
670
670
|
*
|
|
671
671
|
* Optional rather than nullable so a CLI built before this field parses a new
|
|
672
672
|
* server's response unchanged, and a new CLI reads an old server's response as
|
|
@@ -713,7 +713,7 @@ export declare const ResolveSubscriptionsResponseSchema: v.ObjectSchema<{
|
|
|
713
713
|
/** The effective delivery set, de-duplicated by bundle id. */
|
|
714
714
|
readonly bundles: v.ArraySchema<v.ObjectSchema<{
|
|
715
715
|
readonly id: v.StringSchema<undefined>;
|
|
716
|
-
readonly slug: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.
|
|
716
|
+
readonly slug: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.CheckAction<string, "slug must be lowercase alphanumeric with hyphens, at most 64 characters">]>;
|
|
717
717
|
readonly name: v.StringSchema<undefined>;
|
|
718
718
|
/** Every scope that names this bundle. Never empty; may hold both. */
|
|
719
719
|
readonly scopes: v.SchemaWithPipe<readonly [v.ArraySchema<v.PicklistSchema<["repo", "user"], undefined>, undefined>, v.MinLengthAction<("repo" | "user")[], 1, undefined>]>;
|
|
@@ -727,7 +727,7 @@ export declare const ResolveSubscriptionsResponseSchema: v.ObjectSchema<{
|
|
|
727
727
|
* trip at all. Echoing a value the caller just sent would make the server look
|
|
728
728
|
* like the authority on a fact it does not hold. The caller pairs this with
|
|
729
729
|
* its own committed `deliver` to build the per-scope target set
|
|
730
|
-
* (`packages/cli/src/
|
|
730
|
+
* (`packages/cli/src/artifacts/delivery.ts` → `deliveryBundles`).
|
|
731
731
|
*
|
|
732
732
|
* Optional rather than nullable so a CLI built before this field parses a new
|
|
733
733
|
* server's response unchanged, and a new CLI reads an old server's response as
|
|
@@ -837,13 +837,13 @@ export declare const SubscribeBundleResponseSchema: v.ObjectSchema<{
|
|
|
837
837
|
readonly muted: v.OptionalSchema<v.ArraySchema<v.StringSchema<undefined>, undefined>, undefined>;
|
|
838
838
|
}, undefined>;
|
|
839
839
|
export declare const CreateBundleRequestSchema: v.ObjectSchema<{
|
|
840
|
-
readonly slug: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.
|
|
840
|
+
readonly slug: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.CheckAction<string, "slug must be lowercase alphanumeric with hyphens, at most 64 characters">]>;
|
|
841
841
|
readonly name: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, number, undefined>, v.CheckAction<string, "Remove the invisible characters from this name — copying text from another app often brings them along.">, v.RegexAction<string, "Remove the invisible characters from this name — copying text from another app often brings them along.">]>;
|
|
842
842
|
}, undefined>;
|
|
843
843
|
export declare const CreateBundleResponseSchema: v.ObjectSchema<{
|
|
844
844
|
readonly bundle: v.ObjectSchema<{
|
|
845
845
|
readonly id: v.StringSchema<undefined>;
|
|
846
|
-
readonly slug: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.
|
|
846
|
+
readonly slug: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.CheckAction<string, "slug must be lowercase alphanumeric with hyphens, at most 64 characters">]>;
|
|
847
847
|
readonly name: v.StringSchema<undefined>;
|
|
848
848
|
readonly createdAt: v.StringSchema<undefined>;
|
|
849
849
|
/**
|
|
@@ -924,9 +924,23 @@ export declare const ListScopedTokensResponseSchema: v.ObjectSchema<{
|
|
|
924
924
|
export declare const RevokeScopedTokenRequestSchema: v.ObjectSchema<{
|
|
925
925
|
readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
926
926
|
}, undefined>;
|
|
927
|
-
|
|
928
|
-
|
|
929
|
-
|
|
927
|
+
/**
|
|
928
|
+
* The member to attach, by its artifact id. `itemId` is the name a CLI from before
|
|
929
|
+
* release step 2 sends; both are read, and the parsed value is always `artifactId`.
|
|
930
|
+
* Drop `itemId` once no such CLI is left to send it.
|
|
931
|
+
*/
|
|
932
|
+
export declare const AttachBundleMemberRequestSchema: v.SchemaWithPipe<readonly [v.ObjectSchema<{
|
|
933
|
+
readonly artifactId: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>;
|
|
934
|
+
readonly itemId: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>;
|
|
935
|
+
}, undefined>, v.CheckAction<{
|
|
936
|
+
artifactId?: string | undefined;
|
|
937
|
+
itemId?: string | undefined;
|
|
938
|
+
}, "A member needs an artifactId.">, v.TransformAction<{
|
|
939
|
+
artifactId?: string | undefined;
|
|
940
|
+
itemId?: string | undefined;
|
|
941
|
+
}, {
|
|
942
|
+
artifactId: string;
|
|
943
|
+
}>]>;
|
|
930
944
|
export declare const AttachBundleMemberResponseSchema: v.ObjectSchema<{
|
|
931
945
|
readonly attached: v.BooleanSchema<undefined>;
|
|
932
946
|
}, undefined>;
|
|
@@ -954,7 +968,7 @@ export declare const UpdateBundleRequestSchema: v.SchemaWithPipe<readonly [v.Obj
|
|
|
954
968
|
export declare const UpdateBundleResponseSchema: v.ObjectSchema<{
|
|
955
969
|
readonly bundle: v.ObjectSchema<{
|
|
956
970
|
readonly id: v.StringSchema<undefined>;
|
|
957
|
-
readonly slug: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.
|
|
971
|
+
readonly slug: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.CheckAction<string, "slug must be lowercase alphanumeric with hyphens, at most 64 characters">]>;
|
|
958
972
|
readonly name: v.StringSchema<undefined>;
|
|
959
973
|
readonly createdAt: v.StringSchema<undefined>;
|
|
960
974
|
/**
|
|
@@ -984,10 +998,8 @@ export declare const ContextItemTypeSchema: v.PicklistSchema<string[], undefined
|
|
|
984
998
|
* the release that moved the CLI's own vocabulary onto `content`.
|
|
985
999
|
*/
|
|
986
1000
|
export declare const ContextItemTypeFilterSchema: v.PicklistSchema<string[], undefined>;
|
|
987
|
-
export declare const PushContentTypeSchema: v.PicklistSchema<("content" | "asset")[], undefined>;
|
|
988
1001
|
export declare const InboxContentTypeSchema: v.PicklistSchema<("content" | "asset")[], undefined>;
|
|
989
|
-
|
|
990
|
-
export declare const MAX_CONTEXT_CONTENT_BYTES: number;
|
|
1002
|
+
export { MAX_CONTEXT_CONTENT_BYTES };
|
|
991
1003
|
/**
|
|
992
1004
|
* Max alias paths one guide reports. Three root instruction files and two
|
|
993
1005
|
* skills directories are the whole population today
|
|
@@ -2055,727 +2067,96 @@ export declare const ContextItemsResponseSchema: v.ObjectSchema<{
|
|
|
2055
2067
|
}, undefined>, undefined>, undefined>;
|
|
2056
2068
|
}, undefined>;
|
|
2057
2069
|
/**
|
|
2058
|
-
*
|
|
2059
|
-
*
|
|
2060
|
-
* A repo's delivery set is the union of its committed subscriptions and the
|
|
2061
|
-
* reader's account ones, so this bounds a request, not a product limit: a
|
|
2062
|
-
* reader subscribing to more bundles than this asks in two calls rather than
|
|
2063
|
-
* losing the tail silently.
|
|
2064
|
-
*/
|
|
2065
|
-
export declare const MAX_COMMENT_BUNDLE_IDS = 100;
|
|
2066
|
-
/**
|
|
2067
|
-
* How many times one subscriber is told, in one repo, that a given comment is
|
|
2068
|
-
* waiting before the hook falls silent about it.
|
|
2069
|
-
*
|
|
2070
|
-
* **A cap on the interruption, never on the comment.** After it is reached the
|
|
2071
|
-
* comment is still open, still on the item page, and still returned in full by
|
|
2072
|
-
* the on-demand read — it simply stops being announced in front of the first
|
|
2073
|
-
* turn of every session. So silence here means "nothing new to interrupt you
|
|
2074
|
-
* about", never "nobody left anything".
|
|
2075
|
-
*
|
|
2076
|
-
* Three rather than one, for the reason the announcement exists: the first
|
|
2077
|
-
* session in a repo is often doing unrelated work, so a one-shot announcement
|
|
2078
|
-
* would routinely spend itself on the session least likely to act. Three is a
|
|
2079
|
-
* judgement, named so replacing it is one edit — the same discipline the live
|
|
2080
|
-
* session window is held to.
|
|
2081
|
-
*/
|
|
2082
|
-
export declare const MAX_COMMENT_ANNOUNCEMENTS_PER_REPO = 3;
|
|
2083
|
-
/**
|
|
2084
|
-
* Ask which comments are waiting for this reader in this repo, and be counted as
|
|
2085
|
-
* told.
|
|
2086
|
-
*
|
|
2087
|
-
* **A write, because being told is a fact the server has to keep.** The count
|
|
2088
|
-
* cannot be `item_comments.delivered_count` — that is one global number across
|
|
2089
|
-
* every subscriber and every repo, so one reader's fill of a comment would
|
|
2090
|
-
* silence it for everyone — and it cannot live in the checkout, because the
|
|
2091
|
-
* disposable environments this exists for rebuild the clone every session and
|
|
2092
|
-
* a counter there resets with it, announcing every unresolved comment as new
|
|
2093
|
-
* forever.
|
|
2094
|
-
*/
|
|
2095
|
-
export declare const AnnounceItemCommentsRequestSchema: v.ObjectSchema<{
|
|
2096
|
-
/**
|
|
2097
|
-
* The repo, as its committed config declares it. Required: it is the scope
|
|
2098
|
-
* the count is kept under, and a request with nothing to key on could only
|
|
2099
|
-
* be answered by an uncapped announcement — which is the repeating broadcast
|
|
2100
|
-
* this route exists to end.
|
|
2101
|
-
*/
|
|
2102
|
-
readonly projectId: 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">]>;
|
|
2103
|
-
/**
|
|
2104
|
-
* The bundles this repo receives — the union the caller already resolved.
|
|
2105
|
-
*
|
|
2106
|
-
* Sent rather than derived, because only half of it is the server's to know:
|
|
2107
|
-
* a repo-scoped subscription lives in the committed config and travels by
|
|
2108
|
-
* `git clone`. Declaring a bundle grants nothing: every one of them is still
|
|
2109
|
-
* filtered by the caller's own workspace membership.
|
|
2110
|
-
*/
|
|
2111
|
-
readonly bundleIds: v.SchemaWithPipe<readonly [v.ArraySchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>, v.MaxLengthAction<string[], 100, undefined>]>;
|
|
2112
|
-
}, undefined>;
|
|
2113
|
-
export type AnnounceItemCommentsRequest = v.InferOutput<typeof AnnounceItemCommentsRequestSchema>;
|
|
2114
|
-
/**
|
|
2115
|
-
* What an announcement answers: how many comments are waiting, and how many of
|
|
2116
|
-
* them this call was counted as announcing.
|
|
2117
|
-
*
|
|
2118
|
-
* **Two numbers because they answer two questions and a reader needs both.**
|
|
2119
|
-
* `open` is the true state of this repo's comments and is what a caller shows a
|
|
2120
|
-
* person — a number that is sometimes a subset of the truth would be worse
|
|
2121
|
-
* than the silence it replaced. `announced` is how many of those were still
|
|
2122
|
-
* under the cap, and it is the one that decides whether to speak at all: zero
|
|
2123
|
-
* means this reader has already been told about every one of them as often as
|
|
2124
|
-
* the cap allows.
|
|
2125
|
-
*/
|
|
2126
|
-
export declare const AnnounceItemCommentsResponseSchema: v.ObjectSchema<{
|
|
2127
|
-
/** Open, unmuted comments about the items these bundles deliver to this reader. */
|
|
2128
|
-
readonly open: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
|
|
2129
|
-
/** How many of those were under the cap and have now been counted as announced. */
|
|
2130
|
-
readonly announced: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
|
|
2131
|
-
}, undefined>;
|
|
2132
|
-
export type AnnounceItemCommentsResponse = v.InferOutput<typeof AnnounceItemCommentsResponseSchema>;
|
|
2133
|
-
/**
|
|
2134
|
-
* How many comments one agent session may leave on one subject, not counting its
|
|
2135
|
-
* whole-subject comment. Anchored comments and replies share it.
|
|
2136
|
-
*/
|
|
2137
|
-
export declare const MAX_AGENT_COMMENTS_PER_SUBJECT = 50;
|
|
2138
|
-
/** The longest an agent comment's text may be, in characters. */
|
|
2139
|
-
export declare const MAX_AGENT_COMMENT_BODY_CHARS = 4000;
|
|
2140
|
-
/**
|
|
2141
|
-
* Why an agent comment was refused, as the `code` on the error body. A caller
|
|
2142
|
-
* branches on these; the message beside one is for a person.
|
|
2143
|
-
*/
|
|
2144
|
-
export declare const AGENT_COMMENT_ERROR_CODES: readonly ["agent_session_required", "agent_comment_limit_reached", "agent_comment_text_only", "agent_comment_target_missing", "agent_comment_passage_not_found", "agent_comment_passage_ambiguous", "item_comment_limit_reached"];
|
|
2145
|
-
export declare const AgentCommentErrorCodeSchema: v.PicklistSchema<readonly ["agent_session_required", "agent_comment_limit_reached", "agent_comment_text_only", "agent_comment_target_missing", "agent_comment_passage_not_found", "agent_comment_passage_ambiguous", "item_comment_limit_reached"], undefined>;
|
|
2146
|
-
export type AgentCommentErrorCode = v.InferOutput<typeof AgentCommentErrorCodeSchema>;
|
|
2147
|
-
/**
|
|
2148
|
-
* Leave a comment, or reply to one, as an agent (`POST /api/v1/context/comments`).
|
|
2149
|
-
*
|
|
2150
|
-
* **`target` names what the comment is about, one way.** `artifact` is the id
|
|
2151
|
-
* a bundle read gave for a guide or document, and `item` is its older name for
|
|
2152
|
-
* the same thing, accepted until every client sends `artifact`. `session` is an
|
|
2153
|
-
* agent session id of the caller's own (the key a search hit and the session digest hand out), and
|
|
2154
|
-
* `reply` is the id of a comment to answer. A reply joins that comment's thread
|
|
2155
|
-
* and the subject it is about.
|
|
2156
|
-
*
|
|
2157
|
-
* **Who the agent is comes from `agent`, and `sessionId` is the harness's own
|
|
2158
|
-
* id as the CLI read it.** A request without one is refused with
|
|
2159
|
-
* `agent_session_required`, and the CLI and tool offer no way to type one. The
|
|
2160
|
-
* server cannot check it against the harness, so it is a claim by the holder of
|
|
2161
|
-
* the token: the comment is always written under that token's account, and the
|
|
2162
|
-
* handle shown for it names a session only as far as the claim is true.
|
|
2163
|
-
*
|
|
2164
|
-
* **Text only.** There is no replacement-text field, and a request that carries
|
|
2165
|
-
* one is refused with `agent_comment_text_only` rather than having it dropped.
|
|
2166
|
-
*/
|
|
2167
|
-
export declare const AgentCommentRequestSchema: v.ObjectSchema<{
|
|
2168
|
-
readonly target: v.VariantSchema<"kind", [v.ObjectSchema<{
|
|
2169
|
-
readonly kind: v.LiteralSchema<"artifact", undefined>;
|
|
2170
|
-
readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 128, undefined>]>;
|
|
2171
|
-
}, undefined>, v.ObjectSchema<{
|
|
2172
|
-
readonly kind: v.LiteralSchema<"item", undefined>;
|
|
2173
|
-
readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 128, undefined>]>;
|
|
2174
|
-
}, undefined>, v.ObjectSchema<{
|
|
2175
|
-
readonly kind: v.LiteralSchema<"session", undefined>;
|
|
2176
|
-
readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 128, undefined>]>;
|
|
2177
|
-
}, undefined>, v.ObjectSchema<{
|
|
2178
|
-
readonly kind: v.LiteralSchema<"reply", undefined>;
|
|
2179
|
-
readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 128, undefined>]>;
|
|
2180
|
-
}, undefined>], undefined>;
|
|
2181
|
-
readonly body: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 4000, undefined>]>;
|
|
2182
|
-
/**
|
|
2183
|
-
* The passage an item comment is about, as the exact text of one or more whole
|
|
2184
|
-
* lines of the item (a paragraph, a heading, a list). None means the item as a
|
|
2185
|
-
* whole. The server finds the lines; a passage that is not in the item as it is
|
|
2186
|
-
* now is refused with `agent_comment_passage_not_found`.
|
|
2187
|
-
*/
|
|
2188
|
-
readonly passage: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 8000, undefined>]>, undefined>;
|
|
2189
|
-
readonly agent: v.ObjectSchema<{
|
|
2190
|
-
readonly sessionId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 128, undefined>]>;
|
|
2191
|
-
readonly harness: v.PicklistSchema<["claude_code", "codex", "antigravity", "opencode"], undefined>;
|
|
2192
|
-
/** The agent's own statement of its model, when it knows it. */
|
|
2193
|
-
readonly model: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 100, undefined>]>, undefined>;
|
|
2194
|
-
readonly cliVersion: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 64, undefined>]>, undefined>;
|
|
2195
|
-
}, undefined>;
|
|
2196
|
-
}, undefined>;
|
|
2197
|
-
export type AgentCommentRequest = v.InferOutput<typeof AgentCommentRequestSchema>;
|
|
2198
|
-
/**
|
|
2199
|
-
* The comment a create settled on. `created` is false when this agent session
|
|
2200
|
-
* already had a whole-subject comment on the subject: that comment comes back
|
|
2201
|
-
* unchanged and nothing was written.
|
|
2070
|
+
* The bundle pull under its artifact name: the same members and comments as
|
|
2071
|
+
* {@link ContextItemsResponseSchema}, under `artifacts`.
|
|
2202
2072
|
*/
|
|
2203
|
-
export declare const
|
|
2204
|
-
readonly
|
|
2205
|
-
readonly comment: v.ObjectSchema<{
|
|
2073
|
+
export declare const BundleArtifactsResponseSchema: v.ObjectSchema<{
|
|
2074
|
+
readonly artifacts: v.ArraySchema<v.SchemaWithPipe<readonly [v.ObjectSchema<{
|
|
2206
2075
|
readonly id: v.StringSchema<undefined>;
|
|
2207
|
-
readonly threadId: v.StringSchema<undefined>;
|
|
2208
|
-
readonly subject: v.ObjectSchema<{
|
|
2209
|
-
readonly kind: v.PicklistSchema<["artifact", "item", "session"], undefined>;
|
|
2210
|
-
readonly id: v.StringSchema<undefined>;
|
|
2211
|
-
}, undefined>;
|
|
2212
|
-
readonly body: v.StringSchema<undefined>;
|
|
2213
|
-
readonly createdAt: v.StringSchema<undefined>;
|
|
2214
|
-
}, undefined>;
|
|
2215
|
-
}, undefined>;
|
|
2216
|
-
export type AgentCommentResponse = v.InferOutput<typeof AgentCommentResponseSchema>;
|
|
2217
|
-
/**
|
|
2218
|
-
* One comment on the on-demand read, with the item it is about named on the comment.
|
|
2219
|
-
*
|
|
2220
|
-
* The item is named here rather than the comments riding an item, because this
|
|
2221
|
-
* read answers "what has been left for me" rather than "what is in this
|
|
2222
|
-
* bundle": there is no item payload to hang them off, and an agent that has to
|
|
2223
|
-
* ask for every item to find out whether one carries a comment is the round trip
|
|
2224
|
-
* the announcement exists to avoid.
|
|
2225
|
-
*/
|
|
2226
|
-
export declare const ItemCommentWithSubjectSchema: v.ObjectSchema<{
|
|
2227
|
-
/** The item the comment is about, as the wire names it. */
|
|
2228
|
-
readonly itemName: v.StringSchema<undefined>;
|
|
2229
|
-
/** The item's declared repo-relative path, or null when it has none. */
|
|
2230
|
-
readonly itemPath: v.NullableSchema<v.StringSchema<undefined>, undefined>;
|
|
2231
|
-
readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
2232
|
-
readonly state: v.OptionalSchema<v.PicklistSchema<["open", "resolved"], undefined>, undefined>;
|
|
2233
|
-
/** Current source location of an anchored passage, or its lost quote. */
|
|
2234
|
-
readonly passage: v.OptionalSchema<v.ObjectSchema<{
|
|
2235
|
-
readonly quote: v.StringSchema<undefined>;
|
|
2236
|
-
readonly status: v.PicklistSchema<["located", "changed", "orphaned"], undefined>;
|
|
2237
|
-
readonly lines: v.NullableSchema<v.ObjectSchema<{
|
|
2238
|
-
readonly start: v.NumberSchema<undefined>;
|
|
2239
|
-
readonly end: v.NumberSchema<undefined>;
|
|
2240
|
-
}, undefined>, undefined>;
|
|
2241
|
-
}, undefined>, undefined>;
|
|
2242
|
-
/** The comment's text, already wrapped in the response's untrusted markers. */
|
|
2243
|
-
readonly body: v.StringSchema<undefined>;
|
|
2244
|
-
/**
|
|
2245
|
-
* A suggested edit: the replacement for the passage at `passage.lines`,
|
|
2246
|
-
* already wrapped in the response's untrusted markers like `body`. An
|
|
2247
|
-
* insertion is the passage plus its new lines and an empty replacement is a
|
|
2248
|
-
* deletion, so every edit is one replace. Absent on an ordinary comment.
|
|
2249
|
-
*/
|
|
2250
|
-
readonly suggestion: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
|
|
2251
|
-
/**
|
|
2252
|
-
* What a comment Mossbear wrote is: a finding about the item, never an edit.
|
|
2253
|
-
* Present only on a Mossbear comment. The comment's `body` begins with the
|
|
2254
|
-
* claim (what goes wrong); this carries what the claim rests on.
|
|
2255
|
-
*/
|
|
2256
|
-
readonly finding: v.OptionalSchema<v.ObjectSchema<{
|
|
2257
|
-
readonly tier: v.PicklistSchema<["observed", "usage", "practice"], undefined>;
|
|
2258
|
-
/** How the finding is known, in one line: "Seen in 3 sessions (2026-09-15 – 2026-10-03)". */
|
|
2259
|
-
readonly tierLine: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 300, undefined>]>;
|
|
2260
|
-
/** What the drafter did not read, fixed per tier. */
|
|
2261
|
-
readonly blindSpot: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 300, undefined>]>;
|
|
2262
|
-
/** What should change in later sessions if the finding is fixed, wrapped in the untrusted markers. */
|
|
2263
|
-
readonly prediction: v.NullableSchema<v.StringSchema<undefined>, undefined>;
|
|
2264
|
-
}, undefined>, undefined>;
|
|
2265
|
-
/**
|
|
2266
|
-
* Whether the person approved a comment Mossbear drafted. Present on every
|
|
2267
|
-
* Mossbear comment and absent on a person's or an agent's, which are
|
|
2268
|
-
* requests as written. `false` is a draft nobody has read yet: a reader shows
|
|
2269
|
-
* it to the user and acts only on their go-ahead. Only a client that reports
|
|
2270
|
-
* a version able to mark drafts is ever listed one, so an older reader that
|
|
2271
|
-
* strips this field never receives a draft it would print as a request.
|
|
2272
|
-
*/
|
|
2273
|
-
readonly approved: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
|
|
2274
|
-
/** The author's display name as the workspace shows it, or null. Never an email. */
|
|
2275
|
-
readonly authorName: v.NullableSchema<v.StringSchema<undefined>, undefined>;
|
|
2276
|
-
/** ISO timestamp, machine format. */
|
|
2277
|
-
readonly createdAt: v.StringSchema<undefined>;
|
|
2278
|
-
/** The item's content version the comment was written against. */
|
|
2279
|
-
readonly itemVersion: v.NumberSchema<undefined>;
|
|
2280
|
-
/** True when the item's current version is greater than `itemVersion`. */
|
|
2281
|
-
readonly itemChangedSince: v.BooleanSchema<undefined>;
|
|
2282
|
-
/**
|
|
2283
|
-
* How many agent reads were handed this comment **before** this one — so a
|
|
2284
|
-
* comment reaching an agent for the first time reports `0`.
|
|
2285
|
-
*
|
|
2286
|
-
* It is the stored count as it read at the moment the response was built;
|
|
2287
|
-
* the serve this response *is* has not been counted yet. Excluded rather
|
|
2288
|
-
* than included because the count is recorded best-effort: a response that
|
|
2289
|
-
* claimed to include itself would be wrong whenever that record failed, and
|
|
2290
|
-
* a number that is sometimes off by one is worse than one that is
|
|
2291
|
-
* consistently the prior total.
|
|
2292
|
-
*
|
|
2293
|
-
* So `deliveredCount > 0` means an earlier read was handed this comment, and
|
|
2294
|
-
* `0` means this read is the first. Neither says a model took it in — only
|
|
2295
|
-
* that the server handed it over.
|
|
2296
|
-
*/
|
|
2297
|
-
readonly deliveredCount: v.NumberSchema<undefined>;
|
|
2298
|
-
/**
|
|
2299
|
-
* This comment's thread root — its own id for every delivered root. Resolution
|
|
2300
|
-
* replies remain on the dashboard thread and are not delivered to agents.
|
|
2301
|
-
* It is on the wire from the first response
|
|
2302
|
-
* because the wire contract is consumed by installed CLI versions: reshaping
|
|
2303
|
-
* a flat `comments` array into threads-of-comments later would be a breaking
|
|
2304
|
-
* change, while a field today's readers ignore costs them nothing.
|
|
2305
|
-
*/
|
|
2306
|
-
readonly threadId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
2307
|
-
/**
|
|
2308
|
-
* Always `null` for a delivered root. Present so an older reader meeting a
|
|
2309
|
-
* future response that carries real replies degrades to
|
|
2310
|
-
* "a flat list of comments" rather than failing to parse.
|
|
2311
|
-
*/
|
|
2312
|
-
readonly replyToId: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>;
|
|
2313
|
-
}, undefined>;
|
|
2314
|
-
export type ItemCommentWithSubject = v.InferOutput<typeof ItemCommentWithSubjectSchema>;
|
|
2315
|
-
/**
|
|
2316
|
-
* Every open comment waiting for this reader across the bundles they named.
|
|
2317
|
-
*
|
|
2318
|
-
* **This read is a delivery and is counted as one**, exactly as comments riding
|
|
2319
|
-
* an item are: a body reached an agent. What it is *not* is an announcement —
|
|
2320
|
-
* nothing here touches the per-repo announcement count, so asking to read your
|
|
2321
|
-
* comments never spends the interruptions the hook is allowed.
|
|
2322
|
-
*
|
|
2323
|
-
* **Never capped.** The announcement cap governs whether a hook speaks; a
|
|
2324
|
-
* reader who asked is owed every open comment, and hiding one here would retire a
|
|
2325
|
-
* person's request without anybody deciding to.
|
|
2326
|
-
*/
|
|
2327
|
-
export declare const ItemCommentsResponseSchema: v.ObjectSchema<{
|
|
2328
|
-
readonly comments: v.ArraySchema<v.ObjectSchema<{
|
|
2329
|
-
/** The item the comment is about, as the wire names it. */
|
|
2330
|
-
readonly itemName: v.StringSchema<undefined>;
|
|
2331
|
-
/** The item's declared repo-relative path, or null when it has none. */
|
|
2332
|
-
readonly itemPath: v.NullableSchema<v.StringSchema<undefined>, undefined>;
|
|
2333
|
-
readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
2334
|
-
readonly state: v.OptionalSchema<v.PicklistSchema<["open", "resolved"], undefined>, undefined>;
|
|
2335
|
-
/** Current source location of an anchored passage, or its lost quote. */
|
|
2336
|
-
readonly passage: v.OptionalSchema<v.ObjectSchema<{
|
|
2337
|
-
readonly quote: v.StringSchema<undefined>;
|
|
2338
|
-
readonly status: v.PicklistSchema<["located", "changed", "orphaned"], undefined>;
|
|
2339
|
-
readonly lines: v.NullableSchema<v.ObjectSchema<{
|
|
2340
|
-
readonly start: v.NumberSchema<undefined>;
|
|
2341
|
-
readonly end: v.NumberSchema<undefined>;
|
|
2342
|
-
}, undefined>, undefined>;
|
|
2343
|
-
}, undefined>, undefined>;
|
|
2344
|
-
/** The comment's text, already wrapped in the response's untrusted markers. */
|
|
2345
|
-
readonly body: v.StringSchema<undefined>;
|
|
2346
2076
|
/**
|
|
2347
|
-
*
|
|
2348
|
-
*
|
|
2349
|
-
*
|
|
2350
|
-
*
|
|
2077
|
+
* The id every artifact route addresses: the body file's id for a guide
|
|
2078
|
+
* (null only for a guide with no body yet), the item's own id otherwise.
|
|
2079
|
+
* Optional so a client tolerates a server that predates it, and one that
|
|
2080
|
+
* stops sending it (the item id is the artifact id).
|
|
2351
2081
|
*/
|
|
2352
|
-
readonly
|
|
2082
|
+
readonly artifactId: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
|
|
2353
2083
|
/**
|
|
2354
|
-
*
|
|
2355
|
-
*
|
|
2356
|
-
*
|
|
2084
|
+
* Leaving the wire: a reader tells a guide from content by `role` and the
|
|
2085
|
+
* guide fields, not by this. Optional so a client parses a server that no
|
|
2086
|
+
* longer sends it.
|
|
2357
2087
|
*/
|
|
2358
|
-
readonly
|
|
2359
|
-
|
|
2360
|
-
/** How the finding is known, in one line: "Seen in 3 sessions (2026-09-15 – 2026-10-03)". */
|
|
2361
|
-
readonly tierLine: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 300, undefined>]>;
|
|
2362
|
-
/** What the drafter did not read, fixed per tier. */
|
|
2363
|
-
readonly blindSpot: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 300, undefined>]>;
|
|
2364
|
-
/** What should change in later sessions if the finding is fixed, wrapped in the untrusted markers. */
|
|
2365
|
-
readonly prediction: v.NullableSchema<v.StringSchema<undefined>, undefined>;
|
|
2366
|
-
}, undefined>, undefined>;
|
|
2088
|
+
readonly type: v.OptionalSchema<v.PicklistSchema<string[], undefined>, undefined>;
|
|
2089
|
+
readonly name: v.StringSchema<undefined>;
|
|
2367
2090
|
/**
|
|
2368
|
-
*
|
|
2369
|
-
*
|
|
2370
|
-
*
|
|
2371
|
-
*
|
|
2372
|
-
*
|
|
2373
|
-
*
|
|
2091
|
+
* The stored `(role, format)` pair, as two bare nullable strings.
|
|
2092
|
+
*
|
|
2093
|
+
* **Both are deliberately unenumerated.** A client switches on one value it
|
|
2094
|
+
* cares about — `role === 'criteria'` is how a rubric is told from ordinary
|
|
2095
|
+
* prose, which `type` cannot say because a rubric serializes as a `document` —
|
|
2096
|
+
* and a server that adds a fourth role or a fifth format must not break a
|
|
2097
|
+
* client that has never heard of it. Narrowing them here would make every such
|
|
2098
|
+
* addition a breaking wire change for no reader's benefit.
|
|
2099
|
+
*
|
|
2100
|
+
* Null on exactly the rows that carry no content: a tombstone, and an alias.
|
|
2101
|
+
* A `guide` item has no pair at all — it is a different table — and reports
|
|
2102
|
+
* both as null.
|
|
2374
2103
|
*/
|
|
2375
|
-
readonly
|
|
2376
|
-
|
|
2377
|
-
readonly
|
|
2378
|
-
|
|
2379
|
-
readonly
|
|
2380
|
-
/** The item's content version the comment was written against. */
|
|
2381
|
-
readonly itemVersion: v.NumberSchema<undefined>;
|
|
2382
|
-
/** True when the item's current version is greater than `itemVersion`. */
|
|
2383
|
-
readonly itemChangedSince: v.BooleanSchema<undefined>;
|
|
2104
|
+
readonly role: v.NullableSchema<v.StringSchema<undefined>, undefined>;
|
|
2105
|
+
readonly format: v.NullableSchema<v.StringSchema<undefined>, undefined>;
|
|
2106
|
+
readonly content: v.NullableSchema<v.StringSchema<undefined>, undefined>;
|
|
2107
|
+
readonly origin: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
|
|
2108
|
+
readonly version: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
|
|
2384
2109
|
/**
|
|
2385
|
-
*
|
|
2386
|
-
*
|
|
2110
|
+
* The guide a **derived** item belongs to — its evaluation criteria, or a
|
|
2111
|
+
* skill's member files (`subscription-delivery-target-plan.md` → slice 4).
|
|
2387
2112
|
*
|
|
2388
|
-
*
|
|
2389
|
-
* the
|
|
2390
|
-
* than included because the count is recorded best-effort: a response that
|
|
2391
|
-
* claimed to include itself would be wrong whenever that record failed, and
|
|
2392
|
-
* a number that is sometimes off by one is worse than one that is
|
|
2393
|
-
* consistently the prior total.
|
|
2113
|
+
* Absent on everything else, including a guide itself: a guide member is
|
|
2114
|
+
* addressed by the guide's own id, so `id` already answers this for it.
|
|
2394
2115
|
*
|
|
2395
|
-
*
|
|
2396
|
-
*
|
|
2397
|
-
*
|
|
2116
|
+
* It exists because derived items have no bundle membership and no id of their
|
|
2117
|
+
* guide's — they are `guide_files` rows attached by `guide_id` — so a rule
|
|
2118
|
+
* expressed over guide ids (a subscriber's mute) cannot reach them from the
|
|
2119
|
+
* item alone. Muting a skill and still delivering its `scripts/` would leave a
|
|
2120
|
+
* broken half-skill on disk, which is worse than not muting at all.
|
|
2398
2121
|
*/
|
|
2399
|
-
readonly
|
|
2122
|
+
readonly guideId: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
|
|
2123
|
+
readonly root: v.OptionalSchema<v.NullableSchema<v.PicklistSchema<["project", "global"], undefined>, undefined>, undefined>;
|
|
2124
|
+
readonly path: v.OptionalSchema<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>, undefined>;
|
|
2125
|
+
readonly projectId: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
|
|
2400
2126
|
/**
|
|
2401
|
-
*
|
|
2402
|
-
*
|
|
2403
|
-
*
|
|
2404
|
-
*
|
|
2405
|
-
*
|
|
2406
|
-
*
|
|
2127
|
+
* The repo a **document's** declared `path` is placed in — its home — as the
|
|
2128
|
+
* `project.id` of the checkout that last set the path. Documents only.
|
|
2129
|
+
*
|
|
2130
|
+
* Deliberately not `projectId` above: a reader takes a mismatch there as "this
|
|
2131
|
+
* item belongs to another repo, do not materialize it", so a home echoed on it
|
|
2132
|
+
* would stop every other subscriber receiving the document at all. A home says
|
|
2133
|
+
* only *where* the path is literal. Only the repo whose `project.id` matches
|
|
2134
|
+
* writes the document at `path`; every other repo mirrors it under the
|
|
2135
|
+
* bundle folder (`bundleMirrorPath` in `@mossbear/projections`).
|
|
2136
|
+
*
|
|
2137
|
+
* Absent and null read the same — **no home**, so no repo takes the path
|
|
2138
|
+
* literally for a new placement. A server predating the field says the same,
|
|
2139
|
+
* which is the safe direction: the file lands inside the bundle folder
|
|
2140
|
+
* instead of at a repo path it may not belong in.
|
|
2407
2141
|
*/
|
|
2408
|
-
readonly
|
|
2142
|
+
readonly pathProjectId: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
|
|
2143
|
+
readonly aliases: v.OptionalSchema<v.SchemaWithPipe<readonly [v.ArraySchema<v.ObjectSchema<{
|
|
2144
|
+
readonly root: v.PicklistSchema<["project", "global"], undefined>;
|
|
2145
|
+
readonly path: 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">]>;
|
|
2146
|
+
}, undefined>, undefined>, v.MaxLengthAction<{
|
|
2147
|
+
root: "project" | "global";
|
|
2148
|
+
path: string;
|
|
2149
|
+
}[], 8, undefined>]>, undefined>;
|
|
2409
2150
|
/**
|
|
2410
|
-
*
|
|
2411
|
-
*
|
|
2412
|
-
*
|
|
2413
|
-
|
|
2414
|
-
|
|
2415
|
-
|
|
2416
|
-
|
|
2417
|
-
|
|
2418
|
-
|
|
2419
|
-
* they mean. Present exactly when at least one comment came back.
|
|
2420
|
-
*/
|
|
2421
|
-
readonly untrusted: v.OptionalSchema<v.NullableSchema<v.ObjectSchema<{
|
|
2422
|
-
readonly token: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
2423
|
-
readonly startMarker: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
2424
|
-
readonly endMarker: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
2425
|
-
readonly note: v.StringSchema<undefined>;
|
|
2426
|
-
}, undefined>, undefined>, undefined>;
|
|
2427
|
-
}, undefined>;
|
|
2428
|
-
export type ItemCommentsResponse = v.InferOutput<typeof ItemCommentsResponseSchema>;
|
|
2429
|
-
/**
|
|
2430
|
-
* The evidence behind one Mossbear finding an agent was handed
|
|
2431
|
-
* (`GET /api/v1/context/comments/evidence`).
|
|
2432
|
-
*
|
|
2433
|
-
* `list_comments` carries the claim and a one-line tier; this is the finding
|
|
2434
|
-
* in full: the claim, the change it predicts in future sessions, what the
|
|
2435
|
-
* drafter did not read, and the evidence for its tier. Readable only through a
|
|
2436
|
-
* comment the comment read itself would deliver to this reader, so another
|
|
2437
|
-
* person's finding, one drafted from another repo, or a draft listed only to a
|
|
2438
|
-
* newer client has no evidence here either. A draft the reader was listed
|
|
2439
|
-
* does: an agent can say why it was raised before the person approves it.
|
|
2440
|
-
*
|
|
2441
|
-
* Citations (observed and usage findings) are reduced to what the reader may
|
|
2442
|
-
* see: their own sessions, with a date and a short excerpt of the grader's
|
|
2443
|
-
* reasoning or of their own redacted correction turn. A `navigation` citation
|
|
2444
|
-
* has an empty excerpt: it is dated evidence that a session loaded the skill,
|
|
2445
|
-
* and nothing more. `citationsWithheld` counts any that were dropped, so a
|
|
2446
|
-
* short list is never mistaken for the whole of it.
|
|
2447
|
-
*/
|
|
2448
|
-
export declare const CommentEvidenceCitationSchema: v.ObjectSchema<{
|
|
2449
|
-
/**
|
|
2450
|
-
* `navigation` is a skill load counted when a finding was drafted from how
|
|
2451
|
-
* the skill's files were read: evidence of how a skill was used, not of a
|
|
2452
|
-
* failure. `action` is a recorded step of a workflow repeated across
|
|
2453
|
-
* sessions. A server sends it only to a client that names a version new
|
|
2454
|
-
* enough to parse it.
|
|
2455
|
-
*/
|
|
2456
|
-
readonly kind: v.PicklistSchema<["verdict", "turn", "navigation", "action"], undefined>;
|
|
2457
|
-
readonly sessionId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
2458
|
-
/** ISO, when the verdict was graded, the turn was said, the skill loaded, or the action was recorded. */
|
|
2459
|
-
readonly at: v.StringSchema<undefined>;
|
|
2460
|
-
/** Wrapped in the response's untrusted markers. */
|
|
2461
|
-
readonly excerpt: v.StringSchema<undefined>;
|
|
2462
|
-
}, undefined>;
|
|
2463
|
-
export type CommentEvidenceCitation = v.InferOutput<typeof CommentEvidenceCitationSchema>;
|
|
2464
|
-
/** What a usage finding adds to its citations: the counts for one reference file. */
|
|
2465
|
-
export declare const CommentEvidenceUsageSchema: v.ObjectSchema<{
|
|
2466
|
-
/** The reference's skill-relative path, wrapped in the response's untrusted markers. */
|
|
2467
|
-
readonly path: v.StringSchema<undefined>;
|
|
2468
|
-
/** Eligible loads of the skill. */
|
|
2469
|
-
readonly loads: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>]>;
|
|
2470
|
-
/** Distinct sessions those loads span. */
|
|
2471
|
-
readonly sessions: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>]>;
|
|
2472
|
-
/** Loads followed by a successful read of the reference. */
|
|
2473
|
-
readonly loadsWithRead: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>]>;
|
|
2474
|
-
}, undefined>;
|
|
2475
|
-
/**
|
|
2476
|
-
* What a practice finding adds: the rubric check it answers and the rubric's
|
|
2477
|
-
* version, the practice lines it weighs with their sources, the facts measured
|
|
2478
|
-
* from the file, and the answer to each item of evidence the check asks for.
|
|
2479
|
-
* `answers[].answer` is model-written, so it travels wrapped in the response's
|
|
2480
|
-
* untrusted markers.
|
|
2481
|
-
*/
|
|
2482
|
-
export declare const CommentEvidencePracticeSchema: v.ObjectSchema<{
|
|
2483
|
-
readonly check: v.ObjectSchema<{
|
|
2484
|
-
readonly id: v.StringSchema<undefined>;
|
|
2485
|
-
readonly name: v.StringSchema<undefined>;
|
|
2486
|
-
}, undefined>;
|
|
2487
|
-
readonly rubricVersion: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>]>;
|
|
2488
|
-
readonly practices: v.OptionalSchema<v.ArraySchema<v.ObjectSchema<{
|
|
2489
|
-
readonly text: v.StringSchema<undefined>;
|
|
2490
|
-
readonly source: v.ObjectSchema<{
|
|
2491
|
-
readonly title: v.StringSchema<undefined>;
|
|
2492
|
-
readonly url: v.StringSchema<undefined>;
|
|
2493
|
-
}, undefined>;
|
|
2494
|
-
}, undefined>, undefined>, readonly []>;
|
|
2495
|
-
readonly facts: v.OptionalSchema<v.ArraySchema<v.StringSchema<undefined>, undefined>, readonly []>;
|
|
2496
|
-
readonly answers: v.OptionalSchema<v.ArraySchema<v.ObjectSchema<{
|
|
2497
|
-
readonly item: v.StringSchema<undefined>;
|
|
2498
|
-
readonly answer: v.StringSchema<undefined>;
|
|
2499
|
-
}, undefined>, undefined>, readonly []>;
|
|
2500
|
-
}, undefined>;
|
|
2501
|
-
/**
|
|
2502
|
-
* A comment the person (or Mossbear) left on one of the sessions a finding
|
|
2503
|
-
* cites — the person's own account of what the agent should have known, set
|
|
2504
|
-
* beside the grader's excerpt (`guide-findings-plan.md` → Your note on a
|
|
2505
|
-
* session).
|
|
2506
|
-
*
|
|
2507
|
-
* **Reachable only here.** A comment about a session is never listed by
|
|
2508
|
-
* `list_comments` or announced at session start: it is context for a finding,
|
|
2509
|
-
* found by following the finding's citation, not a request.
|
|
2510
|
-
*/
|
|
2511
|
-
export declare const CommentEvidenceSessionCommentSchema: v.ObjectSchema<{
|
|
2512
|
-
readonly sessionId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
2513
|
-
/** Only the person's own notes are sent today; `mossbear` is reserved. */
|
|
2514
|
-
readonly authorKind: v.PicklistSchema<["person", "mossbear"], undefined>;
|
|
2515
|
-
/** ISO, when the comment was written. */
|
|
2516
|
-
readonly at: v.StringSchema<undefined>;
|
|
2517
|
-
/** Wrapped in the response's untrusted markers. */
|
|
2518
|
-
readonly body: v.StringSchema<undefined>;
|
|
2519
|
-
}, undefined>;
|
|
2520
|
-
export type CommentEvidenceSessionComment = v.InferOutput<typeof CommentEvidenceSessionCommentSchema>;
|
|
2521
|
-
export declare const CommentEvidenceResponseSchema: v.ObjectSchema<{
|
|
2522
|
-
/** The comment's full id, even when the request named a prefix. */
|
|
2523
|
-
readonly commentId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
2524
|
-
readonly itemName: v.StringSchema<undefined>;
|
|
2525
|
-
readonly itemPath: v.NullableSchema<v.StringSchema<undefined>, undefined>;
|
|
2526
|
-
readonly tier: v.PicklistSchema<["observed", "usage", "practice"], undefined>;
|
|
2527
|
-
/** One line saying how the finding is known; server-written, outside the markers. */
|
|
2528
|
-
readonly tierLine: v.StringSchema<undefined>;
|
|
2529
|
-
/** What the drafter did not read; server-written, outside the markers. */
|
|
2530
|
-
readonly blindSpot: v.StringSchema<undefined>;
|
|
2531
|
-
/** What goes wrong, wrapped in the response's untrusted markers. */
|
|
2532
|
-
readonly claim: v.StringSchema<undefined>;
|
|
2533
|
-
/** What future sessions should show if the finding is fixed, wrapped; null if none. */
|
|
2534
|
-
readonly prediction: v.NullableSchema<v.StringSchema<undefined>, undefined>;
|
|
2535
|
-
/** A usage finding's counts; null on every other tier. */
|
|
2536
|
-
readonly usage: v.NullableSchema<v.ObjectSchema<{
|
|
2537
|
-
/** The reference's skill-relative path, wrapped in the response's untrusted markers. */
|
|
2538
|
-
readonly path: v.StringSchema<undefined>;
|
|
2539
|
-
/** Eligible loads of the skill. */
|
|
2540
|
-
readonly loads: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>]>;
|
|
2541
|
-
/** Distinct sessions those loads span. */
|
|
2542
|
-
readonly sessions: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>]>;
|
|
2543
|
-
/** Loads followed by a successful read of the reference. */
|
|
2544
|
-
readonly loadsWithRead: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>]>;
|
|
2545
|
-
}, undefined>, undefined>;
|
|
2546
|
-
/** A practice finding's rubric check; null on every other tier. */
|
|
2547
|
-
readonly practice: v.NullableSchema<v.ObjectSchema<{
|
|
2548
|
-
readonly check: v.ObjectSchema<{
|
|
2549
|
-
readonly id: v.StringSchema<undefined>;
|
|
2550
|
-
readonly name: v.StringSchema<undefined>;
|
|
2551
|
-
}, undefined>;
|
|
2552
|
-
readonly rubricVersion: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>]>;
|
|
2553
|
-
readonly practices: v.OptionalSchema<v.ArraySchema<v.ObjectSchema<{
|
|
2554
|
-
readonly text: v.StringSchema<undefined>;
|
|
2555
|
-
readonly source: v.ObjectSchema<{
|
|
2556
|
-
readonly title: v.StringSchema<undefined>;
|
|
2557
|
-
readonly url: v.StringSchema<undefined>;
|
|
2558
|
-
}, undefined>;
|
|
2559
|
-
}, undefined>, undefined>, readonly []>;
|
|
2560
|
-
readonly facts: v.OptionalSchema<v.ArraySchema<v.StringSchema<undefined>, undefined>, readonly []>;
|
|
2561
|
-
readonly answers: v.OptionalSchema<v.ArraySchema<v.ObjectSchema<{
|
|
2562
|
-
readonly item: v.StringSchema<undefined>;
|
|
2563
|
-
readonly answer: v.StringSchema<undefined>;
|
|
2564
|
-
}, undefined>, undefined>, readonly []>;
|
|
2565
|
-
}, undefined>, undefined>;
|
|
2566
|
-
readonly citations: v.ArraySchema<v.ObjectSchema<{
|
|
2567
|
-
/**
|
|
2568
|
-
* `navigation` is a skill load counted when a finding was drafted from how
|
|
2569
|
-
* the skill's files were read: evidence of how a skill was used, not of a
|
|
2570
|
-
* failure. `action` is a recorded step of a workflow repeated across
|
|
2571
|
-
* sessions. A server sends it only to a client that names a version new
|
|
2572
|
-
* enough to parse it.
|
|
2573
|
-
*/
|
|
2574
|
-
readonly kind: v.PicklistSchema<["verdict", "turn", "navigation", "action"], undefined>;
|
|
2575
|
-
readonly sessionId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
2576
|
-
/** ISO, when the verdict was graded, the turn was said, the skill loaded, or the action was recorded. */
|
|
2577
|
-
readonly at: v.StringSchema<undefined>;
|
|
2578
|
-
/** Wrapped in the response's untrusted markers. */
|
|
2579
|
-
readonly excerpt: v.StringSchema<undefined>;
|
|
2580
|
-
}, undefined>, undefined>;
|
|
2581
|
-
readonly citationsWithheld: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>]>;
|
|
2582
|
-
/**
|
|
2583
|
-
* Comments on the cited sessions, newest first, wrapped in the untrusted
|
|
2584
|
-
* markers. Defaulted so a response from a server that predates the field
|
|
2585
|
-
* still parses.
|
|
2586
|
-
*/
|
|
2587
|
-
readonly sessionComments: v.OptionalSchema<v.ArraySchema<v.ObjectSchema<{
|
|
2588
|
-
readonly sessionId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
2589
|
-
/** Only the person's own notes are sent today; `mossbear` is reserved. */
|
|
2590
|
-
readonly authorKind: v.PicklistSchema<["person", "mossbear"], undefined>;
|
|
2591
|
-
/** ISO, when the comment was written. */
|
|
2592
|
-
readonly at: v.StringSchema<undefined>;
|
|
2593
|
-
/** Wrapped in the response's untrusted markers. */
|
|
2594
|
-
readonly body: v.StringSchema<undefined>;
|
|
2595
|
-
}, undefined>, undefined>, readonly []>;
|
|
2596
|
-
/**
|
|
2597
|
-
* Comments on the cited sessions that were left out to keep the response
|
|
2598
|
-
* bounded (the newest few per session are sent), so a short list is never
|
|
2599
|
-
* mistaken for the whole of it. Zero when none were.
|
|
2600
|
-
*/
|
|
2601
|
-
readonly sessionCommentsWithheld: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>]>, 0>;
|
|
2602
|
-
readonly untrusted: v.ObjectSchema<{
|
|
2603
|
-
readonly token: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
2604
|
-
readonly startMarker: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
2605
|
-
readonly endMarker: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
2606
|
-
readonly note: v.StringSchema<undefined>;
|
|
2607
|
-
}, undefined>;
|
|
2608
|
-
}, undefined>;
|
|
2609
|
-
export type CommentEvidenceResponse = v.InferOutput<typeof CommentEvidenceResponseSchema>;
|
|
2610
|
-
/** Max number of context item ids a push may cite as its transform sources. */
|
|
2611
|
-
export declare const MAX_TRANSFORM_SOURCE_IDS = 100;
|
|
2612
|
-
/**
|
|
2613
|
-
* The ids of the caller-owned context items a pushed document was produced
|
|
2614
|
-
* from (inbox captures, bundle items — any item the caller owns). Shared
|
|
2615
|
-
* between the REST contract and the MCP tool's client-side arg validation so
|
|
2616
|
-
* the two can't drift.
|
|
2617
|
-
*/
|
|
2618
|
-
export declare const SourceItemIdsSchema: v.SchemaWithPipe<readonly [v.ArraySchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>, v.MinLengthAction<string[], 1, undefined>, v.MaxLengthAction<string[], 100, undefined>]>;
|
|
2619
|
-
export declare const UpdatableSourceItemIdsSchema: v.SchemaWithPipe<readonly [v.ArraySchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>, v.MaxLengthAction<string[], 100, undefined>]>;
|
|
2620
|
-
export declare const PushContextRequestSchema: v.ObjectSchema<{
|
|
2621
|
-
readonly name: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 200, undefined>]>;
|
|
2622
|
-
readonly contentType: v.PicklistSchema<("content" | "asset")[], undefined>;
|
|
2623
|
-
readonly content: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.CheckAction<string, "content must be at most 262144 bytes">]>;
|
|
2624
|
-
readonly itemId: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
|
|
2625
|
-
readonly origin: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
|
|
2626
|
-
readonly sourceItemIds: v.OptionalSchema<v.SchemaWithPipe<readonly [v.ArraySchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>, v.MinLengthAction<string[], 1, undefined>, v.MaxLengthAction<string[], 100, undefined>]>, undefined>;
|
|
2627
|
-
readonly path: v.OptionalSchema<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>, undefined>;
|
|
2628
|
-
/**
|
|
2629
|
-
* The committed `project.id` of the checkout this write comes from, when it
|
|
2630
|
-
* has one (`subscription-delivery-target-plan.md` → slice 3).
|
|
2631
|
-
*
|
|
2632
|
-
* It answers two questions, both about the writer's checkout:
|
|
2633
|
-
*
|
|
2634
|
-
* - **Is this write coming from the repo that owns these items?** Only a
|
|
2635
|
-
* bundle that claims a home asks. A request that declares nothing — every
|
|
2636
|
-
* dashboard edit — is not the home repo and is refused by name. Declaring an
|
|
2637
|
-
* id grants nothing on its own: an unclaimed bundle ignores it for this
|
|
2638
|
-
* purpose, and the caller must already be a member of the bundle's workspace
|
|
2639
|
-
* to reach this route at all.
|
|
2640
|
-
* - **Which repo is `path` placed in?** Stored beside `path` as the item's
|
|
2641
|
-
* home, so the one repo that declared the path can hold the document there
|
|
2642
|
-
* literally while every other subscriber mirrors it. Ignored without a
|
|
2643
|
-
* `path`: a home places nothing when there is no path to place.
|
|
2644
|
-
*
|
|
2645
|
-
* **The stored home is not echoed back as `ContextItemSchema.projectId`.**
|
|
2646
|
-
* That field tells a reader an item belongs to one repo and is not to be
|
|
2647
|
-
* materialized anywhere else; a document's home only says where it lands.
|
|
2648
|
-
*
|
|
2649
|
-
* Parsed as {@link DeclaredProjectIdSchema} — the CLI config reader's own
|
|
2650
|
-
* rule, trimmed and non-empty, and no stricter — so the stored home
|
|
2651
|
-
* round-trips against the value a checkout reads.
|
|
2652
|
-
*/
|
|
2653
|
-
readonly projectId: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>]>, undefined>;
|
|
2654
|
-
/**
|
|
2655
|
-
* Where the committed bytes in `content` came from, when this write is a
|
|
2656
|
-
* publication (`artifact-ownership-and-delivery-plan.md` → slice 3). Present
|
|
2657
|
-
* means git owns the resulting artifact: the commit is the authority and
|
|
2658
|
-
* Mossbear distributes the revision rather than keeping a second editable
|
|
2659
|
-
* copy.
|
|
2660
|
-
*
|
|
2661
|
-
* **Sending it is a claim about provenance, not an authorization.** The
|
|
2662
|
-
* server still answers who may write here from bundle membership and the
|
|
2663
|
-
* bundle's declared home, exactly as it does for `projectId` above; what this
|
|
2664
|
-
* adds is the revision the bytes were read from, so a subscriber can answer
|
|
2665
|
-
* "what did I get".
|
|
2666
|
-
*
|
|
2667
|
-
* **`path` is required alongside it and the route enforces that**, because
|
|
2668
|
-
* the database will: `guide_files_git_source_subset` admits only "repo id +
|
|
2669
|
-
* path + sha all present" or the whole group absent, so a publication that
|
|
2670
|
-
* named no path would fail at insert time with a constraint error instead of
|
|
2671
|
-
* a sentence. Refused in the route rather than restated as a wire rule, for
|
|
2672
|
-
* the reason `ContextItemSchema.gitSource` gives — a path this schema cannot
|
|
2673
|
-
* parse is one item's problem, not the response's.
|
|
2674
|
-
*/
|
|
2675
|
-
readonly gitSource: v.OptionalSchema<v.ObjectSchema<{
|
|
2676
|
-
/**
|
|
2677
|
-
* The committed `project.id` of the source repository — the same id space as
|
|
2678
|
-
* an item's delivery-scoping `projectId` below, but a different fact: that one
|
|
2679
|
-
* says which repo an item is materialized into and is stamped onto
|
|
2680
|
-
* Mossbear-owned rows too, this one says who may edit it.
|
|
2681
|
-
*/
|
|
2682
|
-
readonly projectId: 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">]>;
|
|
2683
|
-
readonly commitSha: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "commitSha must be 40 or 64 lowercase hex characters">]>;
|
|
2684
|
-
/**
|
|
2685
|
-
* The branch the publishing commit was on. **The one optional member**:
|
|
2686
|
-
* publication is not restricted by branch, so this is recorded so a subscriber
|
|
2687
|
-
* can see what they got, and a detached HEAD has none to record.
|
|
2688
|
-
*/
|
|
2689
|
-
readonly branch: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 255, undefined>]>, undefined>;
|
|
2690
|
-
}, undefined>, undefined>;
|
|
2691
|
-
}, undefined>;
|
|
2692
|
-
export declare const PushContextResponseSchema: v.ObjectSchema<{
|
|
2693
|
-
readonly item: v.SchemaWithPipe<readonly [v.ObjectSchema<{
|
|
2694
|
-
readonly id: v.StringSchema<undefined>;
|
|
2695
|
-
/**
|
|
2696
|
-
* The id every artifact route addresses: the body file's id for a guide
|
|
2697
|
-
* (null only for a guide with no body yet), the item's own id otherwise.
|
|
2698
|
-
* Optional so a client tolerates a server that predates it, and one that
|
|
2699
|
-
* stops sending it (the item id is the artifact id).
|
|
2700
|
-
*/
|
|
2701
|
-
readonly artifactId: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
|
|
2702
|
-
/**
|
|
2703
|
-
* Leaving the wire: a reader tells a guide from content by `role` and the
|
|
2704
|
-
* guide fields, not by this. Optional so a client parses a server that no
|
|
2705
|
-
* longer sends it.
|
|
2706
|
-
*/
|
|
2707
|
-
readonly type: v.OptionalSchema<v.PicklistSchema<string[], undefined>, undefined>;
|
|
2708
|
-
readonly name: v.StringSchema<undefined>;
|
|
2709
|
-
/**
|
|
2710
|
-
* The stored `(role, format)` pair, as two bare nullable strings.
|
|
2711
|
-
*
|
|
2712
|
-
* **Both are deliberately unenumerated.** A client switches on one value it
|
|
2713
|
-
* cares about — `role === 'criteria'` is how a rubric is told from ordinary
|
|
2714
|
-
* prose, which `type` cannot say because a rubric serializes as a `document` —
|
|
2715
|
-
* and a server that adds a fourth role or a fifth format must not break a
|
|
2716
|
-
* client that has never heard of it. Narrowing them here would make every such
|
|
2717
|
-
* addition a breaking wire change for no reader's benefit.
|
|
2718
|
-
*
|
|
2719
|
-
* Null on exactly the rows that carry no content: a tombstone, and an alias.
|
|
2720
|
-
* A `guide` item has no pair at all — it is a different table — and reports
|
|
2721
|
-
* both as null.
|
|
2722
|
-
*/
|
|
2723
|
-
readonly role: v.NullableSchema<v.StringSchema<undefined>, undefined>;
|
|
2724
|
-
readonly format: v.NullableSchema<v.StringSchema<undefined>, undefined>;
|
|
2725
|
-
readonly content: v.NullableSchema<v.StringSchema<undefined>, undefined>;
|
|
2726
|
-
readonly origin: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
|
|
2727
|
-
readonly version: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
|
|
2728
|
-
/**
|
|
2729
|
-
* The guide a **derived** item belongs to — its evaluation criteria, or a
|
|
2730
|
-
* skill's member files (`subscription-delivery-target-plan.md` → slice 4).
|
|
2731
|
-
*
|
|
2732
|
-
* Absent on everything else, including a guide itself: a guide member is
|
|
2733
|
-
* addressed by the guide's own id, so `id` already answers this for it.
|
|
2734
|
-
*
|
|
2735
|
-
* It exists because derived items have no bundle membership and no id of their
|
|
2736
|
-
* guide's — they are `guide_files` rows attached by `guide_id` — so a rule
|
|
2737
|
-
* expressed over guide ids (a subscriber's mute) cannot reach them from the
|
|
2738
|
-
* item alone. Muting a skill and still delivering its `scripts/` would leave a
|
|
2739
|
-
* broken half-skill on disk, which is worse than not muting at all.
|
|
2740
|
-
*/
|
|
2741
|
-
readonly guideId: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
|
|
2742
|
-
readonly root: v.OptionalSchema<v.NullableSchema<v.PicklistSchema<["project", "global"], undefined>, undefined>, undefined>;
|
|
2743
|
-
readonly path: v.OptionalSchema<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>, undefined>;
|
|
2744
|
-
readonly projectId: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
|
|
2745
|
-
/**
|
|
2746
|
-
* The repo a **document's** declared `path` is placed in — its home — as the
|
|
2747
|
-
* `project.id` of the checkout that last set the path. Documents only.
|
|
2748
|
-
*
|
|
2749
|
-
* Deliberately not `projectId` above: a reader takes a mismatch there as "this
|
|
2750
|
-
* item belongs to another repo, do not materialize it", so a home echoed on it
|
|
2751
|
-
* would stop every other subscriber receiving the document at all. A home says
|
|
2752
|
-
* only *where* the path is literal. Only the repo whose `project.id` matches
|
|
2753
|
-
* writes the document at `path`; every other repo mirrors it under the
|
|
2754
|
-
* bundle folder (`bundleMirrorPath` in `@mossbear/projections`).
|
|
2755
|
-
*
|
|
2756
|
-
* Absent and null read the same — **no home**, so no repo takes the path
|
|
2757
|
-
* literally for a new placement. A server predating the field says the same,
|
|
2758
|
-
* which is the safe direction: the file lands inside the bundle folder
|
|
2759
|
-
* instead of at a repo path it may not belong in.
|
|
2760
|
-
*/
|
|
2761
|
-
readonly pathProjectId: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
|
|
2762
|
-
readonly aliases: v.OptionalSchema<v.SchemaWithPipe<readonly [v.ArraySchema<v.ObjectSchema<{
|
|
2763
|
-
readonly root: v.PicklistSchema<["project", "global"], undefined>;
|
|
2764
|
-
readonly path: 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">]>;
|
|
2765
|
-
}, undefined>, undefined>, v.MaxLengthAction<{
|
|
2766
|
-
root: "project" | "global";
|
|
2767
|
-
path: string;
|
|
2768
|
-
}[], 8, undefined>]>, undefined>;
|
|
2769
|
-
/**
|
|
2770
|
-
* Open comments a person left about this item, newest first.
|
|
2771
|
-
*
|
|
2772
|
-
* Optional, and absent rather than empty when there are none — the same rule
|
|
2773
|
-
* `aliases` and `projectId` follow above, and for the same reason: an older
|
|
2774
|
-
* reader against a newer server ignores the key, and a newer reader against
|
|
2775
|
-
* an older server reads "no comments" instead of failing.
|
|
2776
|
-
*
|
|
2777
|
-
* **Absence is not a verdict.** No comments here means none were served on this
|
|
2778
|
-
* item in this response — not that nobody has anything to say about it.
|
|
2151
|
+
* Open comments a person left about this item, newest first.
|
|
2152
|
+
*
|
|
2153
|
+
* Optional, and absent rather than empty when there are none — the same rule
|
|
2154
|
+
* `aliases` and `projectId` follow above, and for the same reason: an older
|
|
2155
|
+
* reader against a newer server ignores the key, and a newer reader against
|
|
2156
|
+
* an older server reads "no comments" instead of failing.
|
|
2157
|
+
*
|
|
2158
|
+
* **Absence is not a verdict.** No comments here means none were served on this
|
|
2159
|
+
* item in this response — not that nobody has anything to say about it.
|
|
2779
2160
|
*/
|
|
2780
2161
|
readonly comments: v.OptionalSchema<v.SchemaWithPipe<readonly [v.ArraySchema<v.ObjectSchema<{
|
|
2781
2162
|
readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
@@ -3064,1477 +2445,564 @@ export declare const PushContextResponseSchema: v.ObjectSchema<{
|
|
|
3064
2445
|
branch?: string | undefined;
|
|
3065
2446
|
} | null | undefined;
|
|
3066
2447
|
removed?: true | undefined;
|
|
3067
|
-
}>]>;
|
|
3068
|
-
readonly
|
|
2448
|
+
}>]>, undefined>;
|
|
2449
|
+
readonly untrusted: v.OptionalSchema<v.NullableSchema<v.ObjectSchema<{
|
|
2450
|
+
readonly token: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
2451
|
+
readonly startMarker: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
2452
|
+
readonly endMarker: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
2453
|
+
readonly note: v.StringSchema<undefined>;
|
|
2454
|
+
}, undefined>, undefined>, undefined>;
|
|
3069
2455
|
}, undefined>;
|
|
3070
|
-
|
|
3071
|
-
|
|
3072
|
-
|
|
3073
|
-
|
|
3074
|
-
|
|
3075
|
-
|
|
3076
|
-
|
|
3077
|
-
|
|
3078
|
-
|
|
3079
|
-
|
|
3080
|
-
|
|
3081
|
-
|
|
3082
|
-
|
|
3083
|
-
|
|
3084
|
-
|
|
3085
|
-
|
|
3086
|
-
|
|
3087
|
-
|
|
3088
|
-
|
|
3089
|
-
|
|
3090
|
-
|
|
3091
|
-
|
|
3092
|
-
|
|
3093
|
-
|
|
3094
|
-
|
|
3095
|
-
|
|
3096
|
-
|
|
3097
|
-
|
|
3098
|
-
|
|
3099
|
-
|
|
3100
|
-
|
|
3101
|
-
|
|
3102
|
-
|
|
3103
|
-
|
|
3104
|
-
|
|
3105
|
-
|
|
3106
|
-
|
|
3107
|
-
|
|
3108
|
-
|
|
3109
|
-
|
|
3110
|
-
*
|
|
3111
|
-
*
|
|
3112
|
-
*
|
|
3113
|
-
*
|
|
3114
|
-
|
|
3115
|
-
|
|
3116
|
-
*/
|
|
3117
|
-
readonly gitSource: v.OptionalSchema<v.ObjectSchema<{
|
|
3118
|
-
/**
|
|
3119
|
-
* The committed `project.id` of the source repository — the same id space as
|
|
3120
|
-
* an item's delivery-scoping `projectId` below, but a different fact: that one
|
|
3121
|
-
* says which repo an item is materialized into and is stamped onto
|
|
3122
|
-
* Mossbear-owned rows too, this one says who may edit it.
|
|
3123
|
-
*/
|
|
3124
|
-
readonly projectId: 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">]>;
|
|
3125
|
-
readonly commitSha: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "commitSha must be 40 or 64 lowercase hex characters">]>;
|
|
3126
|
-
/**
|
|
3127
|
-
* The branch the publishing commit was on. **The one optional member**:
|
|
3128
|
-
* publication is not restricted by branch, so this is recorded so a subscriber
|
|
3129
|
-
* can see what they got, and a detached HEAD has none to record.
|
|
3130
|
-
*/
|
|
3131
|
-
readonly branch: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 255, undefined>]>, undefined>;
|
|
3132
|
-
}, undefined>, undefined>;
|
|
2456
|
+
/**
|
|
2457
|
+
* How many bundles one comments read may name.
|
|
2458
|
+
*
|
|
2459
|
+
* A repo's delivery set is the union of its committed subscriptions and the
|
|
2460
|
+
* reader's account ones, so this bounds a request, not a product limit: a
|
|
2461
|
+
* reader subscribing to more bundles than this asks in two calls rather than
|
|
2462
|
+
* losing the tail silently.
|
|
2463
|
+
*/
|
|
2464
|
+
export declare const MAX_COMMENT_BUNDLE_IDS = 100;
|
|
2465
|
+
/**
|
|
2466
|
+
* How many times one subscriber is told, in one repo, that a given comment is
|
|
2467
|
+
* waiting before the hook falls silent about it.
|
|
2468
|
+
*
|
|
2469
|
+
* **A cap on the interruption, never on the comment.** After it is reached the
|
|
2470
|
+
* comment is still open, still on the item page, and still returned in full by
|
|
2471
|
+
* the on-demand read — it simply stops being announced in front of the first
|
|
2472
|
+
* turn of every session. So silence here means "nothing new to interrupt you
|
|
2473
|
+
* about", never "nobody left anything".
|
|
2474
|
+
*
|
|
2475
|
+
* Three rather than one, for the reason the announcement exists: the first
|
|
2476
|
+
* session in a repo is often doing unrelated work, so a one-shot announcement
|
|
2477
|
+
* would routinely spend itself on the session least likely to act. Three is a
|
|
2478
|
+
* judgement, named so replacing it is one edit — the same discipline the live
|
|
2479
|
+
* session window is held to.
|
|
2480
|
+
*/
|
|
2481
|
+
export declare const MAX_COMMENT_ANNOUNCEMENTS_PER_REPO = 3;
|
|
2482
|
+
/**
|
|
2483
|
+
* Ask which comments are waiting for this reader in this repo, and be counted as
|
|
2484
|
+
* told.
|
|
2485
|
+
*
|
|
2486
|
+
* **A write, because being told is a fact the server has to keep.** The count
|
|
2487
|
+
* cannot be `item_comments.delivered_count` — that is one global number across
|
|
2488
|
+
* every subscriber and every repo, so one reader's fill of a comment would
|
|
2489
|
+
* silence it for everyone — and it cannot live in the checkout, because the
|
|
2490
|
+
* disposable environments this exists for rebuild the clone every session and
|
|
2491
|
+
* a counter there resets with it, announcing every unresolved comment as new
|
|
2492
|
+
* forever.
|
|
2493
|
+
*/
|
|
2494
|
+
export declare const AnnounceItemCommentsRequestSchema: v.ObjectSchema<{
|
|
2495
|
+
/**
|
|
2496
|
+
* The repo, as its committed config declares it. Required: it is the scope
|
|
2497
|
+
* the count is kept under, and a request with nothing to key on could only
|
|
2498
|
+
* be answered by an uncapped announcement — which is the repeating broadcast
|
|
2499
|
+
* this route exists to end.
|
|
2500
|
+
*/
|
|
2501
|
+
readonly projectId: 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">]>;
|
|
3133
2502
|
/**
|
|
3134
|
-
*
|
|
3135
|
-
* file, so the revision stops being delivered while the row and its version
|
|
3136
|
-
* history stay where they are.
|
|
2503
|
+
* The bundles this repo receives — the union the caller already resolved.
|
|
3137
2504
|
*
|
|
3138
|
-
*
|
|
3139
|
-
*
|
|
3140
|
-
*
|
|
3141
|
-
*
|
|
3142
|
-
|
|
3143
|
-
|
|
2505
|
+
* Sent rather than derived, because only half of it is the server's to know:
|
|
2506
|
+
* a repo-scoped subscription lives in the committed config and travels by
|
|
2507
|
+
* `git clone`. Declaring a bundle grants nothing: every one of them is still
|
|
2508
|
+
* filtered by the caller's own workspace membership.
|
|
2509
|
+
*/
|
|
2510
|
+
readonly bundleIds: v.SchemaWithPipe<readonly [v.ArraySchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>, v.MaxLengthAction<string[], 100, undefined>]>;
|
|
2511
|
+
}, undefined>;
|
|
2512
|
+
export type AnnounceItemCommentsRequest = v.InferOutput<typeof AnnounceItemCommentsRequestSchema>;
|
|
2513
|
+
/**
|
|
2514
|
+
* What an announcement answers: how many comments are waiting, and how many of
|
|
2515
|
+
* them this call was counted as announcing.
|
|
2516
|
+
*
|
|
2517
|
+
* **Two numbers because they answer two questions and a reader needs both.**
|
|
2518
|
+
* `open` is the true state of this repo's comments and is what a caller shows a
|
|
2519
|
+
* person — a number that is sometimes a subset of the truth would be worse
|
|
2520
|
+
* than the silence it replaced. `announced` is how many of those were still
|
|
2521
|
+
* under the cap, and it is the one that decides whether to speak at all: zero
|
|
2522
|
+
* means this reader has already been told about every one of them as often as
|
|
2523
|
+
* the cap allows.
|
|
2524
|
+
*/
|
|
2525
|
+
export declare const AnnounceItemCommentsResponseSchema: v.ObjectSchema<{
|
|
2526
|
+
/** Open, unmuted comments about the items these bundles deliver to this reader. */
|
|
2527
|
+
readonly open: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
|
|
2528
|
+
/** How many of those were under the cap and have now been counted as announced. */
|
|
2529
|
+
readonly announced: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
|
|
2530
|
+
}, undefined>;
|
|
2531
|
+
export type AnnounceItemCommentsResponse = v.InferOutput<typeof AnnounceItemCommentsResponseSchema>;
|
|
2532
|
+
/**
|
|
2533
|
+
* How many comments one agent session may leave on one subject, not counting its
|
|
2534
|
+
* whole-subject comment. Anchored comments and replies share it.
|
|
2535
|
+
*/
|
|
2536
|
+
export declare const MAX_AGENT_COMMENTS_PER_SUBJECT = 50;
|
|
2537
|
+
/** The longest an agent comment's text may be, in characters. */
|
|
2538
|
+
export declare const MAX_AGENT_COMMENT_BODY_CHARS = 4000;
|
|
2539
|
+
/**
|
|
2540
|
+
* Why an agent comment was refused, as the `code` on the error body. A caller
|
|
2541
|
+
* branches on these; the message beside one is for a person.
|
|
2542
|
+
*/
|
|
2543
|
+
export declare const AGENT_COMMENT_ERROR_CODES: readonly ["agent_session_required", "agent_comment_limit_reached", "agent_comment_text_only", "agent_comment_target_missing", "agent_comment_passage_not_found", "agent_comment_passage_ambiguous", "item_comment_limit_reached"];
|
|
2544
|
+
export declare const AgentCommentErrorCodeSchema: v.PicklistSchema<readonly ["agent_session_required", "agent_comment_limit_reached", "agent_comment_text_only", "agent_comment_target_missing", "agent_comment_passage_not_found", "agent_comment_passage_ambiguous", "item_comment_limit_reached"], undefined>;
|
|
2545
|
+
export type AgentCommentErrorCode = v.InferOutput<typeof AgentCommentErrorCodeSchema>;
|
|
2546
|
+
/**
|
|
2547
|
+
* Leave a comment, or reply to one, as an agent (`POST /api/v1/context/comments`).
|
|
2548
|
+
*
|
|
2549
|
+
* **`target` names what the comment is about, one way.** `artifact` is the id
|
|
2550
|
+
* a bundle read gave for a guide or document, and `item` is its older name for
|
|
2551
|
+
* the same thing, accepted until every client sends `artifact`. `session` is an
|
|
2552
|
+
* agent session id of the caller's own (the key a search hit and the session digest hand out), and
|
|
2553
|
+
* `reply` is the id of a comment to answer. A reply joins that comment's thread
|
|
2554
|
+
* and the subject it is about.
|
|
2555
|
+
*
|
|
2556
|
+
* **Who the agent is comes from `agent`, and `sessionId` is the harness's own
|
|
2557
|
+
* id as the CLI read it.** A request without one is refused with
|
|
2558
|
+
* `agent_session_required`, and the CLI and tool offer no way to type one. The
|
|
2559
|
+
* server cannot check it against the harness, so it is a claim by the holder of
|
|
2560
|
+
* the token: the comment is always written under that token's account, and the
|
|
2561
|
+
* handle shown for it names a session only as far as the claim is true.
|
|
2562
|
+
*
|
|
2563
|
+
* **Text only.** There is no replacement-text field, and a request that carries
|
|
2564
|
+
* one is refused with `agent_comment_text_only` rather than having it dropped.
|
|
2565
|
+
*/
|
|
2566
|
+
export declare const AgentCommentRequestSchema: v.ObjectSchema<{
|
|
2567
|
+
readonly target: v.VariantSchema<"kind", [v.ObjectSchema<{
|
|
2568
|
+
readonly kind: v.LiteralSchema<"artifact", undefined>;
|
|
2569
|
+
readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 128, undefined>]>;
|
|
2570
|
+
}, undefined>, v.ObjectSchema<{
|
|
2571
|
+
readonly kind: v.LiteralSchema<"session", undefined>;
|
|
2572
|
+
readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 128, undefined>]>;
|
|
2573
|
+
}, undefined>, v.ObjectSchema<{
|
|
2574
|
+
readonly kind: v.LiteralSchema<"reply", undefined>;
|
|
2575
|
+
readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 128, undefined>]>;
|
|
2576
|
+
}, undefined>], undefined>;
|
|
2577
|
+
readonly body: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 4000, undefined>]>;
|
|
2578
|
+
/**
|
|
2579
|
+
* The passage an item comment is about, as the exact text of one or more whole
|
|
2580
|
+
* lines of the item (a paragraph, a heading, a list). None means the item as a
|
|
2581
|
+
* whole. The server finds the lines; a passage that is not in the item as it is
|
|
2582
|
+
* now is refused with `agent_comment_passage_not_found`.
|
|
2583
|
+
*/
|
|
2584
|
+
readonly passage: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 8000, undefined>]>, undefined>;
|
|
2585
|
+
readonly agent: v.ObjectSchema<{
|
|
2586
|
+
readonly sessionId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 128, undefined>]>;
|
|
2587
|
+
readonly harness: v.PicklistSchema<["claude_code", "codex", "antigravity", "opencode"], undefined>;
|
|
2588
|
+
/** The agent's own statement of its model, when it knows it. */
|
|
2589
|
+
readonly model: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 100, undefined>]>, undefined>;
|
|
2590
|
+
readonly cliVersion: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 64, undefined>]>, undefined>;
|
|
2591
|
+
}, undefined>;
|
|
2592
|
+
}, undefined>;
|
|
2593
|
+
export type AgentCommentRequest = v.InferOutput<typeof AgentCommentRequestSchema>;
|
|
2594
|
+
/**
|
|
2595
|
+
* The comment a create settled on. `created` is false when this agent session
|
|
2596
|
+
* already had a whole-subject comment on the subject: that comment comes back
|
|
2597
|
+
* unchanged and nothing was written.
|
|
2598
|
+
*/
|
|
2599
|
+
export declare const AgentCommentResponseSchema: v.ObjectSchema<{
|
|
2600
|
+
readonly created: v.BooleanSchema<undefined>;
|
|
2601
|
+
readonly comment: v.ObjectSchema<{
|
|
2602
|
+
readonly id: v.StringSchema<undefined>;
|
|
2603
|
+
readonly threadId: v.StringSchema<undefined>;
|
|
2604
|
+
readonly subject: v.ObjectSchema<{
|
|
2605
|
+
readonly kind: v.PicklistSchema<["artifact", "session"], undefined>;
|
|
2606
|
+
readonly id: v.StringSchema<undefined>;
|
|
2607
|
+
}, undefined>;
|
|
2608
|
+
readonly body: v.StringSchema<undefined>;
|
|
2609
|
+
readonly createdAt: v.StringSchema<undefined>;
|
|
2610
|
+
}, undefined>;
|
|
2611
|
+
}, undefined>;
|
|
2612
|
+
export type AgentCommentResponse = v.InferOutput<typeof AgentCommentResponseSchema>;
|
|
2613
|
+
/**
|
|
2614
|
+
* One comment on the on-demand read, with the item it is about named on the comment.
|
|
2615
|
+
*
|
|
2616
|
+
* The item is named here rather than the comments riding an item, because this
|
|
2617
|
+
* read answers "what has been left for me" rather than "what is in this
|
|
2618
|
+
* bundle": there is no item payload to hang them off, and an agent that has to
|
|
2619
|
+
* ask for every item to find out whether one carries a comment is the round trip
|
|
2620
|
+
* the announcement exists to avoid.
|
|
2621
|
+
*/
|
|
2622
|
+
export declare const ItemCommentWithSubjectSchema: v.ObjectSchema<{
|
|
2623
|
+
/** The item the comment is about, as the wire names it. */
|
|
2624
|
+
readonly itemName: v.StringSchema<undefined>;
|
|
2625
|
+
/** The item's declared repo-relative path, or null when it has none. */
|
|
2626
|
+
readonly itemPath: v.NullableSchema<v.StringSchema<undefined>, undefined>;
|
|
2627
|
+
readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
2628
|
+
readonly state: v.OptionalSchema<v.PicklistSchema<["open", "resolved"], undefined>, undefined>;
|
|
2629
|
+
/** Current source location of an anchored passage, or its lost quote. */
|
|
2630
|
+
readonly passage: v.OptionalSchema<v.ObjectSchema<{
|
|
2631
|
+
readonly quote: v.StringSchema<undefined>;
|
|
2632
|
+
readonly status: v.PicklistSchema<["located", "changed", "orphaned"], undefined>;
|
|
2633
|
+
readonly lines: v.NullableSchema<v.ObjectSchema<{
|
|
2634
|
+
readonly start: v.NumberSchema<undefined>;
|
|
2635
|
+
readonly end: v.NumberSchema<undefined>;
|
|
2636
|
+
}, undefined>, undefined>;
|
|
2637
|
+
}, undefined>, undefined>;
|
|
2638
|
+
/** The comment's text, already wrapped in the response's untrusted markers. */
|
|
2639
|
+
readonly body: v.StringSchema<undefined>;
|
|
2640
|
+
/**
|
|
2641
|
+
* A suggested edit: the replacement for the passage at `passage.lines`,
|
|
2642
|
+
* already wrapped in the response's untrusted markers like `body`. An
|
|
2643
|
+
* insertion is the passage plus its new lines and an empty replacement is a
|
|
2644
|
+
* deletion, so every edit is one replace. Absent on an ordinary comment.
|
|
2645
|
+
*/
|
|
2646
|
+
readonly suggestion: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
|
|
2647
|
+
/**
|
|
2648
|
+
* What a comment Mossbear wrote is: a finding about the item, never an edit.
|
|
2649
|
+
* Present only on a Mossbear comment. The comment's `body` begins with the
|
|
2650
|
+
* claim (what goes wrong); this carries what the claim rests on.
|
|
2651
|
+
*/
|
|
2652
|
+
readonly finding: v.OptionalSchema<v.ObjectSchema<{
|
|
2653
|
+
readonly tier: v.PicklistSchema<["observed", "usage", "practice"], undefined>;
|
|
2654
|
+
/** How the finding is known, in one line: "Seen in 3 sessions (2026-09-15 – 2026-10-03)". */
|
|
2655
|
+
readonly tierLine: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 300, undefined>]>;
|
|
2656
|
+
/** What the drafter did not read, fixed per tier. */
|
|
2657
|
+
readonly blindSpot: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 300, undefined>]>;
|
|
2658
|
+
/** What should change in later sessions if the finding is fixed, wrapped in the untrusted markers. */
|
|
2659
|
+
readonly prediction: v.NullableSchema<v.StringSchema<undefined>, undefined>;
|
|
2660
|
+
}, undefined>, undefined>;
|
|
2661
|
+
/**
|
|
2662
|
+
* Whether the person approved a comment Mossbear drafted. Present on every
|
|
2663
|
+
* Mossbear comment and absent on a person's or an agent's, which are
|
|
2664
|
+
* requests as written. `false` is a draft nobody has read yet: a reader shows
|
|
2665
|
+
* it to the user and acts only on their go-ahead. Only a client that reports
|
|
2666
|
+
* a version able to mark drafts is ever listed one, so an older reader that
|
|
2667
|
+
* strips this field never receives a draft it would print as a request.
|
|
2668
|
+
*/
|
|
2669
|
+
readonly approved: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
|
|
2670
|
+
/** The author's display name as the workspace shows it, or null. Never an email. */
|
|
2671
|
+
readonly authorName: v.NullableSchema<v.StringSchema<undefined>, undefined>;
|
|
2672
|
+
/** ISO timestamp, machine format. */
|
|
2673
|
+
readonly createdAt: v.StringSchema<undefined>;
|
|
2674
|
+
/** The item's content version the comment was written against. */
|
|
2675
|
+
readonly itemVersion: v.NumberSchema<undefined>;
|
|
2676
|
+
/** True when the item's current version is greater than `itemVersion`. */
|
|
2677
|
+
readonly itemChangedSince: v.BooleanSchema<undefined>;
|
|
2678
|
+
/**
|
|
2679
|
+
* How many agent reads were handed this comment **before** this one — so a
|
|
2680
|
+
* comment reaching an agent for the first time reports `0`.
|
|
3144
2681
|
*
|
|
3145
|
-
*
|
|
3146
|
-
*
|
|
3147
|
-
*
|
|
3148
|
-
*
|
|
3149
|
-
*
|
|
3150
|
-
*
|
|
2682
|
+
* It is the stored count as it read at the moment the response was built;
|
|
2683
|
+
* the serve this response *is* has not been counted yet. Excluded rather
|
|
2684
|
+
* than included because the count is recorded best-effort: a response that
|
|
2685
|
+
* claimed to include itself would be wrong whenever that record failed, and
|
|
2686
|
+
* a number that is sometimes off by one is worse than one that is
|
|
2687
|
+
* consistently the prior total.
|
|
3151
2688
|
*
|
|
3152
|
-
*
|
|
3153
|
-
*
|
|
2689
|
+
* So `deliveredCount > 0` means an earlier read was handed this comment, and
|
|
2690
|
+
* `0` means this read is the first. Neither says a model took it in — only
|
|
2691
|
+
* that the server handed it over.
|
|
3154
2692
|
*/
|
|
3155
|
-
readonly
|
|
2693
|
+
readonly deliveredCount: v.NumberSchema<undefined>;
|
|
2694
|
+
/**
|
|
2695
|
+
* This comment's thread root — its own id for every delivered root. Resolution
|
|
2696
|
+
* replies remain on the dashboard thread and are not delivered to agents.
|
|
2697
|
+
* It is on the wire from the first response
|
|
2698
|
+
* because the wire contract is consumed by installed CLI versions: reshaping
|
|
2699
|
+
* a flat `comments` array into threads-of-comments later would be a breaking
|
|
2700
|
+
* change, while a field today's readers ignore costs them nothing.
|
|
2701
|
+
*/
|
|
2702
|
+
readonly threadId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
2703
|
+
/**
|
|
2704
|
+
* Always `null` for a delivered root. Present so an older reader meeting a
|
|
2705
|
+
* future response that carries real replies degrades to
|
|
2706
|
+
* "a flat list of comments" rather than failing to parse.
|
|
2707
|
+
*/
|
|
2708
|
+
readonly replyToId: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>;
|
|
3156
2709
|
}, undefined>;
|
|
3157
|
-
export
|
|
3158
|
-
|
|
3159
|
-
|
|
2710
|
+
export type ItemCommentWithSubject = v.InferOutput<typeof ItemCommentWithSubjectSchema>;
|
|
2711
|
+
/**
|
|
2712
|
+
* Every open comment waiting for this reader across the bundles they named.
|
|
2713
|
+
*
|
|
2714
|
+
* **This read is a delivery and is counted as one**, exactly as comments riding
|
|
2715
|
+
* an item are: a body reached an agent. What it is *not* is an announcement —
|
|
2716
|
+
* nothing here touches the per-repo announcement count, so asking to read your
|
|
2717
|
+
* comments never spends the interruptions the hook is allowed.
|
|
2718
|
+
*
|
|
2719
|
+
* **Never capped.** The announcement cap governs whether a hook speaks; a
|
|
2720
|
+
* reader who asked is owed every open comment, and hiding one here would retire a
|
|
2721
|
+
* person's request without anybody deciding to.
|
|
2722
|
+
*/
|
|
2723
|
+
export declare const ItemCommentsResponseSchema: v.ObjectSchema<{
|
|
2724
|
+
readonly comments: v.ArraySchema<v.ObjectSchema<{
|
|
2725
|
+
/** The item the comment is about, as the wire names it. */
|
|
2726
|
+
readonly itemName: v.StringSchema<undefined>;
|
|
2727
|
+
/** The item's declared repo-relative path, or null when it has none. */
|
|
2728
|
+
readonly itemPath: v.NullableSchema<v.StringSchema<undefined>, undefined>;
|
|
2729
|
+
readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
2730
|
+
readonly state: v.OptionalSchema<v.PicklistSchema<["open", "resolved"], undefined>, undefined>;
|
|
2731
|
+
/** Current source location of an anchored passage, or its lost quote. */
|
|
2732
|
+
readonly passage: v.OptionalSchema<v.ObjectSchema<{
|
|
2733
|
+
readonly quote: v.StringSchema<undefined>;
|
|
2734
|
+
readonly status: v.PicklistSchema<["located", "changed", "orphaned"], undefined>;
|
|
2735
|
+
readonly lines: v.NullableSchema<v.ObjectSchema<{
|
|
2736
|
+
readonly start: v.NumberSchema<undefined>;
|
|
2737
|
+
readonly end: v.NumberSchema<undefined>;
|
|
2738
|
+
}, undefined>, undefined>;
|
|
2739
|
+
}, undefined>, undefined>;
|
|
2740
|
+
/** The comment's text, already wrapped in the response's untrusted markers. */
|
|
2741
|
+
readonly body: v.StringSchema<undefined>;
|
|
3160
2742
|
/**
|
|
3161
|
-
*
|
|
3162
|
-
*
|
|
3163
|
-
*
|
|
3164
|
-
*
|
|
2743
|
+
* A suggested edit: the replacement for the passage at `passage.lines`,
|
|
2744
|
+
* already wrapped in the response's untrusted markers like `body`. An
|
|
2745
|
+
* insertion is the passage plus its new lines and an empty replacement is a
|
|
2746
|
+
* deletion, so every edit is one replace. Absent on an ordinary comment.
|
|
3165
2747
|
*/
|
|
3166
|
-
readonly
|
|
2748
|
+
readonly suggestion: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
|
|
3167
2749
|
/**
|
|
3168
|
-
*
|
|
3169
|
-
*
|
|
3170
|
-
*
|
|
2750
|
+
* What a comment Mossbear wrote is: a finding about the item, never an edit.
|
|
2751
|
+
* Present only on a Mossbear comment. The comment's `body` begins with the
|
|
2752
|
+
* claim (what goes wrong); this carries what the claim rests on.
|
|
3171
2753
|
*/
|
|
3172
|
-
readonly
|
|
3173
|
-
|
|
2754
|
+
readonly finding: v.OptionalSchema<v.ObjectSchema<{
|
|
2755
|
+
readonly tier: v.PicklistSchema<["observed", "usage", "practice"], undefined>;
|
|
2756
|
+
/** How the finding is known, in one line: "Seen in 3 sessions (2026-09-15 – 2026-10-03)". */
|
|
2757
|
+
readonly tierLine: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 300, undefined>]>;
|
|
2758
|
+
/** What the drafter did not read, fixed per tier. */
|
|
2759
|
+
readonly blindSpot: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 300, undefined>]>;
|
|
2760
|
+
/** What should change in later sessions if the finding is fixed, wrapped in the untrusted markers. */
|
|
2761
|
+
readonly prediction: v.NullableSchema<v.StringSchema<undefined>, undefined>;
|
|
2762
|
+
}, undefined>, undefined>;
|
|
3174
2763
|
/**
|
|
3175
|
-
*
|
|
3176
|
-
*
|
|
3177
|
-
*
|
|
3178
|
-
*
|
|
3179
|
-
*
|
|
3180
|
-
*
|
|
3181
|
-
* client that has never heard of it. Narrowing them here would make every such
|
|
3182
|
-
* addition a breaking wire change for no reader's benefit.
|
|
3183
|
-
*
|
|
3184
|
-
* Null on exactly the rows that carry no content: a tombstone, and an alias.
|
|
3185
|
-
* A `guide` item has no pair at all — it is a different table — and reports
|
|
3186
|
-
* both as null.
|
|
2764
|
+
* Whether the person approved a comment Mossbear drafted. Present on every
|
|
2765
|
+
* Mossbear comment and absent on a person's or an agent's, which are
|
|
2766
|
+
* requests as written. `false` is a draft nobody has read yet: a reader shows
|
|
2767
|
+
* it to the user and acts only on their go-ahead. Only a client that reports
|
|
2768
|
+
* a version able to mark drafts is ever listed one, so an older reader that
|
|
2769
|
+
* strips this field never receives a draft it would print as a request.
|
|
3187
2770
|
*/
|
|
3188
|
-
readonly
|
|
3189
|
-
|
|
3190
|
-
readonly
|
|
3191
|
-
|
|
3192
|
-
readonly
|
|
2771
|
+
readonly approved: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
|
|
2772
|
+
/** The author's display name as the workspace shows it, or null. Never an email. */
|
|
2773
|
+
readonly authorName: v.NullableSchema<v.StringSchema<undefined>, undefined>;
|
|
2774
|
+
/** ISO timestamp, machine format. */
|
|
2775
|
+
readonly createdAt: v.StringSchema<undefined>;
|
|
2776
|
+
/** The item's content version the comment was written against. */
|
|
2777
|
+
readonly itemVersion: v.NumberSchema<undefined>;
|
|
2778
|
+
/** True when the item's current version is greater than `itemVersion`. */
|
|
2779
|
+
readonly itemChangedSince: v.BooleanSchema<undefined>;
|
|
3193
2780
|
/**
|
|
3194
|
-
*
|
|
3195
|
-
*
|
|
2781
|
+
* How many agent reads were handed this comment **before** this one — so a
|
|
2782
|
+
* comment reaching an agent for the first time reports `0`.
|
|
3196
2783
|
*
|
|
3197
|
-
*
|
|
3198
|
-
*
|
|
2784
|
+
* It is the stored count as it read at the moment the response was built;
|
|
2785
|
+
* the serve this response *is* has not been counted yet. Excluded rather
|
|
2786
|
+
* than included because the count is recorded best-effort: a response that
|
|
2787
|
+
* claimed to include itself would be wrong whenever that record failed, and
|
|
2788
|
+
* a number that is sometimes off by one is worse than one that is
|
|
2789
|
+
* consistently the prior total.
|
|
3199
2790
|
*
|
|
3200
|
-
*
|
|
3201
|
-
*
|
|
3202
|
-
*
|
|
3203
|
-
* item alone. Muting a skill and still delivering its `scripts/` would leave a
|
|
3204
|
-
* broken half-skill on disk, which is worse than not muting at all.
|
|
2791
|
+
* So `deliveredCount > 0` means an earlier read was handed this comment, and
|
|
2792
|
+
* `0` means this read is the first. Neither says a model took it in — only
|
|
2793
|
+
* that the server handed it over.
|
|
3205
2794
|
*/
|
|
3206
|
-
readonly
|
|
3207
|
-
readonly root: v.OptionalSchema<v.NullableSchema<v.PicklistSchema<["project", "global"], undefined>, undefined>, undefined>;
|
|
3208
|
-
readonly path: v.OptionalSchema<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>, undefined>;
|
|
3209
|
-
readonly projectId: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
|
|
2795
|
+
readonly deliveredCount: v.NumberSchema<undefined>;
|
|
3210
2796
|
/**
|
|
3211
|
-
*
|
|
3212
|
-
*
|
|
3213
|
-
*
|
|
3214
|
-
*
|
|
3215
|
-
*
|
|
3216
|
-
*
|
|
3217
|
-
* only *where* the path is literal. Only the repo whose `project.id` matches
|
|
3218
|
-
* writes the document at `path`; every other repo mirrors it under the
|
|
3219
|
-
* bundle folder (`bundleMirrorPath` in `@mossbear/projections`).
|
|
3220
|
-
*
|
|
3221
|
-
* Absent and null read the same — **no home**, so no repo takes the path
|
|
3222
|
-
* literally for a new placement. A server predating the field says the same,
|
|
3223
|
-
* which is the safe direction: the file lands inside the bundle folder
|
|
3224
|
-
* instead of at a repo path it may not belong in.
|
|
2797
|
+
* This comment's thread root — its own id for every delivered root. Resolution
|
|
2798
|
+
* replies remain on the dashboard thread and are not delivered to agents.
|
|
2799
|
+
* It is on the wire from the first response
|
|
2800
|
+
* because the wire contract is consumed by installed CLI versions: reshaping
|
|
2801
|
+
* a flat `comments` array into threads-of-comments later would be a breaking
|
|
2802
|
+
* change, while a field today's readers ignore costs them nothing.
|
|
3225
2803
|
*/
|
|
3226
|
-
readonly
|
|
3227
|
-
readonly aliases: v.OptionalSchema<v.SchemaWithPipe<readonly [v.ArraySchema<v.ObjectSchema<{
|
|
3228
|
-
readonly root: v.PicklistSchema<["project", "global"], undefined>;
|
|
3229
|
-
readonly path: 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">]>;
|
|
3230
|
-
}, undefined>, undefined>, v.MaxLengthAction<{
|
|
3231
|
-
root: "project" | "global";
|
|
3232
|
-
path: string;
|
|
3233
|
-
}[], 8, undefined>]>, undefined>;
|
|
2804
|
+
readonly threadId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
3234
2805
|
/**
|
|
3235
|
-
*
|
|
3236
|
-
*
|
|
3237
|
-
*
|
|
3238
|
-
* `aliases` and `projectId` follow above, and for the same reason: an older
|
|
3239
|
-
* reader against a newer server ignores the key, and a newer reader against
|
|
3240
|
-
* an older server reads "no comments" instead of failing.
|
|
3241
|
-
*
|
|
3242
|
-
* **Absence is not a verdict.** No comments here means none were served on this
|
|
3243
|
-
* item in this response — not that nobody has anything to say about it.
|
|
2806
|
+
* Always `null` for a delivered root. Present so an older reader meeting a
|
|
2807
|
+
* future response that carries real replies degrades to
|
|
2808
|
+
* "a flat list of comments" rather than failing to parse.
|
|
3244
2809
|
*/
|
|
3245
|
-
readonly
|
|
3246
|
-
|
|
3247
|
-
|
|
3248
|
-
/** Current source location of an anchored passage, or its lost quote. */
|
|
3249
|
-
readonly passage: v.OptionalSchema<v.ObjectSchema<{
|
|
3250
|
-
readonly quote: v.StringSchema<undefined>;
|
|
3251
|
-
readonly status: v.PicklistSchema<["located", "changed", "orphaned"], undefined>;
|
|
3252
|
-
readonly lines: v.NullableSchema<v.ObjectSchema<{
|
|
3253
|
-
readonly start: v.NumberSchema<undefined>;
|
|
3254
|
-
readonly end: v.NumberSchema<undefined>;
|
|
3255
|
-
}, undefined>, undefined>;
|
|
3256
|
-
}, undefined>, undefined>;
|
|
3257
|
-
/** The comment's text, already wrapped in the response's untrusted markers. */
|
|
3258
|
-
readonly body: v.StringSchema<undefined>;
|
|
3259
|
-
/**
|
|
3260
|
-
* A suggested edit: the replacement for the passage at `passage.lines`,
|
|
3261
|
-
* already wrapped in the response's untrusted markers like `body`. An
|
|
3262
|
-
* insertion is the passage plus its new lines and an empty replacement is a
|
|
3263
|
-
* deletion, so every edit is one replace. Absent on an ordinary comment.
|
|
3264
|
-
*/
|
|
3265
|
-
readonly suggestion: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
|
|
3266
|
-
/**
|
|
3267
|
-
* What a comment Mossbear wrote is: a finding about the item, never an edit.
|
|
3268
|
-
* Present only on a Mossbear comment. The comment's `body` begins with the
|
|
3269
|
-
* claim (what goes wrong); this carries what the claim rests on.
|
|
3270
|
-
*/
|
|
3271
|
-
readonly finding: v.OptionalSchema<v.ObjectSchema<{
|
|
3272
|
-
readonly tier: v.PicklistSchema<["observed", "usage", "practice"], undefined>;
|
|
3273
|
-
/** How the finding is known, in one line: "Seen in 3 sessions (2026-09-15 – 2026-10-03)". */
|
|
3274
|
-
readonly tierLine: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 300, undefined>]>;
|
|
3275
|
-
/** What the drafter did not read, fixed per tier. */
|
|
3276
|
-
readonly blindSpot: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 300, undefined>]>;
|
|
3277
|
-
/** What should change in later sessions if the finding is fixed, wrapped in the untrusted markers. */
|
|
3278
|
-
readonly prediction: v.NullableSchema<v.StringSchema<undefined>, undefined>;
|
|
3279
|
-
}, undefined>, undefined>;
|
|
3280
|
-
/**
|
|
3281
|
-
* Whether the person approved a comment Mossbear drafted. Present on every
|
|
3282
|
-
* Mossbear comment and absent on a person's or an agent's, which are
|
|
3283
|
-
* requests as written. `false` is a draft nobody has read yet: a reader shows
|
|
3284
|
-
* it to the user and acts only on their go-ahead. Only a client that reports
|
|
3285
|
-
* a version able to mark drafts is ever listed one, so an older reader that
|
|
3286
|
-
* strips this field never receives a draft it would print as a request.
|
|
3287
|
-
*/
|
|
3288
|
-
readonly approved: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
|
|
3289
|
-
/** The author's display name as the workspace shows it, or null. Never an email. */
|
|
3290
|
-
readonly authorName: v.NullableSchema<v.StringSchema<undefined>, undefined>;
|
|
3291
|
-
/** ISO timestamp, machine format. */
|
|
3292
|
-
readonly createdAt: v.StringSchema<undefined>;
|
|
3293
|
-
/** The item's content version the comment was written against. */
|
|
3294
|
-
readonly itemVersion: v.NumberSchema<undefined>;
|
|
3295
|
-
/** True when the item's current version is greater than `itemVersion`. */
|
|
3296
|
-
readonly itemChangedSince: v.BooleanSchema<undefined>;
|
|
3297
|
-
/**
|
|
3298
|
-
* How many agent reads were handed this comment **before** this one — so a
|
|
3299
|
-
* comment reaching an agent for the first time reports `0`.
|
|
3300
|
-
*
|
|
3301
|
-
* It is the stored count as it read at the moment the response was built;
|
|
3302
|
-
* the serve this response *is* has not been counted yet. Excluded rather
|
|
3303
|
-
* than included because the count is recorded best-effort: a response that
|
|
3304
|
-
* claimed to include itself would be wrong whenever that record failed, and
|
|
3305
|
-
* a number that is sometimes off by one is worse than one that is
|
|
3306
|
-
* consistently the prior total.
|
|
3307
|
-
*
|
|
3308
|
-
* So `deliveredCount > 0` means an earlier read was handed this comment, and
|
|
3309
|
-
* `0` means this read is the first. Neither says a model took it in — only
|
|
3310
|
-
* that the server handed it over.
|
|
3311
|
-
*/
|
|
3312
|
-
readonly deliveredCount: v.NumberSchema<undefined>;
|
|
3313
|
-
/**
|
|
3314
|
-
* This comment's thread root — its own id for every delivered root. Resolution
|
|
3315
|
-
* replies remain on the dashboard thread and are not delivered to agents.
|
|
3316
|
-
* It is on the wire from the first response
|
|
3317
|
-
* because the wire contract is consumed by installed CLI versions: reshaping
|
|
3318
|
-
* a flat `comments` array into threads-of-comments later would be a breaking
|
|
3319
|
-
* change, while a field today's readers ignore costs them nothing.
|
|
3320
|
-
*/
|
|
3321
|
-
readonly threadId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
3322
|
-
/**
|
|
3323
|
-
* Always `null` for a delivered root. Present so an older reader meeting a
|
|
3324
|
-
* future response that carries real replies degrades to
|
|
3325
|
-
* "a flat list of comments" rather than failing to parse.
|
|
3326
|
-
*/
|
|
3327
|
-
readonly replyToId: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>;
|
|
3328
|
-
}, undefined>, undefined>, v.MaxLengthAction<{
|
|
3329
|
-
id: string;
|
|
3330
|
-
state?: "open" | "resolved" | undefined;
|
|
3331
|
-
passage?: {
|
|
3332
|
-
quote: string;
|
|
3333
|
-
status: "located" | "changed" | "orphaned";
|
|
3334
|
-
lines: {
|
|
3335
|
-
start: number;
|
|
3336
|
-
end: number;
|
|
3337
|
-
} | null;
|
|
3338
|
-
} | undefined;
|
|
3339
|
-
body: string;
|
|
3340
|
-
suggestion?: string | undefined;
|
|
3341
|
-
finding?: {
|
|
3342
|
-
tier: "observed" | "usage" | "practice";
|
|
3343
|
-
tierLine: string;
|
|
3344
|
-
blindSpot: string;
|
|
3345
|
-
prediction: string | null;
|
|
3346
|
-
} | undefined;
|
|
3347
|
-
approved?: boolean | undefined;
|
|
3348
|
-
authorName: string | null;
|
|
3349
|
-
createdAt: string;
|
|
3350
|
-
itemVersion: number;
|
|
3351
|
-
itemChangedSince: boolean;
|
|
3352
|
-
deliveredCount: number;
|
|
3353
|
-
threadId: string;
|
|
3354
|
-
replyToId: string | null;
|
|
3355
|
-
}[], 20, undefined>]>, undefined>;
|
|
3356
|
-
readonly updatedAt: v.StringSchema<undefined>;
|
|
3357
|
-
/**
|
|
3358
|
-
* Present iff this artifact is owned by git. Absent means Mossbear owns it
|
|
3359
|
-
* and it is editable in the dashboard.
|
|
3360
|
-
*
|
|
3361
|
-
* **Optional, and absence is not yet a verdict.** Nothing writes this before
|
|
3362
|
-
* `publish` ships, so today every item omits it, and the existing bundle-home
|
|
3363
|
-
* rule — a bundle may name one repo as its only writer, and the server
|
|
3364
|
-
* refuses every other writer by name — is what still protects items a repo
|
|
3365
|
-
* already owns. A reader must not treat an absent `gitSource` as permission
|
|
3366
|
-
* to publish back.
|
|
3367
|
-
*
|
|
3368
|
-
* **Optional *and* nullable, like every other late-added column on this item.**
|
|
3369
|
-
* A serializer that maps the columns straight through emits `null` for a
|
|
3370
|
-
* Mossbear-owned row, and a key that only accepted `undefined` would throw on
|
|
3371
|
-
* the whole response rather than on the one item — `parseContextItemsResponse`
|
|
3372
|
-
* parses a pull as a batch. Both spellings read the same way: no git source.
|
|
3373
|
-
*
|
|
3374
|
-
* **`path` is the third required member of the subset and is not re-checked
|
|
3375
|
-
* here.** The database holds that invariant
|
|
3376
|
-
* (`guide_files_git_source_subset`), and a wire rule that looked identical
|
|
3377
|
-
* would in fact be stricter: `path` is serialized through a scope helper that
|
|
3378
|
-
* emits `null` for a path this schema cannot parse, so a single such row would
|
|
3379
|
-
* fail every other item in the same pull. A git-owned item that arrives
|
|
3380
|
-
* without a usable path is a broken item, not a broken response.
|
|
3381
|
-
*/
|
|
3382
|
-
readonly gitSource: v.OptionalSchema<v.NullableSchema<v.ObjectSchema<{
|
|
3383
|
-
/**
|
|
3384
|
-
* The committed `project.id` of the source repository — the same id space as
|
|
3385
|
-
* an item's delivery-scoping `projectId` below, but a different fact: that one
|
|
3386
|
-
* says which repo an item is materialized into and is stamped onto
|
|
3387
|
-
* Mossbear-owned rows too, this one says who may edit it.
|
|
3388
|
-
*/
|
|
3389
|
-
readonly projectId: 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">]>;
|
|
3390
|
-
readonly commitSha: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "commitSha must be 40 or 64 lowercase hex characters">]>;
|
|
3391
|
-
/**
|
|
3392
|
-
* The branch the publishing commit was on. **The one optional member**:
|
|
3393
|
-
* publication is not restricted by branch, so this is recorded so a subscriber
|
|
3394
|
-
* can see what they got, and a detached HEAD has none to record.
|
|
3395
|
-
*/
|
|
3396
|
-
readonly branch: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 255, undefined>]>, undefined>;
|
|
3397
|
-
}, undefined>, undefined>, undefined>;
|
|
3398
|
-
/**
|
|
3399
|
-
* This artifact is a **tombstone**: the repository that publishes it deleted
|
|
3400
|
-
* the file, so what the item still carries is the last revision rather than a
|
|
3401
|
-
* current one (`artifact-ownership-and-delivery-plan.md` → D28).
|
|
3402
|
-
*
|
|
3403
|
-
* **It is still delivered, and that is deliberate.** Dropping the item from
|
|
3404
|
-
* the response would say the same thing more quietly and cost two things
|
|
3405
|
-
* worth more than the byte: the publishing repo would lose the id it needs to
|
|
3406
|
-
* republish the path in place — re-adding a deleted file would create a
|
|
3407
|
-
* second artifact at the same path rather than a new revision of the one
|
|
3408
|
-
* that is there — and a reader would be left unable to tell a removal from
|
|
3409
|
-
* a bundle it has stopped being able to see. What the flag asks of a client
|
|
3410
|
-
* is one thing: do not materialize it. A file left at a discovery root keeps
|
|
3411
|
-
* feeding deleted guidance into every agent that reads that repo, which is
|
|
3412
|
-
* the failure the decision exists to stop.
|
|
3413
|
-
*
|
|
3414
|
-
* **Optional, and absent means an ordinary artifact.** A client that has
|
|
3415
|
-
* never heard of it behaves as it always did — it keeps the last published
|
|
3416
|
-
* revision on disk, which is the retain behaviour this replaces rather than a
|
|
3417
|
-
* new failure. That is what makes the server safe to ship first.
|
|
3418
|
-
*
|
|
3419
|
-
* `literal(true)` rather than a boolean: `removed: false` would be a second
|
|
3420
|
-
* spelling of absence, and an artifact that came back is content again rather
|
|
3421
|
-
* than a tombstone that says no.
|
|
3422
|
-
*/
|
|
3423
|
-
readonly removed: v.OptionalSchema<v.LiteralSchema<true, undefined>, undefined>;
|
|
3424
|
-
}, undefined>, v.TransformAction<{
|
|
3425
|
-
id: string;
|
|
3426
|
-
artifactId?: string | null | undefined;
|
|
3427
|
-
type?: string | undefined;
|
|
3428
|
-
name: string;
|
|
3429
|
-
role: string | null;
|
|
3430
|
-
format: string | null;
|
|
3431
|
-
content: string | null;
|
|
3432
|
-
origin?: string | null | undefined;
|
|
3433
|
-
version?: number | undefined;
|
|
3434
|
-
guideId?: string | null | undefined;
|
|
3435
|
-
root?: "project" | "global" | null | undefined;
|
|
3436
|
-
path?: string | null | undefined;
|
|
3437
|
-
projectId?: string | null | undefined;
|
|
3438
|
-
pathProjectId?: string | null | undefined;
|
|
3439
|
-
aliases?: {
|
|
3440
|
-
root: "project" | "global";
|
|
3441
|
-
path: string;
|
|
3442
|
-
}[] | undefined;
|
|
3443
|
-
comments?: {
|
|
3444
|
-
id: string;
|
|
3445
|
-
state?: "open" | "resolved" | undefined;
|
|
3446
|
-
passage?: {
|
|
3447
|
-
quote: string;
|
|
3448
|
-
status: "located" | "changed" | "orphaned";
|
|
3449
|
-
lines: {
|
|
3450
|
-
start: number;
|
|
3451
|
-
end: number;
|
|
3452
|
-
} | null;
|
|
3453
|
-
} | undefined;
|
|
3454
|
-
body: string;
|
|
3455
|
-
suggestion?: string | undefined;
|
|
3456
|
-
finding?: {
|
|
3457
|
-
tier: "observed" | "usage" | "practice";
|
|
3458
|
-
tierLine: string;
|
|
3459
|
-
blindSpot: string;
|
|
3460
|
-
prediction: string | null;
|
|
3461
|
-
} | undefined;
|
|
3462
|
-
approved?: boolean | undefined;
|
|
3463
|
-
authorName: string | null;
|
|
3464
|
-
createdAt: string;
|
|
3465
|
-
itemVersion: number;
|
|
3466
|
-
itemChangedSince: boolean;
|
|
3467
|
-
deliveredCount: number;
|
|
3468
|
-
threadId: string;
|
|
3469
|
-
replyToId: string | null;
|
|
3470
|
-
}[] | undefined;
|
|
3471
|
-
updatedAt: string;
|
|
3472
|
-
gitSource?: {
|
|
3473
|
-
projectId: string;
|
|
3474
|
-
commitSha: string;
|
|
3475
|
-
branch?: string | undefined;
|
|
3476
|
-
} | null | undefined;
|
|
3477
|
-
removed?: true | undefined;
|
|
3478
|
-
}, {
|
|
3479
|
-
type: string;
|
|
3480
|
-
id: string;
|
|
3481
|
-
artifactId?: string | null | undefined;
|
|
3482
|
-
name: string;
|
|
3483
|
-
role: string | null;
|
|
3484
|
-
format: string | null;
|
|
3485
|
-
content: string | null;
|
|
3486
|
-
origin?: string | null | undefined;
|
|
3487
|
-
version?: number | undefined;
|
|
3488
|
-
guideId?: string | null | undefined;
|
|
3489
|
-
root?: "project" | "global" | null | undefined;
|
|
3490
|
-
path?: string | null | undefined;
|
|
3491
|
-
projectId?: string | null | undefined;
|
|
3492
|
-
pathProjectId?: string | null | undefined;
|
|
3493
|
-
aliases?: {
|
|
3494
|
-
root: "project" | "global";
|
|
3495
|
-
path: string;
|
|
3496
|
-
}[] | undefined;
|
|
3497
|
-
comments?: {
|
|
3498
|
-
id: string;
|
|
3499
|
-
state?: "open" | "resolved" | undefined;
|
|
3500
|
-
passage?: {
|
|
3501
|
-
quote: string;
|
|
3502
|
-
status: "located" | "changed" | "orphaned";
|
|
3503
|
-
lines: {
|
|
3504
|
-
start: number;
|
|
3505
|
-
end: number;
|
|
3506
|
-
} | null;
|
|
3507
|
-
} | undefined;
|
|
3508
|
-
body: string;
|
|
3509
|
-
suggestion?: string | undefined;
|
|
3510
|
-
finding?: {
|
|
3511
|
-
tier: "observed" | "usage" | "practice";
|
|
3512
|
-
tierLine: string;
|
|
3513
|
-
blindSpot: string;
|
|
3514
|
-
prediction: string | null;
|
|
3515
|
-
} | undefined;
|
|
3516
|
-
approved?: boolean | undefined;
|
|
3517
|
-
authorName: string | null;
|
|
3518
|
-
createdAt: string;
|
|
3519
|
-
itemVersion: number;
|
|
3520
|
-
itemChangedSince: boolean;
|
|
3521
|
-
deliveredCount: number;
|
|
3522
|
-
threadId: string;
|
|
3523
|
-
replyToId: string | null;
|
|
3524
|
-
}[] | undefined;
|
|
3525
|
-
updatedAt: string;
|
|
3526
|
-
gitSource?: {
|
|
3527
|
-
projectId: string;
|
|
3528
|
-
commitSha: string;
|
|
3529
|
-
branch?: string | undefined;
|
|
3530
|
-
} | null | undefined;
|
|
3531
|
-
removed?: true | undefined;
|
|
3532
|
-
}>]>;
|
|
3533
|
-
readonly updated: v.BooleanSchema<undefined>;
|
|
3534
|
-
}, undefined>;
|
|
3535
|
-
export declare const UpdateContextItemBodySchema: Omit<v.ObjectSchema<{
|
|
3536
|
-
readonly itemId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
3537
|
-
readonly name: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 200, undefined>]>, undefined>;
|
|
3538
|
-
readonly content: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.CheckAction<string, "content must be at most 524288 bytes">]>, undefined>;
|
|
3539
|
-
readonly expectedVersion: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>, undefined>;
|
|
3540
|
-
/**
|
|
3541
|
-
* The committed `project.id` of the checkout this write comes from — same
|
|
3542
|
-
* meaning and same two uses as on `PushContextRequestSchema`: a bundle that
|
|
3543
|
-
* claims a home accepts writes only from that repo, and a request declaring
|
|
3544
|
-
* nothing is not it; and when this update sets `path`, it is stored as the
|
|
3545
|
-
* repo that path is placed in. Parsed as on `PushContextRequestSchema`.
|
|
3546
|
-
*/
|
|
3547
|
-
readonly projectId: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>]>, undefined>;
|
|
2810
|
+
readonly replyToId: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>;
|
|
2811
|
+
}, undefined>, undefined>;
|
|
2812
|
+
readonly cursor: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
|
|
3548
2813
|
/**
|
|
3549
|
-
*
|
|
3550
|
-
*
|
|
3551
|
-
*
|
|
3552
|
-
* **Three states, the same shape `sourceItemIds` takes.** Omitted leaves the
|
|
3553
|
-
* stored path and its home alone — every name or body edit. A path replaces
|
|
3554
|
-
* both: the path, and the home as `projectId` above declares it, since a path
|
|
3555
|
-
* is relative to the repo that declared it. `null` clears both.
|
|
3556
|
-
*
|
|
3557
|
-
* The same schema as the create side and the read side, for the reason
|
|
3558
|
-
* `PushContextRequestSchema` gives, and the same refusals in the routes —
|
|
3559
|
-
* agent guidance, Mossbear's state directory, git's.
|
|
3560
|
-
*
|
|
3561
|
-
* **Documents only.** A guide's path is its discovery path, which import
|
|
3562
|
-
* reconciles on; moving it here would fork it from the file it came from, so
|
|
3563
|
-
* the routes refuse it on a guide by name. A git-published artifact cannot
|
|
3564
|
-
* drop its path either, because the published-source group is only legal
|
|
3565
|
-
* beside one.
|
|
2814
|
+
* The markers every `body` above is wrapped in, plus a statement of what
|
|
2815
|
+
* they mean. Present exactly when at least one comment came back.
|
|
3566
2816
|
*/
|
|
3567
|
-
readonly
|
|
3568
|
-
|
|
2817
|
+
readonly untrusted: v.OptionalSchema<v.NullableSchema<v.ObjectSchema<{
|
|
2818
|
+
readonly token: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
2819
|
+
readonly startMarker: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
2820
|
+
readonly endMarker: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
2821
|
+
readonly note: v.StringSchema<undefined>;
|
|
2822
|
+
}, undefined>, undefined>, undefined>;
|
|
2823
|
+
}, undefined>;
|
|
2824
|
+
export type ItemCommentsResponse = v.InferOutput<typeof ItemCommentsResponseSchema>;
|
|
2825
|
+
/**
|
|
2826
|
+
* The evidence behind one Mossbear finding an agent was handed
|
|
2827
|
+
* (`GET /api/v1/context/comments/evidence`).
|
|
2828
|
+
*
|
|
2829
|
+
* `list_comments` carries the claim and a one-line tier; this is the finding
|
|
2830
|
+
* in full: the claim, the change it predicts in future sessions, what the
|
|
2831
|
+
* drafter did not read, and the evidence for its tier. Readable only through a
|
|
2832
|
+
* comment the comment read itself would deliver to this reader, so another
|
|
2833
|
+
* person's finding, one drafted from another repo, or a draft listed only to a
|
|
2834
|
+
* newer client has no evidence here either. A draft the reader was listed
|
|
2835
|
+
* does: an agent can say why it was raised before the person approves it.
|
|
2836
|
+
*
|
|
2837
|
+
* Citations (observed and usage findings) are reduced to what the reader may
|
|
2838
|
+
* see: their own sessions, with a date and a short excerpt of the grader's
|
|
2839
|
+
* reasoning or of their own redacted correction turn. A `navigation` citation
|
|
2840
|
+
* has an empty excerpt: it is dated evidence that a session loaded the skill,
|
|
2841
|
+
* and nothing more. `citationsWithheld` counts any that were dropped, so a
|
|
2842
|
+
* short list is never mistaken for the whole of it.
|
|
2843
|
+
*/
|
|
2844
|
+
export declare const CommentEvidenceCitationSchema: v.ObjectSchema<{
|
|
3569
2845
|
/**
|
|
3570
|
-
*
|
|
3571
|
-
*
|
|
3572
|
-
*
|
|
3573
|
-
*
|
|
3574
|
-
*
|
|
3575
|
-
* **Omitted leaves the stored group alone; it never clears it.** An update
|
|
3576
|
-
* that says nothing about provenance is a name or body edit, not a claim that
|
|
3577
|
-
* the artifact stopped being git-owned — and an absent key that silently
|
|
3578
|
-
* un-owned a row would hand a subscriber write access by omission, which is
|
|
3579
|
-
* the failure the whole ownership model exists to prevent. Ownership is given
|
|
3580
|
-
* up by promotion, not by a missing field.
|
|
2846
|
+
* `navigation` is a skill load counted when a finding was drafted from how
|
|
2847
|
+
* the skill's files were read: evidence of how a skill was used, not of a
|
|
2848
|
+
* failure. `action` is a recorded step of a workflow repeated across
|
|
2849
|
+
* sessions. A server sends it only to a client that names a version new
|
|
2850
|
+
* enough to parse it.
|
|
3581
2851
|
*/
|
|
3582
|
-
readonly
|
|
3583
|
-
|
|
3584
|
-
|
|
3585
|
-
|
|
3586
|
-
|
|
3587
|
-
|
|
3588
|
-
|
|
3589
|
-
|
|
3590
|
-
|
|
3591
|
-
|
|
3592
|
-
|
|
3593
|
-
|
|
3594
|
-
|
|
3595
|
-
|
|
3596
|
-
|
|
3597
|
-
|
|
3598
|
-
/**
|
|
3599
|
-
|
|
3600
|
-
|
|
3601
|
-
|
|
3602
|
-
|
|
3603
|
-
|
|
3604
|
-
|
|
3605
|
-
|
|
3606
|
-
|
|
3607
|
-
|
|
3608
|
-
|
|
3609
|
-
|
|
3610
|
-
* **`gitSource` is required alongside it and the route enforces that.** A
|
|
3611
|
-
* tombstone's whole claim is *which revision removed the file*: without one
|
|
3612
|
-
* the row would say an artifact stopped being delivered and be unable to say
|
|
3613
|
-
* why, which is the silent withdrawal this field exists to replace. That also
|
|
3614
|
-
* keeps the only writer of a removal here the publication path — this is not
|
|
3615
|
-
* a general delete verb for the context layer.
|
|
3616
|
-
*
|
|
3617
|
-
* **Never sent with `content`.** A removal has no bytes; a body carrying both
|
|
3618
|
-
* is two answers to one question and the route refuses it rather than picking.
|
|
3619
|
-
*/
|
|
3620
|
-
readonly removed: v.OptionalSchema<v.LiteralSchema<true, undefined>, undefined>;
|
|
3621
|
-
}, undefined>, "entries" | "~types" | "~run" | "~standard"> & {
|
|
3622
|
-
readonly entries: Omit<{
|
|
3623
|
-
readonly itemId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
3624
|
-
readonly name: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 200, undefined>]>, undefined>;
|
|
3625
|
-
readonly content: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.CheckAction<string, "content must be at most 524288 bytes">]>, undefined>;
|
|
3626
|
-
readonly expectedVersion: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>, undefined>;
|
|
3627
|
-
/**
|
|
3628
|
-
* The committed `project.id` of the checkout this write comes from — same
|
|
3629
|
-
* meaning and same two uses as on `PushContextRequestSchema`: a bundle that
|
|
3630
|
-
* claims a home accepts writes only from that repo, and a request declaring
|
|
3631
|
-
* nothing is not it; and when this update sets `path`, it is stored as the
|
|
3632
|
-
* repo that path is placed in. Parsed as on `PushContextRequestSchema`.
|
|
3633
|
-
*/
|
|
3634
|
-
readonly projectId: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>]>, undefined>;
|
|
3635
|
-
/**
|
|
3636
|
-
* Move the document: its new placement, or `null` to take the placement away
|
|
3637
|
-
* so it lands in the bundle folder again.
|
|
3638
|
-
*
|
|
3639
|
-
* **Three states, the same shape `sourceItemIds` takes.** Omitted leaves the
|
|
3640
|
-
* stored path and its home alone — every name or body edit. A path replaces
|
|
3641
|
-
* both: the path, and the home as `projectId` above declares it, since a path
|
|
3642
|
-
* is relative to the repo that declared it. `null` clears both.
|
|
3643
|
-
*
|
|
3644
|
-
* The same schema as the create side and the read side, for the reason
|
|
3645
|
-
* `PushContextRequestSchema` gives, and the same refusals in the routes —
|
|
3646
|
-
* agent guidance, Mossbear's state directory, git's.
|
|
3647
|
-
*
|
|
3648
|
-
* **Documents only.** A guide's path is its discovery path, which import
|
|
3649
|
-
* reconciles on; moving it here would fork it from the file it came from, so
|
|
3650
|
-
* the routes refuse it on a guide by name. A git-published artifact cannot
|
|
3651
|
-
* drop its path either, because the published-source group is only legal
|
|
3652
|
-
* beside one.
|
|
3653
|
-
*/
|
|
3654
|
-
readonly path: v.OptionalSchema<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>, undefined>;
|
|
3655
|
-
readonly sourceItemIds: v.OptionalSchema<v.SchemaWithPipe<readonly [v.ArraySchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>, v.MaxLengthAction<string[], 100, undefined>]>, undefined>;
|
|
3656
|
-
/**
|
|
3657
|
-
* The revision this update's bytes were read from — same meaning as on
|
|
3658
|
-
* `PushContextRequestSchema` above, and the field that makes a republication
|
|
3659
|
-
* advance an artifact's provenance rather than leave it pointing at the
|
|
3660
|
-
* commit it was first published from.
|
|
3661
|
-
*
|
|
3662
|
-
* **Omitted leaves the stored group alone; it never clears it.** An update
|
|
3663
|
-
* that says nothing about provenance is a name or body edit, not a claim that
|
|
3664
|
-
* the artifact stopped being git-owned — and an absent key that silently
|
|
3665
|
-
* un-owned a row would hand a subscriber write access by omission, which is
|
|
3666
|
-
* the failure the whole ownership model exists to prevent. Ownership is given
|
|
3667
|
-
* up by promotion, not by a missing field.
|
|
3668
|
-
*/
|
|
3669
|
-
readonly gitSource: v.OptionalSchema<v.ObjectSchema<{
|
|
3670
|
-
/**
|
|
3671
|
-
* The committed `project.id` of the source repository — the same id space as
|
|
3672
|
-
* an item's delivery-scoping `projectId` below, but a different fact: that one
|
|
3673
|
-
* says which repo an item is materialized into and is stamped onto
|
|
3674
|
-
* Mossbear-owned rows too, this one says who may edit it.
|
|
3675
|
-
*/
|
|
3676
|
-
readonly projectId: 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">]>;
|
|
3677
|
-
readonly commitSha: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "commitSha must be 40 or 64 lowercase hex characters">]>;
|
|
3678
|
-
/**
|
|
3679
|
-
* The branch the publishing commit was on. **The one optional member**:
|
|
3680
|
-
* publication is not restricted by branch, so this is recorded so a subscriber
|
|
3681
|
-
* can see what they got, and a detached HEAD has none to record.
|
|
3682
|
-
*/
|
|
3683
|
-
readonly branch: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 255, undefined>]>, undefined>;
|
|
3684
|
-
}, undefined>, undefined>;
|
|
3685
|
-
/**
|
|
3686
|
-
* Tombstone this artifact: the commit that published it has since deleted the
|
|
3687
|
-
* file, so the revision stops being delivered while the row and its version
|
|
3688
|
-
* history stay where they are.
|
|
3689
|
-
*
|
|
3690
|
-
* **A verb, not a column state**, the same shape the dashboard's own removal
|
|
3691
|
-
* takes (`~/zero/mutators.ts` → `guideFiles.update`'s `removed`). There is no
|
|
3692
|
-
* writable field here that a removal and an ordinary edit could disagree
|
|
3693
|
-
* about, and `literal(true)` is what keeps `removed: false` from reading as a
|
|
3694
|
-
* request to bring something back — un-removing is republishing, which is an
|
|
3695
|
-
* ordinary content write.
|
|
3696
|
-
*
|
|
3697
|
-
* **`gitSource` is required alongside it and the route enforces that.** A
|
|
3698
|
-
* tombstone's whole claim is *which revision removed the file*: without one
|
|
3699
|
-
* the row would say an artifact stopped being delivered and be unable to say
|
|
3700
|
-
* why, which is the silent withdrawal this field exists to replace. That also
|
|
3701
|
-
* keeps the only writer of a removal here the publication path — this is not
|
|
3702
|
-
* a general delete verb for the context layer.
|
|
3703
|
-
*
|
|
3704
|
-
* **Never sent with `content`.** A removal has no bytes; a body carrying both
|
|
3705
|
-
* is two answers to one question and the route refuses it rather than picking.
|
|
3706
|
-
*/
|
|
3707
|
-
readonly removed: v.OptionalSchema<v.LiteralSchema<true, undefined>, undefined>;
|
|
3708
|
-
}, "itemId">;
|
|
3709
|
-
readonly "~standard": v.StandardProps<{
|
|
3710
|
-
content?: string | undefined;
|
|
3711
|
-
path?: string | null | undefined;
|
|
3712
|
-
expectedVersion?: number | undefined;
|
|
3713
|
-
projectId?: string | undefined;
|
|
3714
|
-
name?: string | undefined;
|
|
3715
|
-
gitSource?: {
|
|
3716
|
-
projectId: string;
|
|
3717
|
-
commitSha: string;
|
|
3718
|
-
branch?: string | undefined;
|
|
3719
|
-
} | undefined;
|
|
3720
|
-
removed?: true | undefined;
|
|
3721
|
-
sourceItemIds?: string[] | undefined;
|
|
3722
|
-
}, {
|
|
3723
|
-
content?: string | undefined;
|
|
3724
|
-
path?: string | null | undefined;
|
|
3725
|
-
expectedVersion?: number | undefined;
|
|
3726
|
-
projectId?: string | undefined;
|
|
3727
|
-
name?: string | undefined;
|
|
3728
|
-
gitSource?: {
|
|
3729
|
-
projectId: string;
|
|
3730
|
-
commitSha: string;
|
|
3731
|
-
branch?: string | undefined;
|
|
3732
|
-
} | undefined;
|
|
3733
|
-
removed?: true | undefined;
|
|
3734
|
-
sourceItemIds?: string[] | undefined;
|
|
3735
|
-
}>;
|
|
3736
|
-
readonly "~run": (dataset: v.UnknownDataset, config: v.Config<v.BaseIssue<unknown>>) => v.OutputDataset<{
|
|
3737
|
-
content?: string | undefined;
|
|
3738
|
-
path?: string | null | undefined;
|
|
3739
|
-
expectedVersion?: number | undefined;
|
|
3740
|
-
projectId?: string | undefined;
|
|
3741
|
-
name?: string | undefined;
|
|
3742
|
-
gitSource?: {
|
|
3743
|
-
projectId: string;
|
|
3744
|
-
commitSha: string;
|
|
3745
|
-
branch?: string | undefined;
|
|
3746
|
-
} | undefined;
|
|
3747
|
-
removed?: true | undefined;
|
|
3748
|
-
sourceItemIds?: string[] | undefined;
|
|
3749
|
-
}, v.StringIssue | v.MinLengthIssue<string, 1> | v.RegexIssue<string> | v.CheckIssue<string> | v.MaxLengthIssue<string, 512> | v.NumberIssue | v.IntegerIssue<number> | v.ArrayIssue | v.ObjectIssue | v.MinValueIssue<number, 1> | v.MaxLengthIssue<string, 128> | v.MaxLengthIssue<string, 200> | v.MaxLengthIssue<string, 255> | v.LiteralIssue | v.MaxLengthIssue<string[], 100>>;
|
|
3750
|
-
readonly "~types"?: {
|
|
3751
|
-
readonly input: {
|
|
3752
|
-
content?: string | undefined;
|
|
3753
|
-
path?: string | null | undefined;
|
|
3754
|
-
expectedVersion?: number | undefined;
|
|
3755
|
-
projectId?: string | undefined;
|
|
3756
|
-
name?: string | undefined;
|
|
3757
|
-
gitSource?: {
|
|
3758
|
-
projectId: string;
|
|
3759
|
-
commitSha: string;
|
|
3760
|
-
branch?: string | undefined;
|
|
3761
|
-
} | undefined;
|
|
3762
|
-
removed?: true | undefined;
|
|
3763
|
-
sourceItemIds?: string[] | undefined;
|
|
3764
|
-
};
|
|
3765
|
-
readonly output: {
|
|
3766
|
-
content?: string | undefined;
|
|
3767
|
-
path?: string | null | undefined;
|
|
3768
|
-
expectedVersion?: number | undefined;
|
|
3769
|
-
projectId?: string | undefined;
|
|
3770
|
-
name?: string | undefined;
|
|
3771
|
-
gitSource?: {
|
|
3772
|
-
projectId: string;
|
|
3773
|
-
commitSha: string;
|
|
3774
|
-
branch?: string | undefined;
|
|
3775
|
-
} | undefined;
|
|
3776
|
-
removed?: true | undefined;
|
|
3777
|
-
sourceItemIds?: string[] | undefined;
|
|
3778
|
-
};
|
|
3779
|
-
readonly issue: v.StringIssue | v.MinLengthIssue<string, 1> | v.RegexIssue<string> | v.CheckIssue<string> | v.MaxLengthIssue<string, 512> | v.NumberIssue | v.IntegerIssue<number> | v.ArrayIssue | v.ObjectIssue | v.MinValueIssue<number, 1> | v.MaxLengthIssue<string, 128> | v.MaxLengthIssue<string, 200> | v.MaxLengthIssue<string, 255> | v.LiteralIssue | v.MaxLengthIssue<string[], 100>;
|
|
3780
|
-
} | undefined;
|
|
3781
|
-
};
|
|
3782
|
-
/** A single canonical item, for the item-scoped read route. */
|
|
3783
|
-
export declare const ContextItemResponseSchema: v.ObjectSchema<{
|
|
3784
|
-
readonly item: v.SchemaWithPipe<readonly [v.ObjectSchema<{
|
|
2852
|
+
readonly kind: v.PicklistSchema<["verdict", "turn", "navigation", "action"], undefined>;
|
|
2853
|
+
readonly sessionId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
2854
|
+
/** ISO, when the verdict was graded, the turn was said, the skill loaded, or the action was recorded. */
|
|
2855
|
+
readonly at: v.StringSchema<undefined>;
|
|
2856
|
+
/** Wrapped in the response's untrusted markers. */
|
|
2857
|
+
readonly excerpt: v.StringSchema<undefined>;
|
|
2858
|
+
}, undefined>;
|
|
2859
|
+
export type CommentEvidenceCitation = v.InferOutput<typeof CommentEvidenceCitationSchema>;
|
|
2860
|
+
/** What a usage finding adds to its citations: the counts for one reference file. */
|
|
2861
|
+
export declare const CommentEvidenceUsageSchema: v.ObjectSchema<{
|
|
2862
|
+
/** The reference's skill-relative path, wrapped in the response's untrusted markers. */
|
|
2863
|
+
readonly path: v.StringSchema<undefined>;
|
|
2864
|
+
/** Eligible loads of the skill. */
|
|
2865
|
+
readonly loads: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>]>;
|
|
2866
|
+
/** Distinct sessions those loads span. */
|
|
2867
|
+
readonly sessions: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>]>;
|
|
2868
|
+
/** Loads followed by a successful read of the reference. */
|
|
2869
|
+
readonly loadsWithRead: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>]>;
|
|
2870
|
+
}, undefined>;
|
|
2871
|
+
/**
|
|
2872
|
+
* What a practice finding adds: the rubric check it answers and the rubric's
|
|
2873
|
+
* version, the practice lines it weighs with their sources, the facts measured
|
|
2874
|
+
* from the file, and the answer to each item of evidence the check asks for.
|
|
2875
|
+
* `answers[].answer` is model-written, so it travels wrapped in the response's
|
|
2876
|
+
* untrusted markers.
|
|
2877
|
+
*/
|
|
2878
|
+
export declare const CommentEvidencePracticeSchema: v.ObjectSchema<{
|
|
2879
|
+
readonly check: v.ObjectSchema<{
|
|
3785
2880
|
readonly id: v.StringSchema<undefined>;
|
|
3786
|
-
/**
|
|
3787
|
-
* The id every artifact route addresses: the body file's id for a guide
|
|
3788
|
-
* (null only for a guide with no body yet), the item's own id otherwise.
|
|
3789
|
-
* Optional so a client tolerates a server that predates it, and one that
|
|
3790
|
-
* stops sending it (the item id is the artifact id).
|
|
3791
|
-
*/
|
|
3792
|
-
readonly artifactId: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
|
|
3793
|
-
/**
|
|
3794
|
-
* Leaving the wire: a reader tells a guide from content by `role` and the
|
|
3795
|
-
* guide fields, not by this. Optional so a client parses a server that no
|
|
3796
|
-
* longer sends it.
|
|
3797
|
-
*/
|
|
3798
|
-
readonly type: v.OptionalSchema<v.PicklistSchema<string[], undefined>, undefined>;
|
|
3799
2881
|
readonly name: v.StringSchema<undefined>;
|
|
3800
|
-
|
|
3801
|
-
|
|
3802
|
-
|
|
3803
|
-
|
|
3804
|
-
|
|
3805
|
-
|
|
3806
|
-
|
|
3807
|
-
|
|
3808
|
-
|
|
3809
|
-
|
|
3810
|
-
|
|
3811
|
-
|
|
3812
|
-
|
|
3813
|
-
|
|
3814
|
-
|
|
3815
|
-
|
|
3816
|
-
|
|
3817
|
-
|
|
3818
|
-
|
|
3819
|
-
|
|
3820
|
-
|
|
3821
|
-
|
|
3822
|
-
|
|
3823
|
-
|
|
3824
|
-
|
|
3825
|
-
|
|
3826
|
-
|
|
3827
|
-
|
|
3828
|
-
|
|
3829
|
-
|
|
3830
|
-
|
|
3831
|
-
|
|
3832
|
-
|
|
3833
|
-
|
|
3834
|
-
|
|
3835
|
-
|
|
3836
|
-
|
|
3837
|
-
|
|
3838
|
-
|
|
3839
|
-
|
|
3840
|
-
|
|
3841
|
-
|
|
3842
|
-
|
|
3843
|
-
|
|
3844
|
-
|
|
3845
|
-
|
|
3846
|
-
|
|
3847
|
-
|
|
3848
|
-
|
|
3849
|
-
|
|
3850
|
-
|
|
3851
|
-
|
|
3852
|
-
readonly
|
|
3853
|
-
|
|
3854
|
-
|
|
3855
|
-
|
|
3856
|
-
|
|
3857
|
-
|
|
3858
|
-
|
|
3859
|
-
|
|
3860
|
-
|
|
3861
|
-
|
|
3862
|
-
|
|
3863
|
-
|
|
3864
|
-
|
|
3865
|
-
|
|
3866
|
-
|
|
3867
|
-
|
|
3868
|
-
|
|
3869
|
-
|
|
3870
|
-
|
|
3871
|
-
|
|
3872
|
-
|
|
3873
|
-
|
|
3874
|
-
|
|
3875
|
-
|
|
3876
|
-
|
|
3877
|
-
|
|
3878
|
-
|
|
3879
|
-
|
|
3880
|
-
|
|
3881
|
-
|
|
3882
|
-
|
|
3883
|
-
|
|
3884
|
-
|
|
3885
|
-
|
|
3886
|
-
|
|
3887
|
-
|
|
3888
|
-
|
|
3889
|
-
|
|
3890
|
-
|
|
3891
|
-
|
|
3892
|
-
|
|
3893
|
-
|
|
3894
|
-
|
|
3895
|
-
|
|
3896
|
-
|
|
3897
|
-
|
|
3898
|
-
|
|
3899
|
-
|
|
3900
|
-
|
|
3901
|
-
|
|
3902
|
-
|
|
3903
|
-
|
|
3904
|
-
|
|
3905
|
-
|
|
3906
|
-
|
|
3907
|
-
|
|
3908
|
-
|
|
3909
|
-
|
|
3910
|
-
|
|
3911
|
-
|
|
3912
|
-
|
|
3913
|
-
|
|
3914
|
-
|
|
3915
|
-
|
|
3916
|
-
|
|
3917
|
-
|
|
3918
|
-
|
|
3919
|
-
|
|
3920
|
-
|
|
3921
|
-
|
|
3922
|
-
readonly itemChangedSince: v.BooleanSchema<undefined>;
|
|
3923
|
-
/**
|
|
3924
|
-
* How many agent reads were handed this comment **before** this one — so a
|
|
3925
|
-
* comment reaching an agent for the first time reports `0`.
|
|
3926
|
-
*
|
|
3927
|
-
* It is the stored count as it read at the moment the response was built;
|
|
3928
|
-
* the serve this response *is* has not been counted yet. Excluded rather
|
|
3929
|
-
* than included because the count is recorded best-effort: a response that
|
|
3930
|
-
* claimed to include itself would be wrong whenever that record failed, and
|
|
3931
|
-
* a number that is sometimes off by one is worse than one that is
|
|
3932
|
-
* consistently the prior total.
|
|
3933
|
-
*
|
|
3934
|
-
* So `deliveredCount > 0` means an earlier read was handed this comment, and
|
|
3935
|
-
* `0` means this read is the first. Neither says a model took it in — only
|
|
3936
|
-
* that the server handed it over.
|
|
3937
|
-
*/
|
|
3938
|
-
readonly deliveredCount: v.NumberSchema<undefined>;
|
|
3939
|
-
/**
|
|
3940
|
-
* This comment's thread root — its own id for every delivered root. Resolution
|
|
3941
|
-
* replies remain on the dashboard thread and are not delivered to agents.
|
|
3942
|
-
* It is on the wire from the first response
|
|
3943
|
-
* because the wire contract is consumed by installed CLI versions: reshaping
|
|
3944
|
-
* a flat `comments` array into threads-of-comments later would be a breaking
|
|
3945
|
-
* change, while a field today's readers ignore costs them nothing.
|
|
3946
|
-
*/
|
|
3947
|
-
readonly threadId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
3948
|
-
/**
|
|
3949
|
-
* Always `null` for a delivered root. Present so an older reader meeting a
|
|
3950
|
-
* future response that carries real replies degrades to
|
|
3951
|
-
* "a flat list of comments" rather than failing to parse.
|
|
3952
|
-
*/
|
|
3953
|
-
readonly replyToId: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>;
|
|
3954
|
-
}, undefined>, undefined>, v.MaxLengthAction<{
|
|
3955
|
-
id: string;
|
|
3956
|
-
state?: "open" | "resolved" | undefined;
|
|
3957
|
-
passage?: {
|
|
3958
|
-
quote: string;
|
|
3959
|
-
status: "located" | "changed" | "orphaned";
|
|
3960
|
-
lines: {
|
|
3961
|
-
start: number;
|
|
3962
|
-
end: number;
|
|
3963
|
-
} | null;
|
|
3964
|
-
} | undefined;
|
|
3965
|
-
body: string;
|
|
3966
|
-
suggestion?: string | undefined;
|
|
3967
|
-
finding?: {
|
|
3968
|
-
tier: "observed" | "usage" | "practice";
|
|
3969
|
-
tierLine: string;
|
|
3970
|
-
blindSpot: string;
|
|
3971
|
-
prediction: string | null;
|
|
3972
|
-
} | undefined;
|
|
3973
|
-
approved?: boolean | undefined;
|
|
3974
|
-
authorName: string | null;
|
|
3975
|
-
createdAt: string;
|
|
3976
|
-
itemVersion: number;
|
|
3977
|
-
itemChangedSince: boolean;
|
|
3978
|
-
deliveredCount: number;
|
|
3979
|
-
threadId: string;
|
|
3980
|
-
replyToId: string | null;
|
|
3981
|
-
}[], 20, undefined>]>, undefined>;
|
|
3982
|
-
readonly updatedAt: v.StringSchema<undefined>;
|
|
3983
|
-
/**
|
|
3984
|
-
* Present iff this artifact is owned by git. Absent means Mossbear owns it
|
|
3985
|
-
* and it is editable in the dashboard.
|
|
3986
|
-
*
|
|
3987
|
-
* **Optional, and absence is not yet a verdict.** Nothing writes this before
|
|
3988
|
-
* `publish` ships, so today every item omits it, and the existing bundle-home
|
|
3989
|
-
* rule — a bundle may name one repo as its only writer, and the server
|
|
3990
|
-
* refuses every other writer by name — is what still protects items a repo
|
|
3991
|
-
* already owns. A reader must not treat an absent `gitSource` as permission
|
|
3992
|
-
* to publish back.
|
|
3993
|
-
*
|
|
3994
|
-
* **Optional *and* nullable, like every other late-added column on this item.**
|
|
3995
|
-
* A serializer that maps the columns straight through emits `null` for a
|
|
3996
|
-
* Mossbear-owned row, and a key that only accepted `undefined` would throw on
|
|
3997
|
-
* the whole response rather than on the one item — `parseContextItemsResponse`
|
|
3998
|
-
* parses a pull as a batch. Both spellings read the same way: no git source.
|
|
3999
|
-
*
|
|
4000
|
-
* **`path` is the third required member of the subset and is not re-checked
|
|
4001
|
-
* here.** The database holds that invariant
|
|
4002
|
-
* (`guide_files_git_source_subset`), and a wire rule that looked identical
|
|
4003
|
-
* would in fact be stricter: `path` is serialized through a scope helper that
|
|
4004
|
-
* emits `null` for a path this schema cannot parse, so a single such row would
|
|
4005
|
-
* fail every other item in the same pull. A git-owned item that arrives
|
|
4006
|
-
* without a usable path is a broken item, not a broken response.
|
|
4007
|
-
*/
|
|
4008
|
-
readonly gitSource: v.OptionalSchema<v.NullableSchema<v.ObjectSchema<{
|
|
4009
|
-
/**
|
|
4010
|
-
* The committed `project.id` of the source repository — the same id space as
|
|
4011
|
-
* an item's delivery-scoping `projectId` below, but a different fact: that one
|
|
4012
|
-
* says which repo an item is materialized into and is stamped onto
|
|
4013
|
-
* Mossbear-owned rows too, this one says who may edit it.
|
|
4014
|
-
*/
|
|
4015
|
-
readonly projectId: 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">]>;
|
|
4016
|
-
readonly commitSha: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "commitSha must be 40 or 64 lowercase hex characters">]>;
|
|
4017
|
-
/**
|
|
4018
|
-
* The branch the publishing commit was on. **The one optional member**:
|
|
4019
|
-
* publication is not restricted by branch, so this is recorded so a subscriber
|
|
4020
|
-
* can see what they got, and a detached HEAD has none to record.
|
|
4021
|
-
*/
|
|
4022
|
-
readonly branch: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 255, undefined>]>, undefined>;
|
|
4023
|
-
}, undefined>, undefined>, undefined>;
|
|
4024
|
-
/**
|
|
4025
|
-
* This artifact is a **tombstone**: the repository that publishes it deleted
|
|
4026
|
-
* the file, so what the item still carries is the last revision rather than a
|
|
4027
|
-
* current one (`artifact-ownership-and-delivery-plan.md` → D28).
|
|
4028
|
-
*
|
|
4029
|
-
* **It is still delivered, and that is deliberate.** Dropping the item from
|
|
4030
|
-
* the response would say the same thing more quietly and cost two things
|
|
4031
|
-
* worth more than the byte: the publishing repo would lose the id it needs to
|
|
4032
|
-
* republish the path in place — re-adding a deleted file would create a
|
|
4033
|
-
* second artifact at the same path rather than a new revision of the one
|
|
4034
|
-
* that is there — and a reader would be left unable to tell a removal from
|
|
4035
|
-
* a bundle it has stopped being able to see. What the flag asks of a client
|
|
4036
|
-
* is one thing: do not materialize it. A file left at a discovery root keeps
|
|
4037
|
-
* feeding deleted guidance into every agent that reads that repo, which is
|
|
4038
|
-
* the failure the decision exists to stop.
|
|
4039
|
-
*
|
|
4040
|
-
* **Optional, and absent means an ordinary artifact.** A client that has
|
|
4041
|
-
* never heard of it behaves as it always did — it keeps the last published
|
|
4042
|
-
* revision on disk, which is the retain behaviour this replaces rather than a
|
|
4043
|
-
* new failure. That is what makes the server safe to ship first.
|
|
4044
|
-
*
|
|
4045
|
-
* `literal(true)` rather than a boolean: `removed: false` would be a second
|
|
4046
|
-
* spelling of absence, and an artifact that came back is content again rather
|
|
4047
|
-
* than a tombstone that says no.
|
|
4048
|
-
*/
|
|
4049
|
-
readonly removed: v.OptionalSchema<v.LiteralSchema<true, undefined>, undefined>;
|
|
4050
|
-
}, undefined>, v.TransformAction<{
|
|
4051
|
-
id: string;
|
|
4052
|
-
artifactId?: string | null | undefined;
|
|
4053
|
-
type?: string | undefined;
|
|
4054
|
-
name: string;
|
|
4055
|
-
role: string | null;
|
|
4056
|
-
format: string | null;
|
|
4057
|
-
content: string | null;
|
|
4058
|
-
origin?: string | null | undefined;
|
|
4059
|
-
version?: number | undefined;
|
|
4060
|
-
guideId?: string | null | undefined;
|
|
4061
|
-
root?: "project" | "global" | null | undefined;
|
|
4062
|
-
path?: string | null | undefined;
|
|
4063
|
-
projectId?: string | null | undefined;
|
|
4064
|
-
pathProjectId?: string | null | undefined;
|
|
4065
|
-
aliases?: {
|
|
4066
|
-
root: "project" | "global";
|
|
4067
|
-
path: string;
|
|
4068
|
-
}[] | undefined;
|
|
4069
|
-
comments?: {
|
|
4070
|
-
id: string;
|
|
4071
|
-
state?: "open" | "resolved" | undefined;
|
|
4072
|
-
passage?: {
|
|
4073
|
-
quote: string;
|
|
4074
|
-
status: "located" | "changed" | "orphaned";
|
|
4075
|
-
lines: {
|
|
4076
|
-
start: number;
|
|
4077
|
-
end: number;
|
|
4078
|
-
} | null;
|
|
4079
|
-
} | undefined;
|
|
4080
|
-
body: string;
|
|
4081
|
-
suggestion?: string | undefined;
|
|
4082
|
-
finding?: {
|
|
4083
|
-
tier: "observed" | "usage" | "practice";
|
|
4084
|
-
tierLine: string;
|
|
4085
|
-
blindSpot: string;
|
|
4086
|
-
prediction: string | null;
|
|
4087
|
-
} | undefined;
|
|
4088
|
-
approved?: boolean | undefined;
|
|
4089
|
-
authorName: string | null;
|
|
4090
|
-
createdAt: string;
|
|
4091
|
-
itemVersion: number;
|
|
4092
|
-
itemChangedSince: boolean;
|
|
4093
|
-
deliveredCount: number;
|
|
4094
|
-
threadId: string;
|
|
4095
|
-
replyToId: string | null;
|
|
4096
|
-
}[] | undefined;
|
|
4097
|
-
updatedAt: string;
|
|
4098
|
-
gitSource?: {
|
|
4099
|
-
projectId: string;
|
|
4100
|
-
commitSha: string;
|
|
4101
|
-
branch?: string | undefined;
|
|
4102
|
-
} | null | undefined;
|
|
4103
|
-
removed?: true | undefined;
|
|
4104
|
-
}, {
|
|
4105
|
-
type: string;
|
|
4106
|
-
id: string;
|
|
4107
|
-
artifactId?: string | null | undefined;
|
|
4108
|
-
name: string;
|
|
4109
|
-
role: string | null;
|
|
4110
|
-
format: string | null;
|
|
4111
|
-
content: string | null;
|
|
4112
|
-
origin?: string | null | undefined;
|
|
4113
|
-
version?: number | undefined;
|
|
4114
|
-
guideId?: string | null | undefined;
|
|
4115
|
-
root?: "project" | "global" | null | undefined;
|
|
4116
|
-
path?: string | null | undefined;
|
|
4117
|
-
projectId?: string | null | undefined;
|
|
4118
|
-
pathProjectId?: string | null | undefined;
|
|
4119
|
-
aliases?: {
|
|
4120
|
-
root: "project" | "global";
|
|
4121
|
-
path: string;
|
|
4122
|
-
}[] | undefined;
|
|
4123
|
-
comments?: {
|
|
4124
|
-
id: string;
|
|
4125
|
-
state?: "open" | "resolved" | undefined;
|
|
4126
|
-
passage?: {
|
|
4127
|
-
quote: string;
|
|
4128
|
-
status: "located" | "changed" | "orphaned";
|
|
4129
|
-
lines: {
|
|
4130
|
-
start: number;
|
|
4131
|
-
end: number;
|
|
4132
|
-
} | null;
|
|
4133
|
-
} | undefined;
|
|
4134
|
-
body: string;
|
|
4135
|
-
suggestion?: string | undefined;
|
|
4136
|
-
finding?: {
|
|
4137
|
-
tier: "observed" | "usage" | "practice";
|
|
4138
|
-
tierLine: string;
|
|
4139
|
-
blindSpot: string;
|
|
4140
|
-
prediction: string | null;
|
|
4141
|
-
} | undefined;
|
|
4142
|
-
approved?: boolean | undefined;
|
|
4143
|
-
authorName: string | null;
|
|
4144
|
-
createdAt: string;
|
|
4145
|
-
itemVersion: number;
|
|
4146
|
-
itemChangedSince: boolean;
|
|
4147
|
-
deliveredCount: number;
|
|
4148
|
-
threadId: string;
|
|
4149
|
-
replyToId: string | null;
|
|
4150
|
-
}[] | undefined;
|
|
4151
|
-
updatedAt: string;
|
|
4152
|
-
gitSource?: {
|
|
4153
|
-
projectId: string;
|
|
4154
|
-
commitSha: string;
|
|
4155
|
-
branch?: string | undefined;
|
|
4156
|
-
} | null | undefined;
|
|
4157
|
-
removed?: true | undefined;
|
|
4158
|
-
}>]>;
|
|
4159
|
-
}, undefined>;
|
|
4160
|
-
export declare const ArchiveContextItemResponseSchema: v.ObjectSchema<{
|
|
4161
|
-
readonly archived: v.BooleanSchema<undefined>;
|
|
4162
|
-
readonly item: v.SchemaWithPipe<readonly [v.ObjectSchema<{
|
|
4163
|
-
readonly id: v.StringSchema<undefined>;
|
|
4164
|
-
/**
|
|
4165
|
-
* The id every artifact route addresses: the body file's id for a guide
|
|
4166
|
-
* (null only for a guide with no body yet), the item's own id otherwise.
|
|
4167
|
-
* Optional so a client tolerates a server that predates it, and one that
|
|
4168
|
-
* stops sending it (the item id is the artifact id).
|
|
4169
|
-
*/
|
|
4170
|
-
readonly artifactId: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
|
|
4171
|
-
/**
|
|
4172
|
-
* Leaving the wire: a reader tells a guide from content by `role` and the
|
|
4173
|
-
* guide fields, not by this. Optional so a client parses a server that no
|
|
4174
|
-
* longer sends it.
|
|
4175
|
-
*/
|
|
4176
|
-
readonly type: v.OptionalSchema<v.PicklistSchema<string[], undefined>, undefined>;
|
|
4177
|
-
readonly name: v.StringSchema<undefined>;
|
|
4178
|
-
/**
|
|
4179
|
-
* The stored `(role, format)` pair, as two bare nullable strings.
|
|
4180
|
-
*
|
|
4181
|
-
* **Both are deliberately unenumerated.** A client switches on one value it
|
|
4182
|
-
* cares about — `role === 'criteria'` is how a rubric is told from ordinary
|
|
4183
|
-
* prose, which `type` cannot say because a rubric serializes as a `document` —
|
|
4184
|
-
* and a server that adds a fourth role or a fifth format must not break a
|
|
4185
|
-
* client that has never heard of it. Narrowing them here would make every such
|
|
4186
|
-
* addition a breaking wire change for no reader's benefit.
|
|
4187
|
-
*
|
|
4188
|
-
* Null on exactly the rows that carry no content: a tombstone, and an alias.
|
|
4189
|
-
* A `guide` item has no pair at all — it is a different table — and reports
|
|
4190
|
-
* both as null.
|
|
4191
|
-
*/
|
|
4192
|
-
readonly role: v.NullableSchema<v.StringSchema<undefined>, undefined>;
|
|
4193
|
-
readonly format: v.NullableSchema<v.StringSchema<undefined>, undefined>;
|
|
4194
|
-
readonly content: v.NullableSchema<v.StringSchema<undefined>, undefined>;
|
|
4195
|
-
readonly origin: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
|
|
4196
|
-
readonly version: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
|
|
4197
|
-
/**
|
|
4198
|
-
* The guide a **derived** item belongs to — its evaluation criteria, or a
|
|
4199
|
-
* skill's member files (`subscription-delivery-target-plan.md` → slice 4).
|
|
4200
|
-
*
|
|
4201
|
-
* Absent on everything else, including a guide itself: a guide member is
|
|
4202
|
-
* addressed by the guide's own id, so `id` already answers this for it.
|
|
4203
|
-
*
|
|
4204
|
-
* It exists because derived items have no bundle membership and no id of their
|
|
4205
|
-
* guide's — they are `guide_files` rows attached by `guide_id` — so a rule
|
|
4206
|
-
* expressed over guide ids (a subscriber's mute) cannot reach them from the
|
|
4207
|
-
* item alone. Muting a skill and still delivering its `scripts/` would leave a
|
|
4208
|
-
* broken half-skill on disk, which is worse than not muting at all.
|
|
4209
|
-
*/
|
|
4210
|
-
readonly guideId: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
|
|
4211
|
-
readonly root: v.OptionalSchema<v.NullableSchema<v.PicklistSchema<["project", "global"], undefined>, undefined>, undefined>;
|
|
4212
|
-
readonly path: v.OptionalSchema<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>, undefined>;
|
|
4213
|
-
readonly projectId: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
|
|
4214
|
-
/**
|
|
4215
|
-
* The repo a **document's** declared `path` is placed in — its home — as the
|
|
4216
|
-
* `project.id` of the checkout that last set the path. Documents only.
|
|
4217
|
-
*
|
|
4218
|
-
* Deliberately not `projectId` above: a reader takes a mismatch there as "this
|
|
4219
|
-
* item belongs to another repo, do not materialize it", so a home echoed on it
|
|
4220
|
-
* would stop every other subscriber receiving the document at all. A home says
|
|
4221
|
-
* only *where* the path is literal. Only the repo whose `project.id` matches
|
|
4222
|
-
* writes the document at `path`; every other repo mirrors it under the
|
|
4223
|
-
* bundle folder (`bundleMirrorPath` in `@mossbear/projections`).
|
|
4224
|
-
*
|
|
4225
|
-
* Absent and null read the same — **no home**, so no repo takes the path
|
|
4226
|
-
* literally for a new placement. A server predating the field says the same,
|
|
4227
|
-
* which is the safe direction: the file lands inside the bundle folder
|
|
4228
|
-
* instead of at a repo path it may not belong in.
|
|
4229
|
-
*/
|
|
4230
|
-
readonly pathProjectId: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
|
|
4231
|
-
readonly aliases: v.OptionalSchema<v.SchemaWithPipe<readonly [v.ArraySchema<v.ObjectSchema<{
|
|
4232
|
-
readonly root: v.PicklistSchema<["project", "global"], undefined>;
|
|
4233
|
-
readonly path: 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">]>;
|
|
4234
|
-
}, undefined>, undefined>, v.MaxLengthAction<{
|
|
4235
|
-
root: "project" | "global";
|
|
4236
|
-
path: string;
|
|
4237
|
-
}[], 8, undefined>]>, undefined>;
|
|
4238
|
-
/**
|
|
4239
|
-
* Open comments a person left about this item, newest first.
|
|
4240
|
-
*
|
|
4241
|
-
* Optional, and absent rather than empty when there are none — the same rule
|
|
4242
|
-
* `aliases` and `projectId` follow above, and for the same reason: an older
|
|
4243
|
-
* reader against a newer server ignores the key, and a newer reader against
|
|
4244
|
-
* an older server reads "no comments" instead of failing.
|
|
4245
|
-
*
|
|
4246
|
-
* **Absence is not a verdict.** No comments here means none were served on this
|
|
4247
|
-
* item in this response — not that nobody has anything to say about it.
|
|
4248
|
-
*/
|
|
4249
|
-
readonly comments: v.OptionalSchema<v.SchemaWithPipe<readonly [v.ArraySchema<v.ObjectSchema<{
|
|
4250
|
-
readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
4251
|
-
readonly state: v.OptionalSchema<v.PicklistSchema<["open", "resolved"], undefined>, undefined>;
|
|
4252
|
-
/** Current source location of an anchored passage, or its lost quote. */
|
|
4253
|
-
readonly passage: v.OptionalSchema<v.ObjectSchema<{
|
|
4254
|
-
readonly quote: v.StringSchema<undefined>;
|
|
4255
|
-
readonly status: v.PicklistSchema<["located", "changed", "orphaned"], undefined>;
|
|
4256
|
-
readonly lines: v.NullableSchema<v.ObjectSchema<{
|
|
4257
|
-
readonly start: v.NumberSchema<undefined>;
|
|
4258
|
-
readonly end: v.NumberSchema<undefined>;
|
|
4259
|
-
}, undefined>, undefined>;
|
|
4260
|
-
}, undefined>, undefined>;
|
|
4261
|
-
/** The comment's text, already wrapped in the response's untrusted markers. */
|
|
4262
|
-
readonly body: v.StringSchema<undefined>;
|
|
4263
|
-
/**
|
|
4264
|
-
* A suggested edit: the replacement for the passage at `passage.lines`,
|
|
4265
|
-
* already wrapped in the response's untrusted markers like `body`. An
|
|
4266
|
-
* insertion is the passage plus its new lines and an empty replacement is a
|
|
4267
|
-
* deletion, so every edit is one replace. Absent on an ordinary comment.
|
|
4268
|
-
*/
|
|
4269
|
-
readonly suggestion: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
|
|
4270
|
-
/**
|
|
4271
|
-
* What a comment Mossbear wrote is: a finding about the item, never an edit.
|
|
4272
|
-
* Present only on a Mossbear comment. The comment's `body` begins with the
|
|
4273
|
-
* claim (what goes wrong); this carries what the claim rests on.
|
|
4274
|
-
*/
|
|
4275
|
-
readonly finding: v.OptionalSchema<v.ObjectSchema<{
|
|
4276
|
-
readonly tier: v.PicklistSchema<["observed", "usage", "practice"], undefined>;
|
|
4277
|
-
/** How the finding is known, in one line: "Seen in 3 sessions (2026-09-15 – 2026-10-03)". */
|
|
4278
|
-
readonly tierLine: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 300, undefined>]>;
|
|
4279
|
-
/** What the drafter did not read, fixed per tier. */
|
|
4280
|
-
readonly blindSpot: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 300, undefined>]>;
|
|
4281
|
-
/** What should change in later sessions if the finding is fixed, wrapped in the untrusted markers. */
|
|
4282
|
-
readonly prediction: v.NullableSchema<v.StringSchema<undefined>, undefined>;
|
|
4283
|
-
}, undefined>, undefined>;
|
|
4284
|
-
/**
|
|
4285
|
-
* Whether the person approved a comment Mossbear drafted. Present on every
|
|
4286
|
-
* Mossbear comment and absent on a person's or an agent's, which are
|
|
4287
|
-
* requests as written. `false` is a draft nobody has read yet: a reader shows
|
|
4288
|
-
* it to the user and acts only on their go-ahead. Only a client that reports
|
|
4289
|
-
* a version able to mark drafts is ever listed one, so an older reader that
|
|
4290
|
-
* strips this field never receives a draft it would print as a request.
|
|
4291
|
-
*/
|
|
4292
|
-
readonly approved: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
|
|
4293
|
-
/** The author's display name as the workspace shows it, or null. Never an email. */
|
|
4294
|
-
readonly authorName: v.NullableSchema<v.StringSchema<undefined>, undefined>;
|
|
4295
|
-
/** ISO timestamp, machine format. */
|
|
4296
|
-
readonly createdAt: v.StringSchema<undefined>;
|
|
4297
|
-
/** The item's content version the comment was written against. */
|
|
4298
|
-
readonly itemVersion: v.NumberSchema<undefined>;
|
|
4299
|
-
/** True when the item's current version is greater than `itemVersion`. */
|
|
4300
|
-
readonly itemChangedSince: v.BooleanSchema<undefined>;
|
|
4301
|
-
/**
|
|
4302
|
-
* How many agent reads were handed this comment **before** this one — so a
|
|
4303
|
-
* comment reaching an agent for the first time reports `0`.
|
|
4304
|
-
*
|
|
4305
|
-
* It is the stored count as it read at the moment the response was built;
|
|
4306
|
-
* the serve this response *is* has not been counted yet. Excluded rather
|
|
4307
|
-
* than included because the count is recorded best-effort: a response that
|
|
4308
|
-
* claimed to include itself would be wrong whenever that record failed, and
|
|
4309
|
-
* a number that is sometimes off by one is worse than one that is
|
|
4310
|
-
* consistently the prior total.
|
|
4311
|
-
*
|
|
4312
|
-
* So `deliveredCount > 0` means an earlier read was handed this comment, and
|
|
4313
|
-
* `0` means this read is the first. Neither says a model took it in — only
|
|
4314
|
-
* that the server handed it over.
|
|
4315
|
-
*/
|
|
4316
|
-
readonly deliveredCount: v.NumberSchema<undefined>;
|
|
4317
|
-
/**
|
|
4318
|
-
* This comment's thread root — its own id for every delivered root. Resolution
|
|
4319
|
-
* replies remain on the dashboard thread and are not delivered to agents.
|
|
4320
|
-
* It is on the wire from the first response
|
|
4321
|
-
* because the wire contract is consumed by installed CLI versions: reshaping
|
|
4322
|
-
* a flat `comments` array into threads-of-comments later would be a breaking
|
|
4323
|
-
* change, while a field today's readers ignore costs them nothing.
|
|
4324
|
-
*/
|
|
4325
|
-
readonly threadId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
4326
|
-
/**
|
|
4327
|
-
* Always `null` for a delivered root. Present so an older reader meeting a
|
|
4328
|
-
* future response that carries real replies degrades to
|
|
4329
|
-
* "a flat list of comments" rather than failing to parse.
|
|
4330
|
-
*/
|
|
4331
|
-
readonly replyToId: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>;
|
|
4332
|
-
}, undefined>, undefined>, v.MaxLengthAction<{
|
|
4333
|
-
id: string;
|
|
4334
|
-
state?: "open" | "resolved" | undefined;
|
|
4335
|
-
passage?: {
|
|
4336
|
-
quote: string;
|
|
4337
|
-
status: "located" | "changed" | "orphaned";
|
|
4338
|
-
lines: {
|
|
4339
|
-
start: number;
|
|
4340
|
-
end: number;
|
|
4341
|
-
} | null;
|
|
4342
|
-
} | undefined;
|
|
4343
|
-
body: string;
|
|
4344
|
-
suggestion?: string | undefined;
|
|
4345
|
-
finding?: {
|
|
4346
|
-
tier: "observed" | "usage" | "practice";
|
|
4347
|
-
tierLine: string;
|
|
4348
|
-
blindSpot: string;
|
|
4349
|
-
prediction: string | null;
|
|
4350
|
-
} | undefined;
|
|
4351
|
-
approved?: boolean | undefined;
|
|
4352
|
-
authorName: string | null;
|
|
4353
|
-
createdAt: string;
|
|
4354
|
-
itemVersion: number;
|
|
4355
|
-
itemChangedSince: boolean;
|
|
4356
|
-
deliveredCount: number;
|
|
4357
|
-
threadId: string;
|
|
4358
|
-
replyToId: string | null;
|
|
4359
|
-
}[], 20, undefined>]>, undefined>;
|
|
4360
|
-
readonly updatedAt: v.StringSchema<undefined>;
|
|
4361
|
-
/**
|
|
4362
|
-
* Present iff this artifact is owned by git. Absent means Mossbear owns it
|
|
4363
|
-
* and it is editable in the dashboard.
|
|
4364
|
-
*
|
|
4365
|
-
* **Optional, and absence is not yet a verdict.** Nothing writes this before
|
|
4366
|
-
* `publish` ships, so today every item omits it, and the existing bundle-home
|
|
4367
|
-
* rule — a bundle may name one repo as its only writer, and the server
|
|
4368
|
-
* refuses every other writer by name — is what still protects items a repo
|
|
4369
|
-
* already owns. A reader must not treat an absent `gitSource` as permission
|
|
4370
|
-
* to publish back.
|
|
4371
|
-
*
|
|
4372
|
-
* **Optional *and* nullable, like every other late-added column on this item.**
|
|
4373
|
-
* A serializer that maps the columns straight through emits `null` for a
|
|
4374
|
-
* Mossbear-owned row, and a key that only accepted `undefined` would throw on
|
|
4375
|
-
* the whole response rather than on the one item — `parseContextItemsResponse`
|
|
4376
|
-
* parses a pull as a batch. Both spellings read the same way: no git source.
|
|
4377
|
-
*
|
|
4378
|
-
* **`path` is the third required member of the subset and is not re-checked
|
|
4379
|
-
* here.** The database holds that invariant
|
|
4380
|
-
* (`guide_files_git_source_subset`), and a wire rule that looked identical
|
|
4381
|
-
* would in fact be stricter: `path` is serialized through a scope helper that
|
|
4382
|
-
* emits `null` for a path this schema cannot parse, so a single such row would
|
|
4383
|
-
* fail every other item in the same pull. A git-owned item that arrives
|
|
4384
|
-
* without a usable path is a broken item, not a broken response.
|
|
4385
|
-
*/
|
|
4386
|
-
readonly gitSource: v.OptionalSchema<v.NullableSchema<v.ObjectSchema<{
|
|
4387
|
-
/**
|
|
4388
|
-
* The committed `project.id` of the source repository — the same id space as
|
|
4389
|
-
* an item's delivery-scoping `projectId` below, but a different fact: that one
|
|
4390
|
-
* says which repo an item is materialized into and is stamped onto
|
|
4391
|
-
* Mossbear-owned rows too, this one says who may edit it.
|
|
4392
|
-
*/
|
|
4393
|
-
readonly projectId: 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">]>;
|
|
4394
|
-
readonly commitSha: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "commitSha must be 40 or 64 lowercase hex characters">]>;
|
|
4395
|
-
/**
|
|
4396
|
-
* The branch the publishing commit was on. **The one optional member**:
|
|
4397
|
-
* publication is not restricted by branch, so this is recorded so a subscriber
|
|
4398
|
-
* can see what they got, and a detached HEAD has none to record.
|
|
4399
|
-
*/
|
|
4400
|
-
readonly branch: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 255, undefined>]>, undefined>;
|
|
4401
|
-
}, undefined>, undefined>, undefined>;
|
|
4402
|
-
/**
|
|
4403
|
-
* This artifact is a **tombstone**: the repository that publishes it deleted
|
|
4404
|
-
* the file, so what the item still carries is the last revision rather than a
|
|
4405
|
-
* current one (`artifact-ownership-and-delivery-plan.md` → D28).
|
|
4406
|
-
*
|
|
4407
|
-
* **It is still delivered, and that is deliberate.** Dropping the item from
|
|
4408
|
-
* the response would say the same thing more quietly and cost two things
|
|
4409
|
-
* worth more than the byte: the publishing repo would lose the id it needs to
|
|
4410
|
-
* republish the path in place — re-adding a deleted file would create a
|
|
4411
|
-
* second artifact at the same path rather than a new revision of the one
|
|
4412
|
-
* that is there — and a reader would be left unable to tell a removal from
|
|
4413
|
-
* a bundle it has stopped being able to see. What the flag asks of a client
|
|
4414
|
-
* is one thing: do not materialize it. A file left at a discovery root keeps
|
|
4415
|
-
* feeding deleted guidance into every agent that reads that repo, which is
|
|
4416
|
-
* the failure the decision exists to stop.
|
|
4417
|
-
*
|
|
4418
|
-
* **Optional, and absent means an ordinary artifact.** A client that has
|
|
4419
|
-
* never heard of it behaves as it always did — it keeps the last published
|
|
4420
|
-
* revision on disk, which is the retain behaviour this replaces rather than a
|
|
4421
|
-
* new failure. That is what makes the server safe to ship first.
|
|
4422
|
-
*
|
|
4423
|
-
* `literal(true)` rather than a boolean: `removed: false` would be a second
|
|
4424
|
-
* spelling of absence, and an artifact that came back is content again rather
|
|
4425
|
-
* than a tombstone that says no.
|
|
4426
|
-
*/
|
|
4427
|
-
readonly removed: v.OptionalSchema<v.LiteralSchema<true, undefined>, undefined>;
|
|
4428
|
-
}, undefined>, v.TransformAction<{
|
|
4429
|
-
id: string;
|
|
4430
|
-
artifactId?: string | null | undefined;
|
|
4431
|
-
type?: string | undefined;
|
|
4432
|
-
name: string;
|
|
4433
|
-
role: string | null;
|
|
4434
|
-
format: string | null;
|
|
4435
|
-
content: string | null;
|
|
4436
|
-
origin?: string | null | undefined;
|
|
4437
|
-
version?: number | undefined;
|
|
4438
|
-
guideId?: string | null | undefined;
|
|
4439
|
-
root?: "project" | "global" | null | undefined;
|
|
4440
|
-
path?: string | null | undefined;
|
|
4441
|
-
projectId?: string | null | undefined;
|
|
4442
|
-
pathProjectId?: string | null | undefined;
|
|
4443
|
-
aliases?: {
|
|
4444
|
-
root: "project" | "global";
|
|
4445
|
-
path: string;
|
|
4446
|
-
}[] | undefined;
|
|
4447
|
-
comments?: {
|
|
4448
|
-
id: string;
|
|
4449
|
-
state?: "open" | "resolved" | undefined;
|
|
4450
|
-
passage?: {
|
|
4451
|
-
quote: string;
|
|
4452
|
-
status: "located" | "changed" | "orphaned";
|
|
4453
|
-
lines: {
|
|
4454
|
-
start: number;
|
|
4455
|
-
end: number;
|
|
4456
|
-
} | null;
|
|
4457
|
-
} | undefined;
|
|
4458
|
-
body: string;
|
|
4459
|
-
suggestion?: string | undefined;
|
|
4460
|
-
finding?: {
|
|
4461
|
-
tier: "observed" | "usage" | "practice";
|
|
4462
|
-
tierLine: string;
|
|
4463
|
-
blindSpot: string;
|
|
4464
|
-
prediction: string | null;
|
|
4465
|
-
} | undefined;
|
|
4466
|
-
approved?: boolean | undefined;
|
|
4467
|
-
authorName: string | null;
|
|
4468
|
-
createdAt: string;
|
|
4469
|
-
itemVersion: number;
|
|
4470
|
-
itemChangedSince: boolean;
|
|
4471
|
-
deliveredCount: number;
|
|
4472
|
-
threadId: string;
|
|
4473
|
-
replyToId: string | null;
|
|
4474
|
-
}[] | undefined;
|
|
4475
|
-
updatedAt: string;
|
|
4476
|
-
gitSource?: {
|
|
4477
|
-
projectId: string;
|
|
4478
|
-
commitSha: string;
|
|
4479
|
-
branch?: string | undefined;
|
|
4480
|
-
} | null | undefined;
|
|
4481
|
-
removed?: true | undefined;
|
|
4482
|
-
}, {
|
|
4483
|
-
type: string;
|
|
4484
|
-
id: string;
|
|
4485
|
-
artifactId?: string | null | undefined;
|
|
4486
|
-
name: string;
|
|
4487
|
-
role: string | null;
|
|
4488
|
-
format: string | null;
|
|
4489
|
-
content: string | null;
|
|
4490
|
-
origin?: string | null | undefined;
|
|
4491
|
-
version?: number | undefined;
|
|
4492
|
-
guideId?: string | null | undefined;
|
|
4493
|
-
root?: "project" | "global" | null | undefined;
|
|
4494
|
-
path?: string | null | undefined;
|
|
4495
|
-
projectId?: string | null | undefined;
|
|
4496
|
-
pathProjectId?: string | null | undefined;
|
|
4497
|
-
aliases?: {
|
|
4498
|
-
root: "project" | "global";
|
|
4499
|
-
path: string;
|
|
4500
|
-
}[] | undefined;
|
|
4501
|
-
comments?: {
|
|
4502
|
-
id: string;
|
|
4503
|
-
state?: "open" | "resolved" | undefined;
|
|
4504
|
-
passage?: {
|
|
4505
|
-
quote: string;
|
|
4506
|
-
status: "located" | "changed" | "orphaned";
|
|
4507
|
-
lines: {
|
|
4508
|
-
start: number;
|
|
4509
|
-
end: number;
|
|
4510
|
-
} | null;
|
|
4511
|
-
} | undefined;
|
|
4512
|
-
body: string;
|
|
4513
|
-
suggestion?: string | undefined;
|
|
4514
|
-
finding?: {
|
|
4515
|
-
tier: "observed" | "usage" | "practice";
|
|
4516
|
-
tierLine: string;
|
|
4517
|
-
blindSpot: string;
|
|
4518
|
-
prediction: string | null;
|
|
4519
|
-
} | undefined;
|
|
4520
|
-
approved?: boolean | undefined;
|
|
4521
|
-
authorName: string | null;
|
|
4522
|
-
createdAt: string;
|
|
4523
|
-
itemVersion: number;
|
|
4524
|
-
itemChangedSince: boolean;
|
|
4525
|
-
deliveredCount: number;
|
|
4526
|
-
threadId: string;
|
|
4527
|
-
replyToId: string | null;
|
|
4528
|
-
}[] | undefined;
|
|
4529
|
-
updatedAt: string;
|
|
4530
|
-
gitSource?: {
|
|
4531
|
-
projectId: string;
|
|
4532
|
-
commitSha: string;
|
|
4533
|
-
branch?: string | undefined;
|
|
4534
|
-
} | null | undefined;
|
|
4535
|
-
removed?: true | undefined;
|
|
4536
|
-
}>]>;
|
|
2882
|
+
}, undefined>;
|
|
2883
|
+
readonly rubricVersion: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>]>;
|
|
2884
|
+
readonly practices: v.OptionalSchema<v.ArraySchema<v.ObjectSchema<{
|
|
2885
|
+
readonly text: v.StringSchema<undefined>;
|
|
2886
|
+
readonly source: v.ObjectSchema<{
|
|
2887
|
+
readonly title: v.StringSchema<undefined>;
|
|
2888
|
+
readonly url: v.StringSchema<undefined>;
|
|
2889
|
+
}, undefined>;
|
|
2890
|
+
}, undefined>, undefined>, readonly []>;
|
|
2891
|
+
readonly facts: v.OptionalSchema<v.ArraySchema<v.StringSchema<undefined>, undefined>, readonly []>;
|
|
2892
|
+
readonly answers: v.OptionalSchema<v.ArraySchema<v.ObjectSchema<{
|
|
2893
|
+
readonly item: v.StringSchema<undefined>;
|
|
2894
|
+
readonly answer: v.StringSchema<undefined>;
|
|
2895
|
+
}, undefined>, undefined>, readonly []>;
|
|
2896
|
+
}, undefined>;
|
|
2897
|
+
/**
|
|
2898
|
+
* A comment the person (or Mossbear) left on one of the sessions a finding
|
|
2899
|
+
* cites — the person's own account of what the agent should have known, set
|
|
2900
|
+
* beside the grader's excerpt (`guide-findings-plan.md` → Your note on a
|
|
2901
|
+
* session).
|
|
2902
|
+
*
|
|
2903
|
+
* **Reachable only here.** A comment about a session is never listed by
|
|
2904
|
+
* `list_comments` or announced at session start: it is context for a finding,
|
|
2905
|
+
* found by following the finding's citation, not a request.
|
|
2906
|
+
*/
|
|
2907
|
+
export declare const CommentEvidenceSessionCommentSchema: v.ObjectSchema<{
|
|
2908
|
+
readonly sessionId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
2909
|
+
/** Only the person's own notes are sent today; `mossbear` is reserved. */
|
|
2910
|
+
readonly authorKind: v.PicklistSchema<["person", "mossbear"], undefined>;
|
|
2911
|
+
/** ISO, when the comment was written. */
|
|
2912
|
+
readonly at: v.StringSchema<undefined>;
|
|
2913
|
+
/** Wrapped in the response's untrusted markers. */
|
|
2914
|
+
readonly body: v.StringSchema<undefined>;
|
|
2915
|
+
}, undefined>;
|
|
2916
|
+
export type CommentEvidenceSessionComment = v.InferOutput<typeof CommentEvidenceSessionCommentSchema>;
|
|
2917
|
+
export declare const CommentEvidenceResponseSchema: v.ObjectSchema<{
|
|
2918
|
+
/** The comment's full id, even when the request named a prefix. */
|
|
2919
|
+
readonly commentId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
2920
|
+
readonly itemName: v.StringSchema<undefined>;
|
|
2921
|
+
readonly itemPath: v.NullableSchema<v.StringSchema<undefined>, undefined>;
|
|
2922
|
+
readonly tier: v.PicklistSchema<["observed", "usage", "practice"], undefined>;
|
|
2923
|
+
/** One line saying how the finding is known; server-written, outside the markers. */
|
|
2924
|
+
readonly tierLine: v.StringSchema<undefined>;
|
|
2925
|
+
/** What the drafter did not read; server-written, outside the markers. */
|
|
2926
|
+
readonly blindSpot: v.StringSchema<undefined>;
|
|
2927
|
+
/** What goes wrong, wrapped in the response's untrusted markers. */
|
|
2928
|
+
readonly claim: v.StringSchema<undefined>;
|
|
2929
|
+
/** What future sessions should show if the finding is fixed, wrapped; null if none. */
|
|
2930
|
+
readonly prediction: v.NullableSchema<v.StringSchema<undefined>, undefined>;
|
|
2931
|
+
/** A usage finding's counts; null on every other tier. */
|
|
2932
|
+
readonly usage: v.NullableSchema<v.ObjectSchema<{
|
|
2933
|
+
/** The reference's skill-relative path, wrapped in the response's untrusted markers. */
|
|
2934
|
+
readonly path: v.StringSchema<undefined>;
|
|
2935
|
+
/** Eligible loads of the skill. */
|
|
2936
|
+
readonly loads: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>]>;
|
|
2937
|
+
/** Distinct sessions those loads span. */
|
|
2938
|
+
readonly sessions: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>]>;
|
|
2939
|
+
/** Loads followed by a successful read of the reference. */
|
|
2940
|
+
readonly loadsWithRead: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>]>;
|
|
2941
|
+
}, undefined>, undefined>;
|
|
2942
|
+
/** A practice finding's rubric check; null on every other tier. */
|
|
2943
|
+
readonly practice: v.NullableSchema<v.ObjectSchema<{
|
|
2944
|
+
readonly check: v.ObjectSchema<{
|
|
2945
|
+
readonly id: v.StringSchema<undefined>;
|
|
2946
|
+
readonly name: v.StringSchema<undefined>;
|
|
2947
|
+
}, undefined>;
|
|
2948
|
+
readonly rubricVersion: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>]>;
|
|
2949
|
+
readonly practices: v.OptionalSchema<v.ArraySchema<v.ObjectSchema<{
|
|
2950
|
+
readonly text: v.StringSchema<undefined>;
|
|
2951
|
+
readonly source: v.ObjectSchema<{
|
|
2952
|
+
readonly title: v.StringSchema<undefined>;
|
|
2953
|
+
readonly url: v.StringSchema<undefined>;
|
|
2954
|
+
}, undefined>;
|
|
2955
|
+
}, undefined>, undefined>, readonly []>;
|
|
2956
|
+
readonly facts: v.OptionalSchema<v.ArraySchema<v.StringSchema<undefined>, undefined>, readonly []>;
|
|
2957
|
+
readonly answers: v.OptionalSchema<v.ArraySchema<v.ObjectSchema<{
|
|
2958
|
+
readonly item: v.StringSchema<undefined>;
|
|
2959
|
+
readonly answer: v.StringSchema<undefined>;
|
|
2960
|
+
}, undefined>, undefined>, readonly []>;
|
|
2961
|
+
}, undefined>, undefined>;
|
|
2962
|
+
readonly citations: v.ArraySchema<v.ObjectSchema<{
|
|
2963
|
+
/**
|
|
2964
|
+
* `navigation` is a skill load counted when a finding was drafted from how
|
|
2965
|
+
* the skill's files were read: evidence of how a skill was used, not of a
|
|
2966
|
+
* failure. `action` is a recorded step of a workflow repeated across
|
|
2967
|
+
* sessions. A server sends it only to a client that names a version new
|
|
2968
|
+
* enough to parse it.
|
|
2969
|
+
*/
|
|
2970
|
+
readonly kind: v.PicklistSchema<["verdict", "turn", "navigation", "action"], undefined>;
|
|
2971
|
+
readonly sessionId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
2972
|
+
/** ISO, when the verdict was graded, the turn was said, the skill loaded, or the action was recorded. */
|
|
2973
|
+
readonly at: v.StringSchema<undefined>;
|
|
2974
|
+
/** Wrapped in the response's untrusted markers. */
|
|
2975
|
+
readonly excerpt: v.StringSchema<undefined>;
|
|
2976
|
+
}, undefined>, undefined>;
|
|
2977
|
+
readonly citationsWithheld: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>]>;
|
|
2978
|
+
/**
|
|
2979
|
+
* Comments on the cited sessions, newest first, wrapped in the untrusted
|
|
2980
|
+
* markers. Defaulted so a response from a server that predates the field
|
|
2981
|
+
* still parses.
|
|
2982
|
+
*/
|
|
2983
|
+
readonly sessionComments: v.OptionalSchema<v.ArraySchema<v.ObjectSchema<{
|
|
2984
|
+
readonly sessionId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
2985
|
+
/** Only the person's own notes are sent today; `mossbear` is reserved. */
|
|
2986
|
+
readonly authorKind: v.PicklistSchema<["person", "mossbear"], undefined>;
|
|
2987
|
+
/** ISO, when the comment was written. */
|
|
2988
|
+
readonly at: v.StringSchema<undefined>;
|
|
2989
|
+
/** Wrapped in the response's untrusted markers. */
|
|
2990
|
+
readonly body: v.StringSchema<undefined>;
|
|
2991
|
+
}, undefined>, undefined>, readonly []>;
|
|
2992
|
+
/**
|
|
2993
|
+
* Comments on the cited sessions that were left out to keep the response
|
|
2994
|
+
* bounded (the newest few per session are sent), so a short list is never
|
|
2995
|
+
* mistaken for the whole of it. Zero when none were.
|
|
2996
|
+
*/
|
|
2997
|
+
readonly sessionCommentsWithheld: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>]>, 0>;
|
|
2998
|
+
readonly untrusted: v.ObjectSchema<{
|
|
2999
|
+
readonly token: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
3000
|
+
readonly startMarker: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
3001
|
+
readonly endMarker: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
3002
|
+
readonly note: v.StringSchema<undefined>;
|
|
3003
|
+
}, undefined>;
|
|
4537
3004
|
}, undefined>;
|
|
3005
|
+
export type CommentEvidenceResponse = v.InferOutput<typeof CommentEvidenceResponseSchema>;
|
|
4538
3006
|
export declare const CaptureIdSchema: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 8, "id must be at least 8 characters">, v.MaxLengthAction<string, 128, undefined>, v.RegexAction<string, "id must contain only letters, digits, underscore, dot or hyphen">]>;
|
|
4539
3007
|
export declare const InboxCaptureRequestSchema: v.ObjectSchema<{
|
|
4540
3008
|
/**
|
|
@@ -4626,24 +3094,7 @@ export declare const ArtifactVersionDetailSchema: v.ObjectSchema<{
|
|
|
4626
3094
|
readonly createdAt: v.StringSchema<undefined>;
|
|
4627
3095
|
}, undefined>;
|
|
4628
3096
|
/** The item routes' names for the version schemas, kept while those routes are served. */
|
|
4629
|
-
export declare const
|
|
4630
|
-
readonly id: v.StringSchema<undefined>;
|
|
4631
|
-
readonly version: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>;
|
|
4632
|
-
readonly contentHash: v.StringSchema<undefined>;
|
|
4633
|
-
readonly authorType: v.StringSchema<undefined>;
|
|
4634
|
-
readonly metadata: v.OptionalSchema<v.NullableSchema<v.RecordSchema<v.StringSchema<undefined>, v.UnknownSchema, undefined>, undefined>, undefined>;
|
|
4635
|
-
readonly createdAt: v.StringSchema<undefined>;
|
|
4636
|
-
}, undefined>;
|
|
4637
|
-
export declare const ContextItemVersionDetailSchema: v.ObjectSchema<{
|
|
4638
|
-
readonly id: v.StringSchema<undefined>;
|
|
4639
|
-
readonly version: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>;
|
|
4640
|
-
readonly content: v.NullableSchema<v.StringSchema<undefined>, undefined>;
|
|
4641
|
-
readonly contentHash: v.StringSchema<undefined>;
|
|
4642
|
-
readonly authorType: v.StringSchema<undefined>;
|
|
4643
|
-
readonly metadata: v.OptionalSchema<v.NullableSchema<v.RecordSchema<v.StringSchema<undefined>, v.UnknownSchema, undefined>, undefined>, undefined>;
|
|
4644
|
-
readonly createdAt: v.StringSchema<undefined>;
|
|
4645
|
-
}, undefined>;
|
|
4646
|
-
export declare const ContextItemVersionsResponseSchema: v.ObjectSchema<{
|
|
3097
|
+
export declare const BundleArtifactVersionsResponseSchema: v.ObjectSchema<{
|
|
4647
3098
|
readonly versions: v.ArraySchema<v.ObjectSchema<{
|
|
4648
3099
|
readonly id: v.StringSchema<undefined>;
|
|
4649
3100
|
readonly version: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>;
|
|
@@ -4654,17 +3105,6 @@ export declare const ContextItemVersionsResponseSchema: v.ObjectSchema<{
|
|
|
4654
3105
|
}, undefined>, undefined>;
|
|
4655
3106
|
readonly nextCursor: v.NullableSchema<v.NumberSchema<undefined>, undefined>;
|
|
4656
3107
|
}, undefined>;
|
|
4657
|
-
export declare const ContextItemVersionResponseSchema: v.ObjectSchema<{
|
|
4658
|
-
readonly version: v.ObjectSchema<{
|
|
4659
|
-
readonly id: v.StringSchema<undefined>;
|
|
4660
|
-
readonly version: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>;
|
|
4661
|
-
readonly content: v.NullableSchema<v.StringSchema<undefined>, undefined>;
|
|
4662
|
-
readonly contentHash: v.StringSchema<undefined>;
|
|
4663
|
-
readonly authorType: v.StringSchema<undefined>;
|
|
4664
|
-
readonly metadata: v.OptionalSchema<v.NullableSchema<v.RecordSchema<v.StringSchema<undefined>, v.UnknownSchema, undefined>, undefined>, undefined>;
|
|
4665
|
-
readonly createdAt: v.StringSchema<undefined>;
|
|
4666
|
-
}, undefined>;
|
|
4667
|
-
}, undefined>;
|
|
4668
3108
|
/** Default and max page size for the version-history list endpoint. */
|
|
4669
3109
|
export declare const DEFAULT_VERSIONS_LIMIT = 50;
|
|
4670
3110
|
export declare const MAX_VERSIONS_LIMIT = 200;
|
|
@@ -5008,7 +3448,7 @@ export declare const CreateArtifactRequestSchema: v.StrictObjectSchema<{
|
|
|
5008
3448
|
/** Defaults to markdown. Creation is always `role: 'content'`. */
|
|
5009
3449
|
readonly format: v.OptionalSchema<v.PicklistSchema<("markdown" | "binary")[], undefined>, undefined>;
|
|
5010
3450
|
/** Destination bundle slug. */
|
|
5011
|
-
readonly bundle: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.
|
|
3451
|
+
readonly bundle: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.CheckAction<string, "slug must be lowercase alphanumeric with hyphens, at most 64 characters">]>, undefined>;
|
|
5012
3452
|
readonly origin: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
|
|
5013
3453
|
/** Sources pinned on the first revision. */
|
|
5014
3454
|
readonly sources: v.OptionalSchema<v.SchemaWithPipe<readonly [v.ArraySchema<v.SchemaWithPipe<readonly [v.ObjectSchema<{
|
|
@@ -5187,6 +3627,15 @@ export declare const RemoveArtifactRequestSchema: v.StrictObjectSchema<{
|
|
|
5187
3627
|
*/
|
|
5188
3628
|
readonly projectId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>]>;
|
|
5189
3629
|
readonly expectedVersion: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>, undefined>;
|
|
3630
|
+
/**
|
|
3631
|
+
* The one bundle this removal is for — a withdrawal, where a declaration
|
|
3632
|
+
* stopped covering the path for that bundle while the file is still there.
|
|
3633
|
+
* A tombstone stops delivery everywhere, so the server refuses with a 409
|
|
3634
|
+
* tagged `shared-artifact` when the artifact belongs to any other bundle,
|
|
3635
|
+
* checked under the same lock an attach takes. Absent for a committed
|
|
3636
|
+
* deletion, which removes the artifact from every bundle.
|
|
3637
|
+
*/
|
|
3638
|
+
readonly onlyMemberOf: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 128, undefined>]>, undefined>;
|
|
5190
3639
|
}, undefined>;
|
|
5191
3640
|
/** Archive an artifact. The body is optional; `projectId` is the same checkout claim as on update. */
|
|
5192
3641
|
export declare const ArchiveArtifactRequestSchema: v.StrictObjectSchema<{
|
|
@@ -7788,8 +6237,8 @@ export declare const SessionGradeRequestSchema: v.SchemaWithPipe<readonly [v.Obj
|
|
|
7788
6237
|
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>;
|
|
7789
6238
|
/**
|
|
7790
6239
|
* Opt in to the session digest: the grade plus the turns, self-report and
|
|
7791
|
-
* git position of the session. Omitted, the small grade payload
|
|
7792
|
-
*
|
|
6240
|
+
* git position of the session. Omitted, the small grade payload is
|
|
6241
|
+
* returned unchanged.
|
|
7793
6242
|
*/
|
|
7794
6243
|
readonly detail: v.OptionalSchema<v.LiteralSchema<"digest", undefined>, undefined>;
|
|
7795
6244
|
}, undefined>, v.CheckAction<{
|
|
@@ -7825,13 +6274,14 @@ export type SessionGradeState = v.InferOutput<typeof SessionGradeStateSchema>;
|
|
|
7825
6274
|
* session never engaged. It is not `unguided`, which is an action-level word,
|
|
7826
6275
|
* and neither is ever restated in terms of the other.
|
|
7827
6276
|
*/
|
|
7828
|
-
export declare const
|
|
6277
|
+
export declare const SESSION_GUIDE_VERDICTS: readonly ["aligned", "misaligned", "not_applicable"];
|
|
6278
|
+
export declare const SessionGuideVerdictValueSchema: v.PicklistSchema<readonly ["aligned", "misaligned", "not_applicable"], undefined>;
|
|
7829
6279
|
export type SessionGuideVerdictValue = v.InferOutput<typeof SessionGuideVerdictValueSchema>;
|
|
7830
6280
|
/** One guide's verdict for the run, with the grader's reasoning wrapped. */
|
|
7831
6281
|
export declare const SessionGradeGuideSchema: v.ObjectSchema<{
|
|
7832
6282
|
readonly guideId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
7833
6283
|
readonly title: v.StringSchema<undefined>;
|
|
7834
|
-
readonly verdict: v.PicklistSchema<["aligned", "misaligned", "not_applicable"], undefined>;
|
|
6284
|
+
readonly verdict: v.PicklistSchema<readonly ["aligned", "misaligned", "not_applicable"], undefined>;
|
|
7835
6285
|
/**
|
|
7836
6286
|
* The grader's reasoning, **already wrapped in the response's untrusted
|
|
7837
6287
|
* markers** — model-authored text derived from a transcript, delimited at the
|
|
@@ -7858,7 +6308,7 @@ export declare const SessionGradeSchema: v.ObjectSchema<{
|
|
|
7858
6308
|
readonly guides: v.ArraySchema<v.ObjectSchema<{
|
|
7859
6309
|
readonly guideId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
7860
6310
|
readonly title: v.StringSchema<undefined>;
|
|
7861
|
-
readonly verdict: v.PicklistSchema<["aligned", "misaligned", "not_applicable"], undefined>;
|
|
6311
|
+
readonly verdict: v.PicklistSchema<readonly ["aligned", "misaligned", "not_applicable"], undefined>;
|
|
7862
6312
|
/**
|
|
7863
6313
|
* The grader's reasoning, **already wrapped in the response's untrusted
|
|
7864
6314
|
* markers** — model-authored text derived from a transcript, delimited at the
|
|
@@ -7903,7 +6353,7 @@ export declare const SessionGradeResponseSchema: v.ObjectSchema<{
|
|
|
7903
6353
|
readonly guides: v.ArraySchema<v.ObjectSchema<{
|
|
7904
6354
|
readonly guideId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
7905
6355
|
readonly title: v.StringSchema<undefined>;
|
|
7906
|
-
readonly verdict: v.PicklistSchema<["aligned", "misaligned", "not_applicable"], undefined>;
|
|
6356
|
+
readonly verdict: v.PicklistSchema<readonly ["aligned", "misaligned", "not_applicable"], undefined>;
|
|
7907
6357
|
/**
|
|
7908
6358
|
* The grader's reasoning, **already wrapped in the response's untrusted
|
|
7909
6359
|
* markers** — model-authored text derived from a transcript, delimited at the
|
|
@@ -7994,7 +6444,7 @@ export declare const SessionDigestResponseSchema: v.ObjectSchema<{
|
|
|
7994
6444
|
readonly guides: v.ArraySchema<v.ObjectSchema<{
|
|
7995
6445
|
readonly guideId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
7996
6446
|
readonly title: v.StringSchema<undefined>;
|
|
7997
|
-
readonly verdict: v.PicklistSchema<["aligned", "misaligned", "not_applicable"], undefined>;
|
|
6447
|
+
readonly verdict: v.PicklistSchema<readonly ["aligned", "misaligned", "not_applicable"], undefined>;
|
|
7998
6448
|
/**
|
|
7999
6449
|
* The grader's reasoning, **already wrapped in the response's untrusted
|
|
8000
6450
|
* markers** — model-authored text derived from a transcript, delimited at the
|
|
@@ -8114,27 +6564,18 @@ export declare const SEARCH_COMMENT_AUTHOR_KINDS: readonly ["person", "agent", "
|
|
|
8114
6564
|
export declare const SearchCommentAuthorKindSchema: v.PicklistSchema<readonly ["person", "agent", "mossbear"], undefined>;
|
|
8115
6565
|
export type SearchCommentAuthorKind = v.InferOutput<typeof SearchCommentAuthorKindSchema>;
|
|
8116
6566
|
/**
|
|
8117
|
-
* What a comment is attached to. `
|
|
8118
|
-
* run the caller made. Session comments are the caller's own and never reach
|
|
8119
|
-
* workspace-mate.
|
|
6567
|
+
* What a comment is attached to. `artifact` is a guide or a document; `session`
|
|
6568
|
+
* is a run the caller made. Session comments are the caller's own and never reach
|
|
6569
|
+
* a workspace-mate.
|
|
8120
6570
|
*/
|
|
8121
|
-
export declare const SEARCH_COMMENT_SUBJECT_KINDS: readonly ["item", "session"];
|
|
8122
|
-
export declare const SearchCommentSubjectKindSchema: v.PicklistSchema<readonly ["item", "session"], undefined>;
|
|
8123
|
-
export type SearchCommentSubjectKind = v.InferOutput<typeof SearchCommentSubjectKindSchema>;
|
|
8124
6571
|
/**
|
|
8125
6572
|
* The subject kinds a client names in a search: `artifact`, never its older
|
|
8126
6573
|
* name `item`.
|
|
8127
6574
|
*/
|
|
8128
6575
|
export declare const SEARCH_COMMENT_SUBJECT_KIND_NAMES: readonly ["artifact", "session"];
|
|
8129
|
-
export
|
|
8130
|
-
/**
|
|
8131
|
-
* The subject kinds a search request may name. `artifact` is the new name for
|
|
8132
|
-
* `item` and means the same subjects; both are accepted until every client sends
|
|
8133
|
-
* `artifact`, while hits and the advertised list above still say `item`.
|
|
8134
|
-
*/
|
|
8135
|
-
export declare const SEARCH_COMMENT_SUBJECT_KIND_FILTERS: readonly ["item", "session", "artifact"];
|
|
8136
|
-
export declare const SearchCommentSubjectKindFilterSchema: v.PicklistSchema<readonly ["item", "session", "artifact"], undefined>;
|
|
6576
|
+
export declare const SearchCommentSubjectKindFilterSchema: v.PicklistSchema<readonly ["artifact", "session"], undefined>;
|
|
8137
6577
|
export type SearchCommentSubjectKindFilter = v.InferOutput<typeof SearchCommentSubjectKindFilterSchema>;
|
|
6578
|
+
export type SearchCommentSubjectKindName = (typeof SEARCH_COMMENT_SUBJECT_KIND_NAMES)[number];
|
|
8138
6579
|
/**
|
|
8139
6580
|
* What a user turn was, as the session classifier labels it. The same
|
|
8140
6581
|
* vocabulary the classifier writes; a `turns` search may keep only some.
|
|
@@ -8189,7 +6630,7 @@ export declare const SearchRequestObjectSchema: v.ObjectSchema<{
|
|
|
8189
6630
|
* Restrict the `comments` corpus to comments on these kinds of subject. Does
|
|
8190
6631
|
* not touch other corpora.
|
|
8191
6632
|
*/
|
|
8192
|
-
readonly subjectKinds: v.OptionalSchema<v.SchemaWithPipe<readonly [v.ArraySchema<v.PicklistSchema<readonly ["
|
|
6633
|
+
readonly subjectKinds: v.OptionalSchema<v.SchemaWithPipe<readonly [v.ArraySchema<v.PicklistSchema<readonly ["artifact", "session"], undefined>, undefined>, v.MinLengthAction<("artifact" | "session")[], 1, undefined>]>, undefined>;
|
|
8193
6634
|
/**
|
|
8194
6635
|
* Restrict the `turns` corpus to turns the classifier gave one of these
|
|
8195
6636
|
* labels. A turn with no label never matches. Does not touch other corpora.
|
|
@@ -8259,7 +6700,7 @@ export declare const SearchRequestSchema: v.SchemaWithPipe<readonly [v.ObjectSch
|
|
|
8259
6700
|
* Restrict the `comments` corpus to comments on these kinds of subject. Does
|
|
8260
6701
|
* not touch other corpora.
|
|
8261
6702
|
*/
|
|
8262
|
-
readonly subjectKinds: v.OptionalSchema<v.SchemaWithPipe<readonly [v.ArraySchema<v.PicklistSchema<readonly ["
|
|
6703
|
+
readonly subjectKinds: v.OptionalSchema<v.SchemaWithPipe<readonly [v.ArraySchema<v.PicklistSchema<readonly ["artifact", "session"], undefined>, undefined>, v.MinLengthAction<("artifact" | "session")[], 1, undefined>]>, undefined>;
|
|
8263
6704
|
/**
|
|
8264
6705
|
* Restrict the `turns` corpus to turns the classifier gave one of these
|
|
8265
6706
|
* labels. A turn with no label never matches. Does not touch other corpora.
|
|
@@ -8294,7 +6735,7 @@ export declare const SearchRequestSchema: v.SchemaWithPipe<readonly [v.ObjectSch
|
|
|
8294
6735
|
[x: string]: string;
|
|
8295
6736
|
} | undefined;
|
|
8296
6737
|
authorKinds?: ("agent" | "person" | "mossbear")[] | undefined;
|
|
8297
|
-
subjectKinds?: ("
|
|
6738
|
+
subjectKinds?: ("artifact" | "session")[] | undefined;
|
|
8298
6739
|
steeringLabels?: ("correction" | "steering" | "new request" | "acknowledgement" | "insufficient evidence")[] | undefined;
|
|
8299
6740
|
headSha?: string | undefined;
|
|
8300
6741
|
branch?: string | undefined;
|
|
@@ -8311,7 +6752,7 @@ export declare const SearchRequestSchema: v.SchemaWithPipe<readonly [v.ObjectSch
|
|
|
8311
6752
|
[x: string]: string;
|
|
8312
6753
|
} | undefined;
|
|
8313
6754
|
authorKinds?: ("agent" | "person" | "mossbear")[] | undefined;
|
|
8314
|
-
subjectKinds?: ("
|
|
6755
|
+
subjectKinds?: ("artifact" | "session")[] | undefined;
|
|
8315
6756
|
steeringLabels?: ("correction" | "steering" | "new request" | "acknowledgement" | "insufficient evidence")[] | undefined;
|
|
8316
6757
|
headSha?: string | undefined;
|
|
8317
6758
|
branch?: string | undefined;
|
|
@@ -8328,7 +6769,7 @@ export declare const SearchRequestSchema: v.SchemaWithPipe<readonly [v.ObjectSch
|
|
|
8328
6769
|
[x: string]: string;
|
|
8329
6770
|
} | undefined;
|
|
8330
6771
|
authorKinds?: ("agent" | "person" | "mossbear")[] | undefined;
|
|
8331
|
-
subjectKinds?: ("
|
|
6772
|
+
subjectKinds?: ("artifact" | "session")[] | undefined;
|
|
8332
6773
|
steeringLabels?: ("correction" | "steering" | "new request" | "acknowledgement" | "insufficient evidence")[] | undefined;
|
|
8333
6774
|
headSha?: string | undefined;
|
|
8334
6775
|
branch?: string | undefined;
|
|
@@ -8345,7 +6786,7 @@ export declare const SearchRequestSchema: v.SchemaWithPipe<readonly [v.ObjectSch
|
|
|
8345
6786
|
[x: string]: string;
|
|
8346
6787
|
} | undefined;
|
|
8347
6788
|
authorKinds?: ("agent" | "person" | "mossbear")[] | undefined;
|
|
8348
|
-
subjectKinds?: ("
|
|
6789
|
+
subjectKinds?: ("artifact" | "session")[] | undefined;
|
|
8349
6790
|
steeringLabels?: ("correction" | "steering" | "new request" | "acknowledgement" | "insufficient evidence")[] | undefined;
|
|
8350
6791
|
headSha?: string | undefined;
|
|
8351
6792
|
branch?: string | undefined;
|
|
@@ -8362,7 +6803,7 @@ export declare const SearchRequestSchema: v.SchemaWithPipe<readonly [v.ObjectSch
|
|
|
8362
6803
|
[x: string]: string;
|
|
8363
6804
|
} | undefined;
|
|
8364
6805
|
authorKinds?: ("agent" | "person" | "mossbear")[] | undefined;
|
|
8365
|
-
subjectKinds?: ("
|
|
6806
|
+
subjectKinds?: ("artifact" | "session")[] | undefined;
|
|
8366
6807
|
steeringLabels?: ("correction" | "steering" | "new request" | "acknowledgement" | "insufficient evidence")[] | undefined;
|
|
8367
6808
|
headSha?: string | undefined;
|
|
8368
6809
|
branch?: string | undefined;
|
|
@@ -8379,7 +6820,7 @@ export declare const SearchRequestSchema: v.SchemaWithPipe<readonly [v.ObjectSch
|
|
|
8379
6820
|
[x: string]: string;
|
|
8380
6821
|
} | undefined;
|
|
8381
6822
|
authorKinds?: ("agent" | "person" | "mossbear")[] | undefined;
|
|
8382
|
-
subjectKinds?: ("
|
|
6823
|
+
subjectKinds?: ("artifact" | "session")[] | undefined;
|
|
8383
6824
|
steeringLabels?: ("correction" | "steering" | "new request" | "acknowledgement" | "insufficient evidence")[] | undefined;
|
|
8384
6825
|
headSha?: string | undefined;
|
|
8385
6826
|
branch?: string | undefined;
|
|
@@ -8436,7 +6877,7 @@ export declare const SearchVerdictHitSchema: v.ObjectSchema<{
|
|
|
8436
6877
|
* caller can read, or nothing names it.
|
|
8437
6878
|
*/
|
|
8438
6879
|
readonly guideTitle: v.NullableSchema<v.StringSchema<undefined>, undefined>;
|
|
8439
|
-
readonly verdict: v.PicklistSchema<["aligned", "misaligned", "not_applicable"], undefined>;
|
|
6880
|
+
readonly verdict: v.PicklistSchema<readonly ["aligned", "misaligned", "not_applicable"], undefined>;
|
|
8440
6881
|
readonly occurredAt: v.StringSchema<undefined>;
|
|
8441
6882
|
readonly reasoning: v.StringSchema<undefined>;
|
|
8442
6883
|
}, undefined>;
|
|
@@ -8473,8 +6914,8 @@ export type SearchContentHit = v.InferOutput<typeof SearchContentHitSchema>;
|
|
|
8473
6914
|
* A comment on a guide or document that matched. `body` and `itemName` and
|
|
8474
6915
|
* `workspaceName` are wrapped in `untrusted`'s markers.
|
|
8475
6916
|
*/
|
|
8476
|
-
export declare const
|
|
8477
|
-
readonly subjectKind: v.LiteralSchema<"
|
|
6917
|
+
export declare const SearchArtifactCommentHitSchema: v.ObjectSchema<{
|
|
6918
|
+
readonly subjectKind: v.LiteralSchema<"artifact", undefined>;
|
|
8478
6919
|
readonly itemId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
8479
6920
|
/**
|
|
8480
6921
|
* The guide the item belongs to, or null for a standalone document. A comment
|
|
@@ -8524,44 +6965,6 @@ export declare const SearchSessionCommentHitSchema: v.ObjectSchema<{
|
|
|
8524
6965
|
readonly url: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
|
|
8525
6966
|
readonly excerpt: v.StringSchema<undefined>;
|
|
8526
6967
|
}, undefined>;
|
|
8527
|
-
/**
|
|
8528
|
-
* The same hit under the new name for its subject (one-artifact Stage 3): a
|
|
8529
|
-
* client reads either until every server sends `artifact`.
|
|
8530
|
-
*/
|
|
8531
|
-
export declare const SearchArtifactCommentHitSchema: v.ObjectSchema<{
|
|
8532
|
-
readonly subjectKind: v.LiteralSchema<"artifact", undefined>;
|
|
8533
|
-
readonly itemId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
8534
|
-
/**
|
|
8535
|
-
* The guide the item belongs to, or null for a standalone document. A comment
|
|
8536
|
-
* on a guide sits on its body file, so this is the id the dashboard's guide
|
|
8537
|
-
* page takes; `itemId` is the one a document page takes.
|
|
8538
|
-
*/
|
|
8539
|
-
readonly guideId: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>;
|
|
8540
|
-
/** Wrapped in `untrusted`'s markers; null when the item has no name. */
|
|
8541
|
-
readonly itemName: v.NullableSchema<v.StringSchema<undefined>, undefined>;
|
|
8542
|
-
readonly workspaceId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
8543
|
-
/** Wrapped in `untrusted`'s markers. */
|
|
8544
|
-
readonly workspaceName: v.StringSchema<undefined>;
|
|
8545
|
-
/** Whether the item has been edited since the comment was written. */
|
|
8546
|
-
readonly itemChangedSince: v.BooleanSchema<undefined>;
|
|
8547
|
-
/**
|
|
8548
|
-
* Whether the match is in the comment's text or in the replacement it
|
|
8549
|
-
* suggests (Mossbear's drafted edits).
|
|
8550
|
-
*/
|
|
8551
|
-
readonly matchedIn: v.PicklistSchema<["body", "suggestion"], undefined>;
|
|
8552
|
-
/**
|
|
8553
|
-
* A Mossbear suggestion's draft state: whether its owner has handed it to
|
|
8554
|
-
* their agents. Absent on a person's or an agent's comment and on a reply.
|
|
8555
|
-
*/
|
|
8556
|
-
readonly approved: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
|
|
8557
|
-
readonly commentId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
8558
|
-
readonly threadId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
8559
|
-
readonly authorKind: v.PicklistSchema<readonly ["person", "agent", "mossbear"], undefined>;
|
|
8560
|
-
readonly resolved: v.BooleanSchema<undefined>;
|
|
8561
|
-
readonly createdAt: v.StringSchema<undefined>;
|
|
8562
|
-
readonly url: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
|
|
8563
|
-
readonly excerpt: v.StringSchema<undefined>;
|
|
8564
|
-
}, undefined>;
|
|
8565
6968
|
export declare const SearchCommentHitSchema: v.VariantSchema<"subjectKind", [v.ObjectSchema<{
|
|
8566
6969
|
readonly subjectKind: v.LiteralSchema<"artifact", undefined>;
|
|
8567
6970
|
readonly itemId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
@@ -8595,39 +6998,6 @@ export declare const SearchCommentHitSchema: v.VariantSchema<"subjectKind", [v.O
|
|
|
8595
6998
|
readonly createdAt: v.StringSchema<undefined>;
|
|
8596
6999
|
readonly url: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
|
|
8597
7000
|
readonly excerpt: v.StringSchema<undefined>;
|
|
8598
|
-
}, undefined>, v.ObjectSchema<{
|
|
8599
|
-
readonly subjectKind: v.LiteralSchema<"item", undefined>;
|
|
8600
|
-
readonly itemId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
8601
|
-
/**
|
|
8602
|
-
* The guide the item belongs to, or null for a standalone document. A comment
|
|
8603
|
-
* on a guide sits on its body file, so this is the id the dashboard's guide
|
|
8604
|
-
* page takes; `itemId` is the one a document page takes.
|
|
8605
|
-
*/
|
|
8606
|
-
readonly guideId: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>;
|
|
8607
|
-
/** Wrapped in `untrusted`'s markers; null when the item has no name. */
|
|
8608
|
-
readonly itemName: v.NullableSchema<v.StringSchema<undefined>, undefined>;
|
|
8609
|
-
readonly workspaceId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
8610
|
-
/** Wrapped in `untrusted`'s markers. */
|
|
8611
|
-
readonly workspaceName: v.StringSchema<undefined>;
|
|
8612
|
-
/** Whether the item has been edited since the comment was written. */
|
|
8613
|
-
readonly itemChangedSince: v.BooleanSchema<undefined>;
|
|
8614
|
-
/**
|
|
8615
|
-
* Whether the match is in the comment's text or in the replacement it
|
|
8616
|
-
* suggests (Mossbear's drafted edits).
|
|
8617
|
-
*/
|
|
8618
|
-
readonly matchedIn: v.PicklistSchema<["body", "suggestion"], undefined>;
|
|
8619
|
-
/**
|
|
8620
|
-
* A Mossbear suggestion's draft state: whether its owner has handed it to
|
|
8621
|
-
* their agents. Absent on a person's or an agent's comment and on a reply.
|
|
8622
|
-
*/
|
|
8623
|
-
readonly approved: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
|
|
8624
|
-
readonly commentId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
8625
|
-
readonly threadId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
8626
|
-
readonly authorKind: v.PicklistSchema<readonly ["person", "agent", "mossbear"], undefined>;
|
|
8627
|
-
readonly resolved: v.BooleanSchema<undefined>;
|
|
8628
|
-
readonly createdAt: v.StringSchema<undefined>;
|
|
8629
|
-
readonly url: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
|
|
8630
|
-
readonly excerpt: v.StringSchema<undefined>;
|
|
8631
7001
|
}, undefined>, v.ObjectSchema<{
|
|
8632
7002
|
readonly subjectKind: v.LiteralSchema<"session", undefined>;
|
|
8633
7003
|
readonly sessionId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
@@ -8640,7 +7010,7 @@ export declare const SearchCommentHitSchema: v.VariantSchema<"subjectKind", [v.O
|
|
|
8640
7010
|
readonly url: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
|
|
8641
7011
|
readonly excerpt: v.StringSchema<undefined>;
|
|
8642
7012
|
}, undefined>], undefined>;
|
|
8643
|
-
export type
|
|
7013
|
+
export type SearchArtifactCommentHit = v.InferOutput<typeof SearchArtifactCommentHitSchema>;
|
|
8644
7014
|
export type SearchSessionCommentHit = v.InferOutput<typeof SearchSessionCommentHitSchema>;
|
|
8645
7015
|
export type SearchCommentHit = v.InferOutput<typeof SearchCommentHitSchema>;
|
|
8646
7016
|
/**
|
|
@@ -8765,7 +7135,7 @@ export declare const SearchVerdictsReportSchema: v.VariantSchema<"status", [v.Ob
|
|
|
8765
7135
|
* caller can read, or nothing names it.
|
|
8766
7136
|
*/
|
|
8767
7137
|
readonly guideTitle: v.NullableSchema<v.StringSchema<undefined>, undefined>;
|
|
8768
|
-
readonly verdict: v.PicklistSchema<["aligned", "misaligned", "not_applicable"], undefined>;
|
|
7138
|
+
readonly verdict: v.PicklistSchema<readonly ["aligned", "misaligned", "not_applicable"], undefined>;
|
|
8769
7139
|
readonly occurredAt: v.StringSchema<undefined>;
|
|
8770
7140
|
readonly reasoning: v.StringSchema<undefined>;
|
|
8771
7141
|
}, undefined>, undefined>;
|
|
@@ -8787,65 +7157,32 @@ export declare const SearchContentReportSchema: v.VariantSchema<"status", [v.Obj
|
|
|
8787
7157
|
/** Wrapped in `untrusted`'s markers. */
|
|
8788
7158
|
readonly workspaceName: v.StringSchema<undefined>;
|
|
8789
7159
|
/**
|
|
8790
|
-
* Slugs of the bundles that hold the item and that the caller may read — the
|
|
8791
|
-
* argument `pull_bundle` takes to read the whole document. Never more than
|
|
8792
|
-
* a scoped caller's allowlist reaches.
|
|
8793
|
-
*/
|
|
8794
|
-
readonly bundles: v.ArraySchema<v.StringSchema<undefined>, undefined>;
|
|
8795
|
-
readonly updatedAt: v.StringSchema<undefined>;
|
|
8796
|
-
/**
|
|
8797
|
-
* Where the item opens on the dashboard. Added by the CLI, which knows the
|
|
8798
|
-
* dashboard's address; the server does not send it.
|
|
8799
|
-
*/
|
|
8800
|
-
readonly url: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
|
|
8801
|
-
/** A window around the match, wrapped in `untrusted`'s markers. */
|
|
8802
|
-
readonly excerpt: v.StringSchema<undefined>;
|
|
8803
|
-
}, undefined>, undefined>;
|
|
8804
|
-
}, undefined>, v.ObjectSchema<{
|
|
8805
|
-
readonly status: v.LiteralSchema<"skipped", undefined>;
|
|
8806
|
-
readonly reason: v.PicklistSchema<["excluded-by-caller", "timed-out", "not-granted", "not-yet-searchable"], undefined>;
|
|
8807
|
-
}, undefined>], undefined>;
|
|
8808
|
-
export declare const SearchCommentsReportSchema: v.VariantSchema<"status", [v.ObjectSchema<{
|
|
8809
|
-
readonly status: v.LiteralSchema<"searched", undefined>;
|
|
8810
|
-
/** Every match in scope, counted past the returned page. */
|
|
8811
|
-
readonly total: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
|
|
8812
|
-
readonly narrowedBy: v.NullableSchema<v.PicklistSchema<["narrowed-by-bundle-allowlist"], undefined>, undefined>;
|
|
8813
|
-
/** Newest first, at most the request's limit. */
|
|
8814
|
-
readonly hits: v.ArraySchema<v.VariantSchema<"subjectKind", [v.ObjectSchema<{
|
|
8815
|
-
readonly subjectKind: v.LiteralSchema<"artifact", undefined>;
|
|
8816
|
-
readonly itemId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
8817
|
-
/**
|
|
8818
|
-
* The guide the item belongs to, or null for a standalone document. A comment
|
|
8819
|
-
* on a guide sits on its body file, so this is the id the dashboard's guide
|
|
8820
|
-
* page takes; `itemId` is the one a document page takes.
|
|
8821
|
-
*/
|
|
8822
|
-
readonly guideId: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>;
|
|
8823
|
-
/** Wrapped in `untrusted`'s markers; null when the item has no name. */
|
|
8824
|
-
readonly itemName: v.NullableSchema<v.StringSchema<undefined>, undefined>;
|
|
8825
|
-
readonly workspaceId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
8826
|
-
/** Wrapped in `untrusted`'s markers. */
|
|
8827
|
-
readonly workspaceName: v.StringSchema<undefined>;
|
|
8828
|
-
/** Whether the item has been edited since the comment was written. */
|
|
8829
|
-
readonly itemChangedSince: v.BooleanSchema<undefined>;
|
|
8830
|
-
/**
|
|
8831
|
-
* Whether the match is in the comment's text or in the replacement it
|
|
8832
|
-
* suggests (Mossbear's drafted edits).
|
|
7160
|
+
* Slugs of the bundles that hold the item and that the caller may read — the
|
|
7161
|
+
* argument `pull_bundle` takes to read the whole document. Never more than
|
|
7162
|
+
* a scoped caller's allowlist reaches.
|
|
8833
7163
|
*/
|
|
8834
|
-
readonly
|
|
7164
|
+
readonly bundles: v.ArraySchema<v.StringSchema<undefined>, undefined>;
|
|
7165
|
+
readonly updatedAt: v.StringSchema<undefined>;
|
|
8835
7166
|
/**
|
|
8836
|
-
*
|
|
8837
|
-
*
|
|
7167
|
+
* Where the item opens on the dashboard. Added by the CLI, which knows the
|
|
7168
|
+
* dashboard's address; the server does not send it.
|
|
8838
7169
|
*/
|
|
8839
|
-
readonly approved: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
|
|
8840
|
-
readonly commentId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
8841
|
-
readonly threadId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
8842
|
-
readonly authorKind: v.PicklistSchema<readonly ["person", "agent", "mossbear"], undefined>;
|
|
8843
|
-
readonly resolved: v.BooleanSchema<undefined>;
|
|
8844
|
-
readonly createdAt: v.StringSchema<undefined>;
|
|
8845
7170
|
readonly url: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
|
|
7171
|
+
/** A window around the match, wrapped in `untrusted`'s markers. */
|
|
8846
7172
|
readonly excerpt: v.StringSchema<undefined>;
|
|
8847
|
-
}, undefined>,
|
|
8848
|
-
|
|
7173
|
+
}, undefined>, undefined>;
|
|
7174
|
+
}, undefined>, v.ObjectSchema<{
|
|
7175
|
+
readonly status: v.LiteralSchema<"skipped", undefined>;
|
|
7176
|
+
readonly reason: v.PicklistSchema<["excluded-by-caller", "timed-out", "not-granted", "not-yet-searchable"], undefined>;
|
|
7177
|
+
}, undefined>], undefined>;
|
|
7178
|
+
export declare const SearchCommentsReportSchema: v.VariantSchema<"status", [v.ObjectSchema<{
|
|
7179
|
+
readonly status: v.LiteralSchema<"searched", undefined>;
|
|
7180
|
+
/** Every match in scope, counted past the returned page. */
|
|
7181
|
+
readonly total: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
|
|
7182
|
+
readonly narrowedBy: v.NullableSchema<v.PicklistSchema<["narrowed-by-bundle-allowlist"], undefined>, undefined>;
|
|
7183
|
+
/** Newest first, at most the request's limit. */
|
|
7184
|
+
readonly hits: v.ArraySchema<v.VariantSchema<"subjectKind", [v.ObjectSchema<{
|
|
7185
|
+
readonly subjectKind: v.LiteralSchema<"artifact", undefined>;
|
|
8849
7186
|
readonly itemId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
8850
7187
|
/**
|
|
8851
7188
|
* The guide the item belongs to, or null for a standalone document. A comment
|
|
@@ -9034,7 +7371,7 @@ export declare const SearchResponseSchema: v.ObjectSchema<{
|
|
|
9034
7371
|
* caller can read, or nothing names it.
|
|
9035
7372
|
*/
|
|
9036
7373
|
readonly guideTitle: v.NullableSchema<v.StringSchema<undefined>, undefined>;
|
|
9037
|
-
readonly verdict: v.PicklistSchema<["aligned", "misaligned", "not_applicable"], undefined>;
|
|
7374
|
+
readonly verdict: v.PicklistSchema<readonly ["aligned", "misaligned", "not_applicable"], undefined>;
|
|
9038
7375
|
readonly occurredAt: v.StringSchema<undefined>;
|
|
9039
7376
|
readonly reasoning: v.StringSchema<undefined>;
|
|
9040
7377
|
}, undefined>, undefined>;
|
|
@@ -9119,39 +7456,6 @@ export declare const SearchResponseSchema: v.ObjectSchema<{
|
|
|
9119
7456
|
readonly createdAt: v.StringSchema<undefined>;
|
|
9120
7457
|
readonly url: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
|
|
9121
7458
|
readonly excerpt: v.StringSchema<undefined>;
|
|
9122
|
-
}, undefined>, v.ObjectSchema<{
|
|
9123
|
-
readonly subjectKind: v.LiteralSchema<"item", undefined>;
|
|
9124
|
-
readonly itemId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
9125
|
-
/**
|
|
9126
|
-
* The guide the item belongs to, or null for a standalone document. A comment
|
|
9127
|
-
* on a guide sits on its body file, so this is the id the dashboard's guide
|
|
9128
|
-
* page takes; `itemId` is the one a document page takes.
|
|
9129
|
-
*/
|
|
9130
|
-
readonly guideId: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>;
|
|
9131
|
-
/** Wrapped in `untrusted`'s markers; null when the item has no name. */
|
|
9132
|
-
readonly itemName: v.NullableSchema<v.StringSchema<undefined>, undefined>;
|
|
9133
|
-
readonly workspaceId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
9134
|
-
/** Wrapped in `untrusted`'s markers. */
|
|
9135
|
-
readonly workspaceName: v.StringSchema<undefined>;
|
|
9136
|
-
/** Whether the item has been edited since the comment was written. */
|
|
9137
|
-
readonly itemChangedSince: v.BooleanSchema<undefined>;
|
|
9138
|
-
/**
|
|
9139
|
-
* Whether the match is in the comment's text or in the replacement it
|
|
9140
|
-
* suggests (Mossbear's drafted edits).
|
|
9141
|
-
*/
|
|
9142
|
-
readonly matchedIn: v.PicklistSchema<["body", "suggestion"], undefined>;
|
|
9143
|
-
/**
|
|
9144
|
-
* A Mossbear suggestion's draft state: whether its owner has handed it to
|
|
9145
|
-
* their agents. Absent on a person's or an agent's comment and on a reply.
|
|
9146
|
-
*/
|
|
9147
|
-
readonly approved: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
|
|
9148
|
-
readonly commentId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
9149
|
-
readonly threadId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
9150
|
-
readonly authorKind: v.PicklistSchema<readonly ["person", "agent", "mossbear"], undefined>;
|
|
9151
|
-
readonly resolved: v.BooleanSchema<undefined>;
|
|
9152
|
-
readonly createdAt: v.StringSchema<undefined>;
|
|
9153
|
-
readonly url: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
|
|
9154
|
-
readonly excerpt: v.StringSchema<undefined>;
|
|
9155
7459
|
}, undefined>, v.ObjectSchema<{
|
|
9156
7460
|
readonly subjectKind: v.LiteralSchema<"session", undefined>;
|
|
9157
7461
|
readonly sessionId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
@@ -9342,371 +7646,93 @@ export declare function parseWorkspaceListResponse(data: unknown): {
|
|
|
9342
7646
|
workspaces: {
|
|
9343
7647
|
id: string;
|
|
9344
7648
|
name: string;
|
|
9345
|
-
slug: string;
|
|
9346
|
-
role: string;
|
|
9347
|
-
isDefault: boolean;
|
|
9348
|
-
}[];
|
|
9349
|
-
};
|
|
9350
|
-
export declare function parseCreateScopedTokenRequest(data: unknown): {
|
|
9351
|
-
label: string;
|
|
9352
|
-
grants: {
|
|
9353
|
-
bundleId: string;
|
|
9354
|
-
access: "read" | "write";
|
|
9355
|
-
}[];
|
|
9356
|
-
};
|
|
9357
|
-
export declare function parseRevokeScopedTokenRequest(data: unknown): {
|
|
9358
|
-
id: string;
|
|
9359
|
-
};
|
|
9360
|
-
export declare function parseCreateBundleRequest(data: unknown): {
|
|
9361
|
-
slug: string;
|
|
9362
|
-
name: string;
|
|
9363
|
-
};
|
|
9364
|
-
export declare function parseCreateBundleResponse(data: unknown): {
|
|
9365
|
-
bundle: {
|
|
9366
|
-
id: string;
|
|
9367
|
-
slug: string;
|
|
9368
|
-
name: string;
|
|
9369
|
-
createdAt: string;
|
|
9370
|
-
home?: string | undefined;
|
|
9371
|
-
};
|
|
9372
|
-
};
|
|
9373
|
-
export declare function parseAttachBundleMemberRequest(data: unknown): {
|
|
9374
|
-
itemId: string;
|
|
9375
|
-
};
|
|
9376
|
-
export declare function parseAttachBundleMemberResponse(data: unknown): {
|
|
9377
|
-
attached: boolean;
|
|
9378
|
-
};
|
|
9379
|
-
export declare function parseDetachBundleMemberResponse(data: unknown): {
|
|
9380
|
-
detached: boolean;
|
|
9381
|
-
};
|
|
9382
|
-
export declare function parseSubscribeBundleRequest(data: unknown): {
|
|
9383
|
-
bundleId: string;
|
|
9384
|
-
deliver?: "global" | "repo" | null | undefined;
|
|
9385
|
-
muted?: string[] | undefined;
|
|
9386
|
-
};
|
|
9387
|
-
export declare function parseSubscribeBundleResponse(data: unknown): {
|
|
9388
|
-
bundleId: string;
|
|
9389
|
-
created: boolean;
|
|
9390
|
-
deliver?: "global" | "repo" | undefined;
|
|
9391
|
-
muted?: string[] | undefined;
|
|
9392
|
-
};
|
|
9393
|
-
export declare function parseResolveSubscriptionsRequest(data: unknown): {
|
|
9394
|
-
repoBundleIds: string[];
|
|
9395
|
-
};
|
|
9396
|
-
export declare function parseResolveSubscriptionsResponse(data: unknown): {
|
|
9397
|
-
bundles: {
|
|
9398
|
-
id: string;
|
|
9399
|
-
slug: string;
|
|
9400
|
-
name: string;
|
|
9401
|
-
scopes: ("repo" | "user")[];
|
|
9402
|
-
deliver?: "global" | "repo" | undefined;
|
|
9403
|
-
home?: string | undefined;
|
|
9404
|
-
muted?: string[] | undefined;
|
|
9405
|
-
}[];
|
|
9406
|
-
unresolved: {
|
|
9407
|
-
id: string;
|
|
9408
|
-
}[];
|
|
9409
|
-
account?: {
|
|
9410
|
-
deliverGlobalSkills: boolean;
|
|
9411
|
-
} | undefined;
|
|
9412
|
-
limitedToken?: boolean | undefined;
|
|
9413
|
-
};
|
|
9414
|
-
export declare function parseUpdateBundleRequest(data: unknown): {
|
|
9415
|
-
name?: string | undefined;
|
|
9416
|
-
home?: string | null | undefined;
|
|
9417
|
-
};
|
|
9418
|
-
export declare function parseUpdateBundleResponse(data: unknown): {
|
|
9419
|
-
bundle: {
|
|
9420
|
-
id: string;
|
|
9421
|
-
slug: string;
|
|
9422
|
-
name: string;
|
|
9423
|
-
createdAt: string;
|
|
9424
|
-
home?: string | undefined;
|
|
9425
|
-
};
|
|
9426
|
-
};
|
|
9427
|
-
export declare function parseDeleteBundleResponse(data: unknown): {
|
|
9428
|
-
deleted: boolean;
|
|
9429
|
-
};
|
|
9430
|
-
export declare function parseContextItem(data: unknown): {
|
|
9431
|
-
type: string;
|
|
9432
|
-
id: string;
|
|
9433
|
-
artifactId?: string | null | undefined;
|
|
9434
|
-
name: string;
|
|
9435
|
-
role: string | null;
|
|
9436
|
-
format: string | null;
|
|
9437
|
-
content: string | null;
|
|
9438
|
-
origin?: string | null | undefined;
|
|
9439
|
-
version?: number | undefined;
|
|
9440
|
-
guideId?: string | null | undefined;
|
|
9441
|
-
root?: "project" | "global" | null | undefined;
|
|
9442
|
-
path?: string | null | undefined;
|
|
9443
|
-
projectId?: string | null | undefined;
|
|
9444
|
-
pathProjectId?: string | null | undefined;
|
|
9445
|
-
aliases?: {
|
|
9446
|
-
root: "project" | "global";
|
|
9447
|
-
path: string;
|
|
9448
|
-
}[] | undefined;
|
|
9449
|
-
comments?: {
|
|
9450
|
-
id: string;
|
|
9451
|
-
state?: "open" | "resolved" | undefined;
|
|
9452
|
-
passage?: {
|
|
9453
|
-
quote: string;
|
|
9454
|
-
status: "located" | "changed" | "orphaned";
|
|
9455
|
-
lines: {
|
|
9456
|
-
start: number;
|
|
9457
|
-
end: number;
|
|
9458
|
-
} | null;
|
|
9459
|
-
} | undefined;
|
|
9460
|
-
body: string;
|
|
9461
|
-
suggestion?: string | undefined;
|
|
9462
|
-
finding?: {
|
|
9463
|
-
tier: "observed" | "usage" | "practice";
|
|
9464
|
-
tierLine: string;
|
|
9465
|
-
blindSpot: string;
|
|
9466
|
-
prediction: string | null;
|
|
9467
|
-
} | undefined;
|
|
9468
|
-
approved?: boolean | undefined;
|
|
9469
|
-
authorName: string | null;
|
|
9470
|
-
createdAt: string;
|
|
9471
|
-
itemVersion: number;
|
|
9472
|
-
itemChangedSince: boolean;
|
|
9473
|
-
deliveredCount: number;
|
|
9474
|
-
threadId: string;
|
|
9475
|
-
replyToId: string | null;
|
|
9476
|
-
}[] | undefined;
|
|
9477
|
-
updatedAt: string;
|
|
9478
|
-
gitSource?: {
|
|
9479
|
-
projectId: string;
|
|
9480
|
-
commitSha: string;
|
|
9481
|
-
branch?: string | undefined;
|
|
9482
|
-
} | null | undefined;
|
|
9483
|
-
removed?: true | undefined;
|
|
9484
|
-
};
|
|
9485
|
-
export declare function parseContextItemsResponse(data: unknown): {
|
|
9486
|
-
items: {
|
|
9487
|
-
type: string;
|
|
9488
|
-
id: string;
|
|
9489
|
-
artifactId?: string | null | undefined;
|
|
9490
|
-
name: string;
|
|
9491
|
-
role: string | null;
|
|
9492
|
-
format: string | null;
|
|
9493
|
-
content: string | null;
|
|
9494
|
-
origin?: string | null | undefined;
|
|
9495
|
-
version?: number | undefined;
|
|
9496
|
-
guideId?: string | null | undefined;
|
|
9497
|
-
root?: "project" | "global" | null | undefined;
|
|
9498
|
-
path?: string | null | undefined;
|
|
9499
|
-
projectId?: string | null | undefined;
|
|
9500
|
-
pathProjectId?: string | null | undefined;
|
|
9501
|
-
aliases?: {
|
|
9502
|
-
root: "project" | "global";
|
|
9503
|
-
path: string;
|
|
9504
|
-
}[] | undefined;
|
|
9505
|
-
comments?: {
|
|
9506
|
-
id: string;
|
|
9507
|
-
state?: "open" | "resolved" | undefined;
|
|
9508
|
-
passage?: {
|
|
9509
|
-
quote: string;
|
|
9510
|
-
status: "located" | "changed" | "orphaned";
|
|
9511
|
-
lines: {
|
|
9512
|
-
start: number;
|
|
9513
|
-
end: number;
|
|
9514
|
-
} | null;
|
|
9515
|
-
} | undefined;
|
|
9516
|
-
body: string;
|
|
9517
|
-
suggestion?: string | undefined;
|
|
9518
|
-
finding?: {
|
|
9519
|
-
tier: "observed" | "usage" | "practice";
|
|
9520
|
-
tierLine: string;
|
|
9521
|
-
blindSpot: string;
|
|
9522
|
-
prediction: string | null;
|
|
9523
|
-
} | undefined;
|
|
9524
|
-
approved?: boolean | undefined;
|
|
9525
|
-
authorName: string | null;
|
|
9526
|
-
createdAt: string;
|
|
9527
|
-
itemVersion: number;
|
|
9528
|
-
itemChangedSince: boolean;
|
|
9529
|
-
deliveredCount: number;
|
|
9530
|
-
threadId: string;
|
|
9531
|
-
replyToId: string | null;
|
|
9532
|
-
}[] | undefined;
|
|
9533
|
-
updatedAt: string;
|
|
9534
|
-
gitSource?: {
|
|
9535
|
-
projectId: string;
|
|
9536
|
-
commitSha: string;
|
|
9537
|
-
branch?: string | undefined;
|
|
9538
|
-
} | null | undefined;
|
|
9539
|
-
removed?: true | undefined;
|
|
7649
|
+
slug: string;
|
|
7650
|
+
role: string;
|
|
7651
|
+
isDefault: boolean;
|
|
7652
|
+
}[];
|
|
7653
|
+
};
|
|
7654
|
+
export declare function parseCreateScopedTokenRequest(data: unknown): {
|
|
7655
|
+
label: string;
|
|
7656
|
+
grants: {
|
|
7657
|
+
bundleId: string;
|
|
7658
|
+
access: "read" | "write";
|
|
9540
7659
|
}[];
|
|
9541
|
-
untrusted?: {
|
|
9542
|
-
token: string;
|
|
9543
|
-
startMarker: string;
|
|
9544
|
-
endMarker: string;
|
|
9545
|
-
note: string;
|
|
9546
|
-
} | null | undefined;
|
|
9547
7660
|
};
|
|
9548
|
-
export declare function
|
|
7661
|
+
export declare function parseRevokeScopedTokenRequest(data: unknown): {
|
|
7662
|
+
id: string;
|
|
7663
|
+
};
|
|
7664
|
+
export declare function parseCreateBundleRequest(data: unknown): {
|
|
7665
|
+
slug: string;
|
|
9549
7666
|
name: string;
|
|
9550
|
-
contentType: "content" | "asset";
|
|
9551
|
-
content: string;
|
|
9552
|
-
itemId?: string | undefined;
|
|
9553
|
-
origin?: string | null | undefined;
|
|
9554
|
-
sourceItemIds?: string[] | undefined;
|
|
9555
|
-
path?: string | null | undefined;
|
|
9556
|
-
projectId?: string | undefined;
|
|
9557
|
-
gitSource?: {
|
|
9558
|
-
projectId: string;
|
|
9559
|
-
commitSha: string;
|
|
9560
|
-
branch?: string | undefined;
|
|
9561
|
-
} | undefined;
|
|
9562
7667
|
};
|
|
9563
|
-
export declare function
|
|
9564
|
-
|
|
9565
|
-
type: string;
|
|
7668
|
+
export declare function parseCreateBundleResponse(data: unknown): {
|
|
7669
|
+
bundle: {
|
|
9566
7670
|
id: string;
|
|
9567
|
-
|
|
7671
|
+
slug: string;
|
|
9568
7672
|
name: string;
|
|
9569
|
-
|
|
9570
|
-
|
|
9571
|
-
content: string | null;
|
|
9572
|
-
origin?: string | null | undefined;
|
|
9573
|
-
version?: number | undefined;
|
|
9574
|
-
guideId?: string | null | undefined;
|
|
9575
|
-
root?: "project" | "global" | null | undefined;
|
|
9576
|
-
path?: string | null | undefined;
|
|
9577
|
-
projectId?: string | null | undefined;
|
|
9578
|
-
pathProjectId?: string | null | undefined;
|
|
9579
|
-
aliases?: {
|
|
9580
|
-
root: "project" | "global";
|
|
9581
|
-
path: string;
|
|
9582
|
-
}[] | undefined;
|
|
9583
|
-
comments?: {
|
|
9584
|
-
id: string;
|
|
9585
|
-
state?: "open" | "resolved" | undefined;
|
|
9586
|
-
passage?: {
|
|
9587
|
-
quote: string;
|
|
9588
|
-
status: "located" | "changed" | "orphaned";
|
|
9589
|
-
lines: {
|
|
9590
|
-
start: number;
|
|
9591
|
-
end: number;
|
|
9592
|
-
} | null;
|
|
9593
|
-
} | undefined;
|
|
9594
|
-
body: string;
|
|
9595
|
-
suggestion?: string | undefined;
|
|
9596
|
-
finding?: {
|
|
9597
|
-
tier: "observed" | "usage" | "practice";
|
|
9598
|
-
tierLine: string;
|
|
9599
|
-
blindSpot: string;
|
|
9600
|
-
prediction: string | null;
|
|
9601
|
-
} | undefined;
|
|
9602
|
-
approved?: boolean | undefined;
|
|
9603
|
-
authorName: string | null;
|
|
9604
|
-
createdAt: string;
|
|
9605
|
-
itemVersion: number;
|
|
9606
|
-
itemChangedSince: boolean;
|
|
9607
|
-
deliveredCount: number;
|
|
9608
|
-
threadId: string;
|
|
9609
|
-
replyToId: string | null;
|
|
9610
|
-
}[] | undefined;
|
|
9611
|
-
updatedAt: string;
|
|
9612
|
-
gitSource?: {
|
|
9613
|
-
projectId: string;
|
|
9614
|
-
commitSha: string;
|
|
9615
|
-
branch?: string | undefined;
|
|
9616
|
-
} | null | undefined;
|
|
9617
|
-
removed?: true | undefined;
|
|
7673
|
+
createdAt: string;
|
|
7674
|
+
home?: string | undefined;
|
|
9618
7675
|
};
|
|
7676
|
+
};
|
|
7677
|
+
export declare function parseAttachBundleMemberRequest(data: unknown): {
|
|
7678
|
+
artifactId: string;
|
|
7679
|
+
};
|
|
7680
|
+
export declare function parseAttachBundleMemberResponse(data: unknown): {
|
|
7681
|
+
attached: boolean;
|
|
7682
|
+
};
|
|
7683
|
+
export declare function parseDetachBundleMemberResponse(data: unknown): {
|
|
7684
|
+
detached: boolean;
|
|
7685
|
+
};
|
|
7686
|
+
export declare function parseSubscribeBundleRequest(data: unknown): {
|
|
7687
|
+
bundleId: string;
|
|
7688
|
+
deliver?: "global" | "repo" | null | undefined;
|
|
7689
|
+
muted?: string[] | undefined;
|
|
7690
|
+
};
|
|
7691
|
+
export declare function parseSubscribeBundleResponse(data: unknown): {
|
|
7692
|
+
bundleId: string;
|
|
9619
7693
|
created: boolean;
|
|
7694
|
+
deliver?: "global" | "repo" | undefined;
|
|
7695
|
+
muted?: string[] | undefined;
|
|
9620
7696
|
};
|
|
9621
|
-
export declare function
|
|
9622
|
-
|
|
9623
|
-
|
|
9624
|
-
|
|
9625
|
-
|
|
9626
|
-
|
|
9627
|
-
|
|
9628
|
-
|
|
9629
|
-
|
|
9630
|
-
|
|
9631
|
-
|
|
9632
|
-
|
|
7697
|
+
export declare function parseResolveSubscriptionsRequest(data: unknown): {
|
|
7698
|
+
repoBundleIds: string[];
|
|
7699
|
+
};
|
|
7700
|
+
export declare function parseResolveSubscriptionsResponse(data: unknown): {
|
|
7701
|
+
bundles: {
|
|
7702
|
+
id: string;
|
|
7703
|
+
slug: string;
|
|
7704
|
+
name: string;
|
|
7705
|
+
scopes: ("repo" | "user")[];
|
|
7706
|
+
deliver?: "global" | "repo" | undefined;
|
|
7707
|
+
home?: string | undefined;
|
|
7708
|
+
muted?: string[] | undefined;
|
|
7709
|
+
}[];
|
|
7710
|
+
unresolved: {
|
|
7711
|
+
id: string;
|
|
7712
|
+
}[];
|
|
7713
|
+
account?: {
|
|
7714
|
+
deliverGlobalSkills: boolean;
|
|
9633
7715
|
} | undefined;
|
|
9634
|
-
|
|
7716
|
+
limitedToken?: boolean | undefined;
|
|
9635
7717
|
};
|
|
9636
|
-
export declare function
|
|
9637
|
-
|
|
9638
|
-
|
|
7718
|
+
export declare function parseUpdateBundleRequest(data: unknown): {
|
|
7719
|
+
name?: string | undefined;
|
|
7720
|
+
home?: string | null | undefined;
|
|
7721
|
+
};
|
|
7722
|
+
export declare function parseUpdateBundleResponse(data: unknown): {
|
|
7723
|
+
bundle: {
|
|
9639
7724
|
id: string;
|
|
9640
|
-
|
|
7725
|
+
slug: string;
|
|
9641
7726
|
name: string;
|
|
9642
|
-
|
|
9643
|
-
|
|
9644
|
-
content: string | null;
|
|
9645
|
-
origin?: string | null | undefined;
|
|
9646
|
-
version?: number | undefined;
|
|
9647
|
-
guideId?: string | null | undefined;
|
|
9648
|
-
root?: "project" | "global" | null | undefined;
|
|
9649
|
-
path?: string | null | undefined;
|
|
9650
|
-
projectId?: string | null | undefined;
|
|
9651
|
-
pathProjectId?: string | null | undefined;
|
|
9652
|
-
aliases?: {
|
|
9653
|
-
root: "project" | "global";
|
|
9654
|
-
path: string;
|
|
9655
|
-
}[] | undefined;
|
|
9656
|
-
comments?: {
|
|
9657
|
-
id: string;
|
|
9658
|
-
state?: "open" | "resolved" | undefined;
|
|
9659
|
-
passage?: {
|
|
9660
|
-
quote: string;
|
|
9661
|
-
status: "located" | "changed" | "orphaned";
|
|
9662
|
-
lines: {
|
|
9663
|
-
start: number;
|
|
9664
|
-
end: number;
|
|
9665
|
-
} | null;
|
|
9666
|
-
} | undefined;
|
|
9667
|
-
body: string;
|
|
9668
|
-
suggestion?: string | undefined;
|
|
9669
|
-
finding?: {
|
|
9670
|
-
tier: "observed" | "usage" | "practice";
|
|
9671
|
-
tierLine: string;
|
|
9672
|
-
blindSpot: string;
|
|
9673
|
-
prediction: string | null;
|
|
9674
|
-
} | undefined;
|
|
9675
|
-
approved?: boolean | undefined;
|
|
9676
|
-
authorName: string | null;
|
|
9677
|
-
createdAt: string;
|
|
9678
|
-
itemVersion: number;
|
|
9679
|
-
itemChangedSince: boolean;
|
|
9680
|
-
deliveredCount: number;
|
|
9681
|
-
threadId: string;
|
|
9682
|
-
replyToId: string | null;
|
|
9683
|
-
}[] | undefined;
|
|
9684
|
-
updatedAt: string;
|
|
9685
|
-
gitSource?: {
|
|
9686
|
-
projectId: string;
|
|
9687
|
-
commitSha: string;
|
|
9688
|
-
branch?: string | undefined;
|
|
9689
|
-
} | null | undefined;
|
|
9690
|
-
removed?: true | undefined;
|
|
7727
|
+
createdAt: string;
|
|
7728
|
+
home?: string | undefined;
|
|
9691
7729
|
};
|
|
9692
|
-
updated: boolean;
|
|
9693
7730
|
};
|
|
9694
|
-
export declare function
|
|
9695
|
-
|
|
9696
|
-
path?: string | null | undefined;
|
|
9697
|
-
expectedVersion?: number | undefined;
|
|
9698
|
-
projectId?: string | undefined;
|
|
9699
|
-
name?: string | undefined;
|
|
9700
|
-
gitSource?: {
|
|
9701
|
-
projectId: string;
|
|
9702
|
-
commitSha: string;
|
|
9703
|
-
branch?: string | undefined;
|
|
9704
|
-
} | undefined;
|
|
9705
|
-
removed?: true | undefined;
|
|
9706
|
-
sourceItemIds?: string[] | undefined;
|
|
7731
|
+
export declare function parseDeleteBundleResponse(data: unknown): {
|
|
7732
|
+
deleted: boolean;
|
|
9707
7733
|
};
|
|
9708
|
-
export declare function
|
|
9709
|
-
|
|
7734
|
+
export declare function parseContextItemsResponse(data: unknown): {
|
|
7735
|
+
items: {
|
|
9710
7736
|
type: string;
|
|
9711
7737
|
id: string;
|
|
9712
7738
|
artifactId?: string | null | undefined;
|
|
@@ -9760,11 +7786,16 @@ export declare function parseContextItemResponse(data: unknown): {
|
|
|
9760
7786
|
branch?: string | undefined;
|
|
9761
7787
|
} | null | undefined;
|
|
9762
7788
|
removed?: true | undefined;
|
|
9763
|
-
};
|
|
7789
|
+
}[];
|
|
7790
|
+
untrusted?: {
|
|
7791
|
+
token: string;
|
|
7792
|
+
startMarker: string;
|
|
7793
|
+
endMarker: string;
|
|
7794
|
+
note: string;
|
|
7795
|
+
} | null | undefined;
|
|
9764
7796
|
};
|
|
9765
|
-
export declare function
|
|
9766
|
-
|
|
9767
|
-
item: {
|
|
7797
|
+
export declare function parseBundleArtifactsResponse(data: unknown): {
|
|
7798
|
+
artifacts: {
|
|
9768
7799
|
type: string;
|
|
9769
7800
|
id: string;
|
|
9770
7801
|
artifactId?: string | null | undefined;
|
|
@@ -9818,7 +7849,13 @@ export declare function parseArchiveContextItemResponse(data: unknown): {
|
|
|
9818
7849
|
branch?: string | undefined;
|
|
9819
7850
|
} | null | undefined;
|
|
9820
7851
|
removed?: true | undefined;
|
|
9821
|
-
};
|
|
7852
|
+
}[];
|
|
7853
|
+
untrusted?: {
|
|
7854
|
+
token: string;
|
|
7855
|
+
startMarker: string;
|
|
7856
|
+
endMarker: string;
|
|
7857
|
+
note: string;
|
|
7858
|
+
} | null | undefined;
|
|
9822
7859
|
};
|
|
9823
7860
|
export declare function parseInboxCaptureRequest(data: unknown): {
|
|
9824
7861
|
id?: string | undefined;
|
|
@@ -9856,7 +7893,7 @@ export declare function parseInboxListResponse(data: unknown): {
|
|
|
9856
7893
|
updatedAt: string;
|
|
9857
7894
|
}[];
|
|
9858
7895
|
};
|
|
9859
|
-
export declare function
|
|
7896
|
+
export declare function parseBundleArtifactVersionsResponse(data: unknown): {
|
|
9860
7897
|
versions: {
|
|
9861
7898
|
id: string;
|
|
9862
7899
|
version: number;
|
|
@@ -9869,19 +7906,6 @@ export declare function parseContextItemVersionsResponse(data: unknown): {
|
|
|
9869
7906
|
}[];
|
|
9870
7907
|
nextCursor: number | null;
|
|
9871
7908
|
};
|
|
9872
|
-
export declare function parseContextItemVersionResponse(data: unknown): {
|
|
9873
|
-
version: {
|
|
9874
|
-
id: string;
|
|
9875
|
-
version: number;
|
|
9876
|
-
content: string | null;
|
|
9877
|
-
contentHash: string;
|
|
9878
|
-
authorType: string;
|
|
9879
|
-
metadata?: {
|
|
9880
|
-
[x: string]: unknown;
|
|
9881
|
-
} | null | undefined;
|
|
9882
|
-
createdAt: string;
|
|
9883
|
-
};
|
|
9884
|
-
};
|
|
9885
7909
|
export declare function parseInboxArchiveRequest(data: unknown): {
|
|
9886
7910
|
ids: string[];
|
|
9887
7911
|
};
|
|
@@ -10140,7 +8164,7 @@ export declare function parseAgentCommentResponse(data: unknown): {
|
|
|
10140
8164
|
id: string;
|
|
10141
8165
|
threadId: string;
|
|
10142
8166
|
subject: {
|
|
10143
|
-
kind: "
|
|
8167
|
+
kind: "artifact" | "session";
|
|
10144
8168
|
id: string;
|
|
10145
8169
|
};
|
|
10146
8170
|
body: string;
|
|
@@ -10377,23 +8401,6 @@ export declare function parseSearchResponse(data: unknown): {
|
|
|
10377
8401
|
total: number;
|
|
10378
8402
|
narrowedBy: "narrowed-by-bundle-allowlist" | null;
|
|
10379
8403
|
hits: ({
|
|
10380
|
-
subjectKind: "item";
|
|
10381
|
-
itemId: string;
|
|
10382
|
-
guideId: string | null;
|
|
10383
|
-
itemName: string | null;
|
|
10384
|
-
workspaceId: string;
|
|
10385
|
-
workspaceName: string;
|
|
10386
|
-
itemChangedSince: boolean;
|
|
10387
|
-
matchedIn: "suggestion" | "body";
|
|
10388
|
-
approved?: boolean | undefined;
|
|
10389
|
-
commentId: string;
|
|
10390
|
-
threadId: string;
|
|
10391
|
-
authorKind: "agent" | "person" | "mossbear";
|
|
10392
|
-
resolved: boolean;
|
|
10393
|
-
createdAt: string;
|
|
10394
|
-
url?: string | undefined;
|
|
10395
|
-
excerpt: string;
|
|
10396
|
-
} | {
|
|
10397
8404
|
subjectKind: "artifact";
|
|
10398
8405
|
itemId: string;
|
|
10399
8406
|
guideId: string | null;
|
|
@@ -10474,5 +8481,4 @@ export declare function parseSearchResponse(data: unknown): {
|
|
|
10474
8481
|
note: string;
|
|
10475
8482
|
};
|
|
10476
8483
|
};
|
|
10477
|
-
export {};
|
|
10478
8484
|
//# sourceMappingURL=schemas.d.ts.map
|