@mossbear/protocol 0.1.0-alpha.88 → 0.1.0-alpha.90
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/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/schemas.d.ts +756 -2751
- package/dist/schemas.d.ts.map +1 -1
- package/dist/schemas.js +52 -340
- package/dist/schemas.js.map +1 -1
- package/dist/schemas.test.js +37 -144
- 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 +2 -2
package/dist/schemas.d.ts
CHANGED
|
@@ -60,6 +60,13 @@ export declare const GuideFileFormatSchema: v.PicklistSchema<["agents-md", "agen
|
|
|
60
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
|
+
export declare const PATH_ISSUE_MESSAGES: {
|
|
64
|
+
readonly backslash: "path must use forward slashes";
|
|
65
|
+
readonly absolute: "path must be relative";
|
|
66
|
+
readonly control: "path must not contain control characters";
|
|
67
|
+
readonly segments: "path must not contain empty, \".\" or \"..\" segments";
|
|
68
|
+
readonly skillMd: "path must not shadow the skill’s own SKILL.md";
|
|
69
|
+
};
|
|
63
70
|
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">]>;
|
|
64
71
|
export declare const SkillMemberPathSchema: v.SchemaWithPipe<readonly [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">]>, v.CheckAction<string, "path must not shadow the skill’s own SKILL.md">]>;
|
|
65
72
|
export declare const RawSkillMemberFileSchema: v.ObjectSchema<{
|
|
@@ -924,9 +931,23 @@ export declare const ListScopedTokensResponseSchema: v.ObjectSchema<{
|
|
|
924
931
|
export declare const RevokeScopedTokenRequestSchema: v.ObjectSchema<{
|
|
925
932
|
readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
926
933
|
}, undefined>;
|
|
927
|
-
|
|
928
|
-
|
|
929
|
-
|
|
934
|
+
/**
|
|
935
|
+
* The member to attach, by its artifact id. `itemId` is the name a CLI from before
|
|
936
|
+
* release step 2 sends; both are read, and the parsed value is always `artifactId`.
|
|
937
|
+
* Drop `itemId` once no such CLI is left to send it.
|
|
938
|
+
*/
|
|
939
|
+
export declare const AttachBundleMemberRequestSchema: v.SchemaWithPipe<readonly [v.ObjectSchema<{
|
|
940
|
+
readonly artifactId: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>;
|
|
941
|
+
readonly itemId: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>;
|
|
942
|
+
}, undefined>, v.CheckAction<{
|
|
943
|
+
artifactId?: string | undefined;
|
|
944
|
+
itemId?: string | undefined;
|
|
945
|
+
}, "A member needs an artifactId.">, v.TransformAction<{
|
|
946
|
+
artifactId?: string | undefined;
|
|
947
|
+
itemId?: string | undefined;
|
|
948
|
+
}, {
|
|
949
|
+
artifactId: string;
|
|
950
|
+
}>]>;
|
|
930
951
|
export declare const AttachBundleMemberResponseSchema: v.ObjectSchema<{
|
|
931
952
|
readonly attached: v.BooleanSchema<undefined>;
|
|
932
953
|
}, undefined>;
|
|
@@ -984,7 +1005,6 @@ export declare const ContextItemTypeSchema: v.PicklistSchema<string[], undefined
|
|
|
984
1005
|
* the release that moved the CLI's own vocabulary onto `content`.
|
|
985
1006
|
*/
|
|
986
1007
|
export declare const ContextItemTypeFilterSchema: v.PicklistSchema<string[], undefined>;
|
|
987
|
-
export declare const PushContentTypeSchema: v.PicklistSchema<("content" | "asset")[], undefined>;
|
|
988
1008
|
export declare const InboxContentTypeSchema: v.PicklistSchema<("content" | "asset")[], undefined>;
|
|
989
1009
|
export { MAX_CONTEXT_CONTENT_BYTES };
|
|
990
1010
|
/**
|
|
@@ -2054,727 +2074,96 @@ export declare const ContextItemsResponseSchema: v.ObjectSchema<{
|
|
|
2054
2074
|
}, undefined>, undefined>, undefined>;
|
|
2055
2075
|
}, undefined>;
|
|
2056
2076
|
/**
|
|
2057
|
-
*
|
|
2058
|
-
*
|
|
2059
|
-
* A repo's delivery set is the union of its committed subscriptions and the
|
|
2060
|
-
* reader's account ones, so this bounds a request, not a product limit: a
|
|
2061
|
-
* reader subscribing to more bundles than this asks in two calls rather than
|
|
2062
|
-
* losing the tail silently.
|
|
2063
|
-
*/
|
|
2064
|
-
export declare const MAX_COMMENT_BUNDLE_IDS = 100;
|
|
2065
|
-
/**
|
|
2066
|
-
* How many times one subscriber is told, in one repo, that a given comment is
|
|
2067
|
-
* waiting before the hook falls silent about it.
|
|
2068
|
-
*
|
|
2069
|
-
* **A cap on the interruption, never on the comment.** After it is reached the
|
|
2070
|
-
* comment is still open, still on the item page, and still returned in full by
|
|
2071
|
-
* the on-demand read — it simply stops being announced in front of the first
|
|
2072
|
-
* turn of every session. So silence here means "nothing new to interrupt you
|
|
2073
|
-
* about", never "nobody left anything".
|
|
2074
|
-
*
|
|
2075
|
-
* Three rather than one, for the reason the announcement exists: the first
|
|
2076
|
-
* session in a repo is often doing unrelated work, so a one-shot announcement
|
|
2077
|
-
* would routinely spend itself on the session least likely to act. Three is a
|
|
2078
|
-
* judgement, named so replacing it is one edit — the same discipline the live
|
|
2079
|
-
* session window is held to.
|
|
2080
|
-
*/
|
|
2081
|
-
export declare const MAX_COMMENT_ANNOUNCEMENTS_PER_REPO = 3;
|
|
2082
|
-
/**
|
|
2083
|
-
* Ask which comments are waiting for this reader in this repo, and be counted as
|
|
2084
|
-
* told.
|
|
2085
|
-
*
|
|
2086
|
-
* **A write, because being told is a fact the server has to keep.** The count
|
|
2087
|
-
* cannot be `item_comments.delivered_count` — that is one global number across
|
|
2088
|
-
* every subscriber and every repo, so one reader's fill of a comment would
|
|
2089
|
-
* silence it for everyone — and it cannot live in the checkout, because the
|
|
2090
|
-
* disposable environments this exists for rebuild the clone every session and
|
|
2091
|
-
* a counter there resets with it, announcing every unresolved comment as new
|
|
2092
|
-
* forever.
|
|
2093
|
-
*/
|
|
2094
|
-
export declare const AnnounceItemCommentsRequestSchema: v.ObjectSchema<{
|
|
2095
|
-
/**
|
|
2096
|
-
* The repo, as its committed config declares it. Required: it is the scope
|
|
2097
|
-
* the count is kept under, and a request with nothing to key on could only
|
|
2098
|
-
* be answered by an uncapped announcement — which is the repeating broadcast
|
|
2099
|
-
* this route exists to end.
|
|
2100
|
-
*/
|
|
2101
|
-
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">]>;
|
|
2102
|
-
/**
|
|
2103
|
-
* The bundles this repo receives — the union the caller already resolved.
|
|
2104
|
-
*
|
|
2105
|
-
* Sent rather than derived, because only half of it is the server's to know:
|
|
2106
|
-
* a repo-scoped subscription lives in the committed config and travels by
|
|
2107
|
-
* `git clone`. Declaring a bundle grants nothing: every one of them is still
|
|
2108
|
-
* filtered by the caller's own workspace membership.
|
|
2109
|
-
*/
|
|
2110
|
-
readonly bundleIds: v.SchemaWithPipe<readonly [v.ArraySchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>, v.MaxLengthAction<string[], 100, undefined>]>;
|
|
2111
|
-
}, undefined>;
|
|
2112
|
-
export type AnnounceItemCommentsRequest = v.InferOutput<typeof AnnounceItemCommentsRequestSchema>;
|
|
2113
|
-
/**
|
|
2114
|
-
* What an announcement answers: how many comments are waiting, and how many of
|
|
2115
|
-
* them this call was counted as announcing.
|
|
2116
|
-
*
|
|
2117
|
-
* **Two numbers because they answer two questions and a reader needs both.**
|
|
2118
|
-
* `open` is the true state of this repo's comments and is what a caller shows a
|
|
2119
|
-
* person — a number that is sometimes a subset of the truth would be worse
|
|
2120
|
-
* than the silence it replaced. `announced` is how many of those were still
|
|
2121
|
-
* under the cap, and it is the one that decides whether to speak at all: zero
|
|
2122
|
-
* means this reader has already been told about every one of them as often as
|
|
2123
|
-
* the cap allows.
|
|
2124
|
-
*/
|
|
2125
|
-
export declare const AnnounceItemCommentsResponseSchema: v.ObjectSchema<{
|
|
2126
|
-
/** Open, unmuted comments about the items these bundles deliver to this reader. */
|
|
2127
|
-
readonly open: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
|
|
2128
|
-
/** How many of those were under the cap and have now been counted as announced. */
|
|
2129
|
-
readonly announced: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
|
|
2130
|
-
}, undefined>;
|
|
2131
|
-
export type AnnounceItemCommentsResponse = v.InferOutput<typeof AnnounceItemCommentsResponseSchema>;
|
|
2132
|
-
/**
|
|
2133
|
-
* How many comments one agent session may leave on one subject, not counting its
|
|
2134
|
-
* whole-subject comment. Anchored comments and replies share it.
|
|
2135
|
-
*/
|
|
2136
|
-
export declare const MAX_AGENT_COMMENTS_PER_SUBJECT = 50;
|
|
2137
|
-
/** The longest an agent comment's text may be, in characters. */
|
|
2138
|
-
export declare const MAX_AGENT_COMMENT_BODY_CHARS = 4000;
|
|
2139
|
-
/**
|
|
2140
|
-
* Why an agent comment was refused, as the `code` on the error body. A caller
|
|
2141
|
-
* branches on these; the message beside one is for a person.
|
|
2142
|
-
*/
|
|
2143
|
-
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"];
|
|
2144
|
-
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>;
|
|
2145
|
-
export type AgentCommentErrorCode = v.InferOutput<typeof AgentCommentErrorCodeSchema>;
|
|
2146
|
-
/**
|
|
2147
|
-
* Leave a comment, or reply to one, as an agent (`POST /api/v1/context/comments`).
|
|
2148
|
-
*
|
|
2149
|
-
* **`target` names what the comment is about, one way.** `artifact` is the id
|
|
2150
|
-
* a bundle read gave for a guide or document, and `item` is its older name for
|
|
2151
|
-
* the same thing, accepted until every client sends `artifact`. `session` is an
|
|
2152
|
-
* agent session id of the caller's own (the key a search hit and the session digest hand out), and
|
|
2153
|
-
* `reply` is the id of a comment to answer. A reply joins that comment's thread
|
|
2154
|
-
* and the subject it is about.
|
|
2155
|
-
*
|
|
2156
|
-
* **Who the agent is comes from `agent`, and `sessionId` is the harness's own
|
|
2157
|
-
* id as the CLI read it.** A request without one is refused with
|
|
2158
|
-
* `agent_session_required`, and the CLI and tool offer no way to type one. The
|
|
2159
|
-
* server cannot check it against the harness, so it is a claim by the holder of
|
|
2160
|
-
* the token: the comment is always written under that token's account, and the
|
|
2161
|
-
* handle shown for it names a session only as far as the claim is true.
|
|
2162
|
-
*
|
|
2163
|
-
* **Text only.** There is no replacement-text field, and a request that carries
|
|
2164
|
-
* one is refused with `agent_comment_text_only` rather than having it dropped.
|
|
2165
|
-
*/
|
|
2166
|
-
export declare const AgentCommentRequestSchema: v.ObjectSchema<{
|
|
2167
|
-
readonly target: v.VariantSchema<"kind", [v.ObjectSchema<{
|
|
2168
|
-
readonly kind: v.LiteralSchema<"artifact", undefined>;
|
|
2169
|
-
readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 128, undefined>]>;
|
|
2170
|
-
}, undefined>, v.ObjectSchema<{
|
|
2171
|
-
readonly kind: v.LiteralSchema<"item", undefined>;
|
|
2172
|
-
readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 128, undefined>]>;
|
|
2173
|
-
}, undefined>, v.ObjectSchema<{
|
|
2174
|
-
readonly kind: v.LiteralSchema<"session", undefined>;
|
|
2175
|
-
readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 128, undefined>]>;
|
|
2176
|
-
}, undefined>, v.ObjectSchema<{
|
|
2177
|
-
readonly kind: v.LiteralSchema<"reply", undefined>;
|
|
2178
|
-
readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 128, undefined>]>;
|
|
2179
|
-
}, undefined>], undefined>;
|
|
2180
|
-
readonly body: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 4000, undefined>]>;
|
|
2181
|
-
/**
|
|
2182
|
-
* The passage an item comment is about, as the exact text of one or more whole
|
|
2183
|
-
* lines of the item (a paragraph, a heading, a list). None means the item as a
|
|
2184
|
-
* whole. The server finds the lines; a passage that is not in the item as it is
|
|
2185
|
-
* now is refused with `agent_comment_passage_not_found`.
|
|
2186
|
-
*/
|
|
2187
|
-
readonly passage: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 8000, undefined>]>, undefined>;
|
|
2188
|
-
readonly agent: v.ObjectSchema<{
|
|
2189
|
-
readonly sessionId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 128, undefined>]>;
|
|
2190
|
-
readonly harness: v.PicklistSchema<["claude_code", "codex", "antigravity", "opencode"], undefined>;
|
|
2191
|
-
/** The agent's own statement of its model, when it knows it. */
|
|
2192
|
-
readonly model: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 100, undefined>]>, undefined>;
|
|
2193
|
-
readonly cliVersion: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 64, undefined>]>, undefined>;
|
|
2194
|
-
}, undefined>;
|
|
2195
|
-
}, undefined>;
|
|
2196
|
-
export type AgentCommentRequest = v.InferOutput<typeof AgentCommentRequestSchema>;
|
|
2197
|
-
/**
|
|
2198
|
-
* The comment a create settled on. `created` is false when this agent session
|
|
2199
|
-
* already had a whole-subject comment on the subject: that comment comes back
|
|
2200
|
-
* unchanged and nothing was written.
|
|
2077
|
+
* The bundle pull under its artifact name: the same members and comments as
|
|
2078
|
+
* {@link ContextItemsResponseSchema}, under `artifacts`.
|
|
2201
2079
|
*/
|
|
2202
|
-
export declare const
|
|
2203
|
-
readonly
|
|
2204
|
-
readonly comment: v.ObjectSchema<{
|
|
2080
|
+
export declare const BundleArtifactsResponseSchema: v.ObjectSchema<{
|
|
2081
|
+
readonly artifacts: v.ArraySchema<v.SchemaWithPipe<readonly [v.ObjectSchema<{
|
|
2205
2082
|
readonly id: v.StringSchema<undefined>;
|
|
2206
|
-
readonly threadId: v.StringSchema<undefined>;
|
|
2207
|
-
readonly subject: v.ObjectSchema<{
|
|
2208
|
-
readonly kind: v.PicklistSchema<["artifact", "item", "session"], undefined>;
|
|
2209
|
-
readonly id: v.StringSchema<undefined>;
|
|
2210
|
-
}, undefined>;
|
|
2211
|
-
readonly body: v.StringSchema<undefined>;
|
|
2212
|
-
readonly createdAt: v.StringSchema<undefined>;
|
|
2213
|
-
}, undefined>;
|
|
2214
|
-
}, undefined>;
|
|
2215
|
-
export type AgentCommentResponse = v.InferOutput<typeof AgentCommentResponseSchema>;
|
|
2216
|
-
/**
|
|
2217
|
-
* One comment on the on-demand read, with the item it is about named on the comment.
|
|
2218
|
-
*
|
|
2219
|
-
* The item is named here rather than the comments riding an item, because this
|
|
2220
|
-
* read answers "what has been left for me" rather than "what is in this
|
|
2221
|
-
* bundle": there is no item payload to hang them off, and an agent that has to
|
|
2222
|
-
* ask for every item to find out whether one carries a comment is the round trip
|
|
2223
|
-
* the announcement exists to avoid.
|
|
2224
|
-
*/
|
|
2225
|
-
export declare const ItemCommentWithSubjectSchema: v.ObjectSchema<{
|
|
2226
|
-
/** The item the comment is about, as the wire names it. */
|
|
2227
|
-
readonly itemName: v.StringSchema<undefined>;
|
|
2228
|
-
/** The item's declared repo-relative path, or null when it has none. */
|
|
2229
|
-
readonly itemPath: v.NullableSchema<v.StringSchema<undefined>, undefined>;
|
|
2230
|
-
readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
2231
|
-
readonly state: v.OptionalSchema<v.PicklistSchema<["open", "resolved"], undefined>, undefined>;
|
|
2232
|
-
/** Current source location of an anchored passage, or its lost quote. */
|
|
2233
|
-
readonly passage: v.OptionalSchema<v.ObjectSchema<{
|
|
2234
|
-
readonly quote: v.StringSchema<undefined>;
|
|
2235
|
-
readonly status: v.PicklistSchema<["located", "changed", "orphaned"], undefined>;
|
|
2236
|
-
readonly lines: v.NullableSchema<v.ObjectSchema<{
|
|
2237
|
-
readonly start: v.NumberSchema<undefined>;
|
|
2238
|
-
readonly end: v.NumberSchema<undefined>;
|
|
2239
|
-
}, undefined>, undefined>;
|
|
2240
|
-
}, undefined>, undefined>;
|
|
2241
|
-
/** The comment's text, already wrapped in the response's untrusted markers. */
|
|
2242
|
-
readonly body: v.StringSchema<undefined>;
|
|
2243
|
-
/**
|
|
2244
|
-
* A suggested edit: the replacement for the passage at `passage.lines`,
|
|
2245
|
-
* already wrapped in the response's untrusted markers like `body`. An
|
|
2246
|
-
* insertion is the passage plus its new lines and an empty replacement is a
|
|
2247
|
-
* deletion, so every edit is one replace. Absent on an ordinary comment.
|
|
2248
|
-
*/
|
|
2249
|
-
readonly suggestion: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
|
|
2250
|
-
/**
|
|
2251
|
-
* What a comment Mossbear wrote is: a finding about the item, never an edit.
|
|
2252
|
-
* Present only on a Mossbear comment. The comment's `body` begins with the
|
|
2253
|
-
* claim (what goes wrong); this carries what the claim rests on.
|
|
2254
|
-
*/
|
|
2255
|
-
readonly finding: v.OptionalSchema<v.ObjectSchema<{
|
|
2256
|
-
readonly tier: v.PicklistSchema<["observed", "usage", "practice"], undefined>;
|
|
2257
|
-
/** How the finding is known, in one line: "Seen in 3 sessions (2026-09-15 – 2026-10-03)". */
|
|
2258
|
-
readonly tierLine: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 300, undefined>]>;
|
|
2259
|
-
/** What the drafter did not read, fixed per tier. */
|
|
2260
|
-
readonly blindSpot: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 300, undefined>]>;
|
|
2261
|
-
/** What should change in later sessions if the finding is fixed, wrapped in the untrusted markers. */
|
|
2262
|
-
readonly prediction: v.NullableSchema<v.StringSchema<undefined>, undefined>;
|
|
2263
|
-
}, undefined>, undefined>;
|
|
2264
|
-
/**
|
|
2265
|
-
* Whether the person approved a comment Mossbear drafted. Present on every
|
|
2266
|
-
* Mossbear comment and absent on a person's or an agent's, which are
|
|
2267
|
-
* requests as written. `false` is a draft nobody has read yet: a reader shows
|
|
2268
|
-
* it to the user and acts only on their go-ahead. Only a client that reports
|
|
2269
|
-
* a version able to mark drafts is ever listed one, so an older reader that
|
|
2270
|
-
* strips this field never receives a draft it would print as a request.
|
|
2271
|
-
*/
|
|
2272
|
-
readonly approved: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
|
|
2273
|
-
/** The author's display name as the workspace shows it, or null. Never an email. */
|
|
2274
|
-
readonly authorName: v.NullableSchema<v.StringSchema<undefined>, undefined>;
|
|
2275
|
-
/** ISO timestamp, machine format. */
|
|
2276
|
-
readonly createdAt: v.StringSchema<undefined>;
|
|
2277
|
-
/** The item's content version the comment was written against. */
|
|
2278
|
-
readonly itemVersion: v.NumberSchema<undefined>;
|
|
2279
|
-
/** True when the item's current version is greater than `itemVersion`. */
|
|
2280
|
-
readonly itemChangedSince: v.BooleanSchema<undefined>;
|
|
2281
|
-
/**
|
|
2282
|
-
* How many agent reads were handed this comment **before** this one — so a
|
|
2283
|
-
* comment reaching an agent for the first time reports `0`.
|
|
2284
|
-
*
|
|
2285
|
-
* It is the stored count as it read at the moment the response was built;
|
|
2286
|
-
* the serve this response *is* has not been counted yet. Excluded rather
|
|
2287
|
-
* than included because the count is recorded best-effort: a response that
|
|
2288
|
-
* claimed to include itself would be wrong whenever that record failed, and
|
|
2289
|
-
* a number that is sometimes off by one is worse than one that is
|
|
2290
|
-
* consistently the prior total.
|
|
2291
|
-
*
|
|
2292
|
-
* So `deliveredCount > 0` means an earlier read was handed this comment, and
|
|
2293
|
-
* `0` means this read is the first. Neither says a model took it in — only
|
|
2294
|
-
* that the server handed it over.
|
|
2295
|
-
*/
|
|
2296
|
-
readonly deliveredCount: v.NumberSchema<undefined>;
|
|
2297
|
-
/**
|
|
2298
|
-
* This comment's thread root — its own id for every delivered root. Resolution
|
|
2299
|
-
* replies remain on the dashboard thread and are not delivered to agents.
|
|
2300
|
-
* It is on the wire from the first response
|
|
2301
|
-
* because the wire contract is consumed by installed CLI versions: reshaping
|
|
2302
|
-
* a flat `comments` array into threads-of-comments later would be a breaking
|
|
2303
|
-
* change, while a field today's readers ignore costs them nothing.
|
|
2304
|
-
*/
|
|
2305
|
-
readonly threadId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
2306
|
-
/**
|
|
2307
|
-
* Always `null` for a delivered root. Present so an older reader meeting a
|
|
2308
|
-
* future response that carries real replies degrades to
|
|
2309
|
-
* "a flat list of comments" rather than failing to parse.
|
|
2310
|
-
*/
|
|
2311
|
-
readonly replyToId: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>;
|
|
2312
|
-
}, undefined>;
|
|
2313
|
-
export type ItemCommentWithSubject = v.InferOutput<typeof ItemCommentWithSubjectSchema>;
|
|
2314
|
-
/**
|
|
2315
|
-
* Every open comment waiting for this reader across the bundles they named.
|
|
2316
|
-
*
|
|
2317
|
-
* **This read is a delivery and is counted as one**, exactly as comments riding
|
|
2318
|
-
* an item are: a body reached an agent. What it is *not* is an announcement —
|
|
2319
|
-
* nothing here touches the per-repo announcement count, so asking to read your
|
|
2320
|
-
* comments never spends the interruptions the hook is allowed.
|
|
2321
|
-
*
|
|
2322
|
-
* **Never capped.** The announcement cap governs whether a hook speaks; a
|
|
2323
|
-
* reader who asked is owed every open comment, and hiding one here would retire a
|
|
2324
|
-
* person's request without anybody deciding to.
|
|
2325
|
-
*/
|
|
2326
|
-
export declare const ItemCommentsResponseSchema: v.ObjectSchema<{
|
|
2327
|
-
readonly comments: v.ArraySchema<v.ObjectSchema<{
|
|
2328
|
-
/** The item the comment is about, as the wire names it. */
|
|
2329
|
-
readonly itemName: v.StringSchema<undefined>;
|
|
2330
|
-
/** The item's declared repo-relative path, or null when it has none. */
|
|
2331
|
-
readonly itemPath: v.NullableSchema<v.StringSchema<undefined>, undefined>;
|
|
2332
|
-
readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
2333
|
-
readonly state: v.OptionalSchema<v.PicklistSchema<["open", "resolved"], undefined>, undefined>;
|
|
2334
|
-
/** Current source location of an anchored passage, or its lost quote. */
|
|
2335
|
-
readonly passage: v.OptionalSchema<v.ObjectSchema<{
|
|
2336
|
-
readonly quote: v.StringSchema<undefined>;
|
|
2337
|
-
readonly status: v.PicklistSchema<["located", "changed", "orphaned"], undefined>;
|
|
2338
|
-
readonly lines: v.NullableSchema<v.ObjectSchema<{
|
|
2339
|
-
readonly start: v.NumberSchema<undefined>;
|
|
2340
|
-
readonly end: v.NumberSchema<undefined>;
|
|
2341
|
-
}, undefined>, undefined>;
|
|
2342
|
-
}, undefined>, undefined>;
|
|
2343
|
-
/** The comment's text, already wrapped in the response's untrusted markers. */
|
|
2344
|
-
readonly body: v.StringSchema<undefined>;
|
|
2345
2083
|
/**
|
|
2346
|
-
*
|
|
2347
|
-
*
|
|
2348
|
-
*
|
|
2349
|
-
*
|
|
2084
|
+
* The id every artifact route addresses: the body file's id for a guide
|
|
2085
|
+
* (null only for a guide with no body yet), the item's own id otherwise.
|
|
2086
|
+
* Optional so a client tolerates a server that predates it, and one that
|
|
2087
|
+
* stops sending it (the item id is the artifact id).
|
|
2350
2088
|
*/
|
|
2351
|
-
readonly
|
|
2089
|
+
readonly artifactId: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
|
|
2352
2090
|
/**
|
|
2353
|
-
*
|
|
2354
|
-
*
|
|
2355
|
-
*
|
|
2091
|
+
* Leaving the wire: a reader tells a guide from content by `role` and the
|
|
2092
|
+
* guide fields, not by this. Optional so a client parses a server that no
|
|
2093
|
+
* longer sends it.
|
|
2356
2094
|
*/
|
|
2357
|
-
readonly
|
|
2358
|
-
|
|
2359
|
-
/** How the finding is known, in one line: "Seen in 3 sessions (2026-09-15 – 2026-10-03)". */
|
|
2360
|
-
readonly tierLine: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 300, undefined>]>;
|
|
2361
|
-
/** What the drafter did not read, fixed per tier. */
|
|
2362
|
-
readonly blindSpot: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 300, undefined>]>;
|
|
2363
|
-
/** What should change in later sessions if the finding is fixed, wrapped in the untrusted markers. */
|
|
2364
|
-
readonly prediction: v.NullableSchema<v.StringSchema<undefined>, undefined>;
|
|
2365
|
-
}, undefined>, undefined>;
|
|
2095
|
+
readonly type: v.OptionalSchema<v.PicklistSchema<string[], undefined>, undefined>;
|
|
2096
|
+
readonly name: v.StringSchema<undefined>;
|
|
2366
2097
|
/**
|
|
2367
|
-
*
|
|
2368
|
-
*
|
|
2369
|
-
*
|
|
2370
|
-
*
|
|
2371
|
-
*
|
|
2372
|
-
*
|
|
2098
|
+
* The stored `(role, format)` pair, as two bare nullable strings.
|
|
2099
|
+
*
|
|
2100
|
+
* **Both are deliberately unenumerated.** A client switches on one value it
|
|
2101
|
+
* cares about — `role === 'criteria'` is how a rubric is told from ordinary
|
|
2102
|
+
* prose, which `type` cannot say because a rubric serializes as a `document` —
|
|
2103
|
+
* and a server that adds a fourth role or a fifth format must not break a
|
|
2104
|
+
* client that has never heard of it. Narrowing them here would make every such
|
|
2105
|
+
* addition a breaking wire change for no reader's benefit.
|
|
2106
|
+
*
|
|
2107
|
+
* Null on exactly the rows that carry no content: a tombstone, and an alias.
|
|
2108
|
+
* A `guide` item has no pair at all — it is a different table — and reports
|
|
2109
|
+
* both as null.
|
|
2373
2110
|
*/
|
|
2374
|
-
readonly
|
|
2375
|
-
|
|
2376
|
-
readonly
|
|
2377
|
-
|
|
2378
|
-
readonly
|
|
2379
|
-
/** The item's content version the comment was written against. */
|
|
2380
|
-
readonly itemVersion: v.NumberSchema<undefined>;
|
|
2381
|
-
/** True when the item's current version is greater than `itemVersion`. */
|
|
2382
|
-
readonly itemChangedSince: v.BooleanSchema<undefined>;
|
|
2111
|
+
readonly role: v.NullableSchema<v.StringSchema<undefined>, undefined>;
|
|
2112
|
+
readonly format: v.NullableSchema<v.StringSchema<undefined>, undefined>;
|
|
2113
|
+
readonly content: v.NullableSchema<v.StringSchema<undefined>, undefined>;
|
|
2114
|
+
readonly origin: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
|
|
2115
|
+
readonly version: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
|
|
2383
2116
|
/**
|
|
2384
|
-
*
|
|
2385
|
-
*
|
|
2117
|
+
* The guide a **derived** item belongs to — its evaluation criteria, or a
|
|
2118
|
+
* skill's member files (`subscription-delivery-target-plan.md` → slice 4).
|
|
2386
2119
|
*
|
|
2387
|
-
*
|
|
2388
|
-
* the
|
|
2389
|
-
* than included because the count is recorded best-effort: a response that
|
|
2390
|
-
* claimed to include itself would be wrong whenever that record failed, and
|
|
2391
|
-
* a number that is sometimes off by one is worse than one that is
|
|
2392
|
-
* consistently the prior total.
|
|
2120
|
+
* Absent on everything else, including a guide itself: a guide member is
|
|
2121
|
+
* addressed by the guide's own id, so `id` already answers this for it.
|
|
2393
2122
|
*
|
|
2394
|
-
*
|
|
2395
|
-
*
|
|
2396
|
-
*
|
|
2123
|
+
* It exists because derived items have no bundle membership and no id of their
|
|
2124
|
+
* guide's — they are `guide_files` rows attached by `guide_id` — so a rule
|
|
2125
|
+
* expressed over guide ids (a subscriber's mute) cannot reach them from the
|
|
2126
|
+
* item alone. Muting a skill and still delivering its `scripts/` would leave a
|
|
2127
|
+
* broken half-skill on disk, which is worse than not muting at all.
|
|
2397
2128
|
*/
|
|
2398
|
-
readonly
|
|
2129
|
+
readonly guideId: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
|
|
2130
|
+
readonly root: v.OptionalSchema<v.NullableSchema<v.PicklistSchema<["project", "global"], undefined>, undefined>, undefined>;
|
|
2131
|
+
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>;
|
|
2132
|
+
readonly projectId: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
|
|
2399
2133
|
/**
|
|
2400
|
-
*
|
|
2401
|
-
*
|
|
2402
|
-
*
|
|
2403
|
-
*
|
|
2404
|
-
*
|
|
2405
|
-
*
|
|
2134
|
+
* The repo a **document's** declared `path` is placed in — its home — as the
|
|
2135
|
+
* `project.id` of the checkout that last set the path. Documents only.
|
|
2136
|
+
*
|
|
2137
|
+
* Deliberately not `projectId` above: a reader takes a mismatch there as "this
|
|
2138
|
+
* item belongs to another repo, do not materialize it", so a home echoed on it
|
|
2139
|
+
* would stop every other subscriber receiving the document at all. A home says
|
|
2140
|
+
* only *where* the path is literal. Only the repo whose `project.id` matches
|
|
2141
|
+
* writes the document at `path`; every other repo mirrors it under the
|
|
2142
|
+
* bundle folder (`bundleMirrorPath` in `@mossbear/projections`).
|
|
2143
|
+
*
|
|
2144
|
+
* Absent and null read the same — **no home**, so no repo takes the path
|
|
2145
|
+
* literally for a new placement. A server predating the field says the same,
|
|
2146
|
+
* which is the safe direction: the file lands inside the bundle folder
|
|
2147
|
+
* instead of at a repo path it may not belong in.
|
|
2406
2148
|
*/
|
|
2407
|
-
readonly
|
|
2149
|
+
readonly pathProjectId: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
|
|
2150
|
+
readonly aliases: v.OptionalSchema<v.SchemaWithPipe<readonly [v.ArraySchema<v.ObjectSchema<{
|
|
2151
|
+
readonly root: v.PicklistSchema<["project", "global"], undefined>;
|
|
2152
|
+
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">]>;
|
|
2153
|
+
}, undefined>, undefined>, v.MaxLengthAction<{
|
|
2154
|
+
root: "project" | "global";
|
|
2155
|
+
path: string;
|
|
2156
|
+
}[], 8, undefined>]>, undefined>;
|
|
2408
2157
|
/**
|
|
2409
|
-
*
|
|
2410
|
-
*
|
|
2411
|
-
*
|
|
2412
|
-
|
|
2413
|
-
|
|
2414
|
-
|
|
2415
|
-
|
|
2416
|
-
|
|
2417
|
-
|
|
2418
|
-
* they mean. Present exactly when at least one comment came back.
|
|
2419
|
-
*/
|
|
2420
|
-
readonly untrusted: v.OptionalSchema<v.NullableSchema<v.ObjectSchema<{
|
|
2421
|
-
readonly token: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
2422
|
-
readonly startMarker: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
2423
|
-
readonly endMarker: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
2424
|
-
readonly note: v.StringSchema<undefined>;
|
|
2425
|
-
}, undefined>, undefined>, undefined>;
|
|
2426
|
-
}, undefined>;
|
|
2427
|
-
export type ItemCommentsResponse = v.InferOutput<typeof ItemCommentsResponseSchema>;
|
|
2428
|
-
/**
|
|
2429
|
-
* The evidence behind one Mossbear finding an agent was handed
|
|
2430
|
-
* (`GET /api/v1/context/comments/evidence`).
|
|
2431
|
-
*
|
|
2432
|
-
* `list_comments` carries the claim and a one-line tier; this is the finding
|
|
2433
|
-
* in full: the claim, the change it predicts in future sessions, what the
|
|
2434
|
-
* drafter did not read, and the evidence for its tier. Readable only through a
|
|
2435
|
-
* comment the comment read itself would deliver to this reader, so another
|
|
2436
|
-
* person's finding, one drafted from another repo, or a draft listed only to a
|
|
2437
|
-
* newer client has no evidence here either. A draft the reader was listed
|
|
2438
|
-
* does: an agent can say why it was raised before the person approves it.
|
|
2439
|
-
*
|
|
2440
|
-
* Citations (observed and usage findings) are reduced to what the reader may
|
|
2441
|
-
* see: their own sessions, with a date and a short excerpt of the grader's
|
|
2442
|
-
* reasoning or of their own redacted correction turn. A `navigation` citation
|
|
2443
|
-
* has an empty excerpt: it is dated evidence that a session loaded the skill,
|
|
2444
|
-
* and nothing more. `citationsWithheld` counts any that were dropped, so a
|
|
2445
|
-
* short list is never mistaken for the whole of it.
|
|
2446
|
-
*/
|
|
2447
|
-
export declare const CommentEvidenceCitationSchema: v.ObjectSchema<{
|
|
2448
|
-
/**
|
|
2449
|
-
* `navigation` is a skill load counted when a finding was drafted from how
|
|
2450
|
-
* the skill's files were read: evidence of how a skill was used, not of a
|
|
2451
|
-
* failure. `action` is a recorded step of a workflow repeated across
|
|
2452
|
-
* sessions. A server sends it only to a client that names a version new
|
|
2453
|
-
* enough to parse it.
|
|
2454
|
-
*/
|
|
2455
|
-
readonly kind: v.PicklistSchema<["verdict", "turn", "navigation", "action"], undefined>;
|
|
2456
|
-
readonly sessionId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
2457
|
-
/** ISO, when the verdict was graded, the turn was said, the skill loaded, or the action was recorded. */
|
|
2458
|
-
readonly at: v.StringSchema<undefined>;
|
|
2459
|
-
/** Wrapped in the response's untrusted markers. */
|
|
2460
|
-
readonly excerpt: v.StringSchema<undefined>;
|
|
2461
|
-
}, undefined>;
|
|
2462
|
-
export type CommentEvidenceCitation = v.InferOutput<typeof CommentEvidenceCitationSchema>;
|
|
2463
|
-
/** What a usage finding adds to its citations: the counts for one reference file. */
|
|
2464
|
-
export declare const CommentEvidenceUsageSchema: v.ObjectSchema<{
|
|
2465
|
-
/** The reference's skill-relative path, wrapped in the response's untrusted markers. */
|
|
2466
|
-
readonly path: v.StringSchema<undefined>;
|
|
2467
|
-
/** Eligible loads of the skill. */
|
|
2468
|
-
readonly loads: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>]>;
|
|
2469
|
-
/** Distinct sessions those loads span. */
|
|
2470
|
-
readonly sessions: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>]>;
|
|
2471
|
-
/** Loads followed by a successful read of the reference. */
|
|
2472
|
-
readonly loadsWithRead: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>]>;
|
|
2473
|
-
}, undefined>;
|
|
2474
|
-
/**
|
|
2475
|
-
* What a practice finding adds: the rubric check it answers and the rubric's
|
|
2476
|
-
* version, the practice lines it weighs with their sources, the facts measured
|
|
2477
|
-
* from the file, and the answer to each item of evidence the check asks for.
|
|
2478
|
-
* `answers[].answer` is model-written, so it travels wrapped in the response's
|
|
2479
|
-
* untrusted markers.
|
|
2480
|
-
*/
|
|
2481
|
-
export declare const CommentEvidencePracticeSchema: v.ObjectSchema<{
|
|
2482
|
-
readonly check: v.ObjectSchema<{
|
|
2483
|
-
readonly id: v.StringSchema<undefined>;
|
|
2484
|
-
readonly name: v.StringSchema<undefined>;
|
|
2485
|
-
}, undefined>;
|
|
2486
|
-
readonly rubricVersion: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>]>;
|
|
2487
|
-
readonly practices: v.OptionalSchema<v.ArraySchema<v.ObjectSchema<{
|
|
2488
|
-
readonly text: v.StringSchema<undefined>;
|
|
2489
|
-
readonly source: v.ObjectSchema<{
|
|
2490
|
-
readonly title: v.StringSchema<undefined>;
|
|
2491
|
-
readonly url: v.StringSchema<undefined>;
|
|
2492
|
-
}, undefined>;
|
|
2493
|
-
}, undefined>, undefined>, readonly []>;
|
|
2494
|
-
readonly facts: v.OptionalSchema<v.ArraySchema<v.StringSchema<undefined>, undefined>, readonly []>;
|
|
2495
|
-
readonly answers: v.OptionalSchema<v.ArraySchema<v.ObjectSchema<{
|
|
2496
|
-
readonly item: v.StringSchema<undefined>;
|
|
2497
|
-
readonly answer: v.StringSchema<undefined>;
|
|
2498
|
-
}, undefined>, undefined>, readonly []>;
|
|
2499
|
-
}, undefined>;
|
|
2500
|
-
/**
|
|
2501
|
-
* A comment the person (or Mossbear) left on one of the sessions a finding
|
|
2502
|
-
* cites — the person's own account of what the agent should have known, set
|
|
2503
|
-
* beside the grader's excerpt (`guide-findings-plan.md` → Your note on a
|
|
2504
|
-
* session).
|
|
2505
|
-
*
|
|
2506
|
-
* **Reachable only here.** A comment about a session is never listed by
|
|
2507
|
-
* `list_comments` or announced at session start: it is context for a finding,
|
|
2508
|
-
* found by following the finding's citation, not a request.
|
|
2509
|
-
*/
|
|
2510
|
-
export declare const CommentEvidenceSessionCommentSchema: v.ObjectSchema<{
|
|
2511
|
-
readonly sessionId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
2512
|
-
/** Only the person's own notes are sent today; `mossbear` is reserved. */
|
|
2513
|
-
readonly authorKind: v.PicklistSchema<["person", "mossbear"], undefined>;
|
|
2514
|
-
/** ISO, when the comment was written. */
|
|
2515
|
-
readonly at: v.StringSchema<undefined>;
|
|
2516
|
-
/** Wrapped in the response's untrusted markers. */
|
|
2517
|
-
readonly body: v.StringSchema<undefined>;
|
|
2518
|
-
}, undefined>;
|
|
2519
|
-
export type CommentEvidenceSessionComment = v.InferOutput<typeof CommentEvidenceSessionCommentSchema>;
|
|
2520
|
-
export declare const CommentEvidenceResponseSchema: v.ObjectSchema<{
|
|
2521
|
-
/** The comment's full id, even when the request named a prefix. */
|
|
2522
|
-
readonly commentId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
2523
|
-
readonly itemName: v.StringSchema<undefined>;
|
|
2524
|
-
readonly itemPath: v.NullableSchema<v.StringSchema<undefined>, undefined>;
|
|
2525
|
-
readonly tier: v.PicklistSchema<["observed", "usage", "practice"], undefined>;
|
|
2526
|
-
/** One line saying how the finding is known; server-written, outside the markers. */
|
|
2527
|
-
readonly tierLine: v.StringSchema<undefined>;
|
|
2528
|
-
/** What the drafter did not read; server-written, outside the markers. */
|
|
2529
|
-
readonly blindSpot: v.StringSchema<undefined>;
|
|
2530
|
-
/** What goes wrong, wrapped in the response's untrusted markers. */
|
|
2531
|
-
readonly claim: v.StringSchema<undefined>;
|
|
2532
|
-
/** What future sessions should show if the finding is fixed, wrapped; null if none. */
|
|
2533
|
-
readonly prediction: v.NullableSchema<v.StringSchema<undefined>, undefined>;
|
|
2534
|
-
/** A usage finding's counts; null on every other tier. */
|
|
2535
|
-
readonly usage: v.NullableSchema<v.ObjectSchema<{
|
|
2536
|
-
/** The reference's skill-relative path, wrapped in the response's untrusted markers. */
|
|
2537
|
-
readonly path: v.StringSchema<undefined>;
|
|
2538
|
-
/** Eligible loads of the skill. */
|
|
2539
|
-
readonly loads: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>]>;
|
|
2540
|
-
/** Distinct sessions those loads span. */
|
|
2541
|
-
readonly sessions: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>]>;
|
|
2542
|
-
/** Loads followed by a successful read of the reference. */
|
|
2543
|
-
readonly loadsWithRead: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>]>;
|
|
2544
|
-
}, undefined>, undefined>;
|
|
2545
|
-
/** A practice finding's rubric check; null on every other tier. */
|
|
2546
|
-
readonly practice: v.NullableSchema<v.ObjectSchema<{
|
|
2547
|
-
readonly check: v.ObjectSchema<{
|
|
2548
|
-
readonly id: v.StringSchema<undefined>;
|
|
2549
|
-
readonly name: v.StringSchema<undefined>;
|
|
2550
|
-
}, undefined>;
|
|
2551
|
-
readonly rubricVersion: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>]>;
|
|
2552
|
-
readonly practices: v.OptionalSchema<v.ArraySchema<v.ObjectSchema<{
|
|
2553
|
-
readonly text: v.StringSchema<undefined>;
|
|
2554
|
-
readonly source: v.ObjectSchema<{
|
|
2555
|
-
readonly title: v.StringSchema<undefined>;
|
|
2556
|
-
readonly url: v.StringSchema<undefined>;
|
|
2557
|
-
}, undefined>;
|
|
2558
|
-
}, undefined>, undefined>, readonly []>;
|
|
2559
|
-
readonly facts: v.OptionalSchema<v.ArraySchema<v.StringSchema<undefined>, undefined>, readonly []>;
|
|
2560
|
-
readonly answers: v.OptionalSchema<v.ArraySchema<v.ObjectSchema<{
|
|
2561
|
-
readonly item: v.StringSchema<undefined>;
|
|
2562
|
-
readonly answer: v.StringSchema<undefined>;
|
|
2563
|
-
}, undefined>, undefined>, readonly []>;
|
|
2564
|
-
}, undefined>, undefined>;
|
|
2565
|
-
readonly citations: v.ArraySchema<v.ObjectSchema<{
|
|
2566
|
-
/**
|
|
2567
|
-
* `navigation` is a skill load counted when a finding was drafted from how
|
|
2568
|
-
* the skill's files were read: evidence of how a skill was used, not of a
|
|
2569
|
-
* failure. `action` is a recorded step of a workflow repeated across
|
|
2570
|
-
* sessions. A server sends it only to a client that names a version new
|
|
2571
|
-
* enough to parse it.
|
|
2572
|
-
*/
|
|
2573
|
-
readonly kind: v.PicklistSchema<["verdict", "turn", "navigation", "action"], undefined>;
|
|
2574
|
-
readonly sessionId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
2575
|
-
/** ISO, when the verdict was graded, the turn was said, the skill loaded, or the action was recorded. */
|
|
2576
|
-
readonly at: v.StringSchema<undefined>;
|
|
2577
|
-
/** Wrapped in the response's untrusted markers. */
|
|
2578
|
-
readonly excerpt: v.StringSchema<undefined>;
|
|
2579
|
-
}, undefined>, undefined>;
|
|
2580
|
-
readonly citationsWithheld: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>]>;
|
|
2581
|
-
/**
|
|
2582
|
-
* Comments on the cited sessions, newest first, wrapped in the untrusted
|
|
2583
|
-
* markers. Defaulted so a response from a server that predates the field
|
|
2584
|
-
* still parses.
|
|
2585
|
-
*/
|
|
2586
|
-
readonly sessionComments: v.OptionalSchema<v.ArraySchema<v.ObjectSchema<{
|
|
2587
|
-
readonly sessionId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
2588
|
-
/** Only the person's own notes are sent today; `mossbear` is reserved. */
|
|
2589
|
-
readonly authorKind: v.PicklistSchema<["person", "mossbear"], undefined>;
|
|
2590
|
-
/** ISO, when the comment was written. */
|
|
2591
|
-
readonly at: v.StringSchema<undefined>;
|
|
2592
|
-
/** Wrapped in the response's untrusted markers. */
|
|
2593
|
-
readonly body: v.StringSchema<undefined>;
|
|
2594
|
-
}, undefined>, undefined>, readonly []>;
|
|
2595
|
-
/**
|
|
2596
|
-
* Comments on the cited sessions that were left out to keep the response
|
|
2597
|
-
* bounded (the newest few per session are sent), so a short list is never
|
|
2598
|
-
* mistaken for the whole of it. Zero when none were.
|
|
2599
|
-
*/
|
|
2600
|
-
readonly sessionCommentsWithheld: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>]>, 0>;
|
|
2601
|
-
readonly untrusted: v.ObjectSchema<{
|
|
2602
|
-
readonly token: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
2603
|
-
readonly startMarker: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
2604
|
-
readonly endMarker: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
2605
|
-
readonly note: v.StringSchema<undefined>;
|
|
2606
|
-
}, undefined>;
|
|
2607
|
-
}, undefined>;
|
|
2608
|
-
export type CommentEvidenceResponse = v.InferOutput<typeof CommentEvidenceResponseSchema>;
|
|
2609
|
-
/** Max number of context item ids a push may cite as its transform sources. */
|
|
2610
|
-
export declare const MAX_TRANSFORM_SOURCE_IDS = 100;
|
|
2611
|
-
/**
|
|
2612
|
-
* The ids of the caller-owned context items a pushed document was produced
|
|
2613
|
-
* from (inbox captures, bundle items — any item the caller owns). Shared
|
|
2614
|
-
* between the REST contract and the MCP tool's client-side arg validation so
|
|
2615
|
-
* the two can't drift.
|
|
2616
|
-
*/
|
|
2617
|
-
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>]>;
|
|
2618
|
-
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>]>;
|
|
2619
|
-
export declare const PushContextRequestSchema: v.ObjectSchema<{
|
|
2620
|
-
readonly name: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 200, undefined>]>;
|
|
2621
|
-
readonly contentType: v.PicklistSchema<("content" | "asset")[], undefined>;
|
|
2622
|
-
readonly content: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.CheckAction<string, "content must be at most 262144 bytes">]>;
|
|
2623
|
-
readonly itemId: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
|
|
2624
|
-
readonly origin: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
|
|
2625
|
-
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>;
|
|
2626
|
-
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>;
|
|
2627
|
-
/**
|
|
2628
|
-
* The committed `project.id` of the checkout this write comes from, when it
|
|
2629
|
-
* has one (`subscription-delivery-target-plan.md` → slice 3).
|
|
2630
|
-
*
|
|
2631
|
-
* It answers two questions, both about the writer's checkout:
|
|
2632
|
-
*
|
|
2633
|
-
* - **Is this write coming from the repo that owns these items?** Only a
|
|
2634
|
-
* bundle that claims a home asks. A request that declares nothing — every
|
|
2635
|
-
* dashboard edit — is not the home repo and is refused by name. Declaring an
|
|
2636
|
-
* id grants nothing on its own: an unclaimed bundle ignores it for this
|
|
2637
|
-
* purpose, and the caller must already be a member of the bundle's workspace
|
|
2638
|
-
* to reach this route at all.
|
|
2639
|
-
* - **Which repo is `path` placed in?** Stored beside `path` as the item's
|
|
2640
|
-
* home, so the one repo that declared the path can hold the document there
|
|
2641
|
-
* literally while every other subscriber mirrors it. Ignored without a
|
|
2642
|
-
* `path`: a home places nothing when there is no path to place.
|
|
2643
|
-
*
|
|
2644
|
-
* **The stored home is not echoed back as `ContextItemSchema.projectId`.**
|
|
2645
|
-
* That field tells a reader an item belongs to one repo and is not to be
|
|
2646
|
-
* materialized anywhere else; a document's home only says where it lands.
|
|
2647
|
-
*
|
|
2648
|
-
* Parsed as {@link DeclaredProjectIdSchema} — the CLI config reader's own
|
|
2649
|
-
* rule, trimmed and non-empty, and no stricter — so the stored home
|
|
2650
|
-
* round-trips against the value a checkout reads.
|
|
2651
|
-
*/
|
|
2652
|
-
readonly projectId: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>]>, undefined>;
|
|
2653
|
-
/**
|
|
2654
|
-
* Where the committed bytes in `content` came from, when this write is a
|
|
2655
|
-
* publication (`artifact-ownership-and-delivery-plan.md` → slice 3). Present
|
|
2656
|
-
* means git owns the resulting artifact: the commit is the authority and
|
|
2657
|
-
* Mossbear distributes the revision rather than keeping a second editable
|
|
2658
|
-
* copy.
|
|
2659
|
-
*
|
|
2660
|
-
* **Sending it is a claim about provenance, not an authorization.** The
|
|
2661
|
-
* server still answers who may write here from bundle membership and the
|
|
2662
|
-
* bundle's declared home, exactly as it does for `projectId` above; what this
|
|
2663
|
-
* adds is the revision the bytes were read from, so a subscriber can answer
|
|
2664
|
-
* "what did I get".
|
|
2665
|
-
*
|
|
2666
|
-
* **`path` is required alongside it and the route enforces that**, because
|
|
2667
|
-
* the database will: `guide_files_git_source_subset` admits only "repo id +
|
|
2668
|
-
* path + sha all present" or the whole group absent, so a publication that
|
|
2669
|
-
* named no path would fail at insert time with a constraint error instead of
|
|
2670
|
-
* a sentence. Refused in the route rather than restated as a wire rule, for
|
|
2671
|
-
* the reason `ContextItemSchema.gitSource` gives — a path this schema cannot
|
|
2672
|
-
* parse is one item's problem, not the response's.
|
|
2673
|
-
*/
|
|
2674
|
-
readonly gitSource: v.OptionalSchema<v.ObjectSchema<{
|
|
2675
|
-
/**
|
|
2676
|
-
* The committed `project.id` of the source repository — the same id space as
|
|
2677
|
-
* an item's delivery-scoping `projectId` below, but a different fact: that one
|
|
2678
|
-
* says which repo an item is materialized into and is stamped onto
|
|
2679
|
-
* Mossbear-owned rows too, this one says who may edit it.
|
|
2680
|
-
*/
|
|
2681
|
-
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">]>;
|
|
2682
|
-
readonly commitSha: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "commitSha must be 40 or 64 lowercase hex characters">]>;
|
|
2683
|
-
/**
|
|
2684
|
-
* The branch the publishing commit was on. **The one optional member**:
|
|
2685
|
-
* publication is not restricted by branch, so this is recorded so a subscriber
|
|
2686
|
-
* can see what they got, and a detached HEAD has none to record.
|
|
2687
|
-
*/
|
|
2688
|
-
readonly branch: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 255, undefined>]>, undefined>;
|
|
2689
|
-
}, undefined>, undefined>;
|
|
2690
|
-
}, undefined>;
|
|
2691
|
-
export declare const PushContextResponseSchema: v.ObjectSchema<{
|
|
2692
|
-
readonly item: v.SchemaWithPipe<readonly [v.ObjectSchema<{
|
|
2693
|
-
readonly id: v.StringSchema<undefined>;
|
|
2694
|
-
/**
|
|
2695
|
-
* The id every artifact route addresses: the body file's id for a guide
|
|
2696
|
-
* (null only for a guide with no body yet), the item's own id otherwise.
|
|
2697
|
-
* Optional so a client tolerates a server that predates it, and one that
|
|
2698
|
-
* stops sending it (the item id is the artifact id).
|
|
2699
|
-
*/
|
|
2700
|
-
readonly artifactId: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
|
|
2701
|
-
/**
|
|
2702
|
-
* Leaving the wire: a reader tells a guide from content by `role` and the
|
|
2703
|
-
* guide fields, not by this. Optional so a client parses a server that no
|
|
2704
|
-
* longer sends it.
|
|
2705
|
-
*/
|
|
2706
|
-
readonly type: v.OptionalSchema<v.PicklistSchema<string[], undefined>, undefined>;
|
|
2707
|
-
readonly name: v.StringSchema<undefined>;
|
|
2708
|
-
/**
|
|
2709
|
-
* The stored `(role, format)` pair, as two bare nullable strings.
|
|
2710
|
-
*
|
|
2711
|
-
* **Both are deliberately unenumerated.** A client switches on one value it
|
|
2712
|
-
* cares about — `role === 'criteria'` is how a rubric is told from ordinary
|
|
2713
|
-
* prose, which `type` cannot say because a rubric serializes as a `document` —
|
|
2714
|
-
* and a server that adds a fourth role or a fifth format must not break a
|
|
2715
|
-
* client that has never heard of it. Narrowing them here would make every such
|
|
2716
|
-
* addition a breaking wire change for no reader's benefit.
|
|
2717
|
-
*
|
|
2718
|
-
* Null on exactly the rows that carry no content: a tombstone, and an alias.
|
|
2719
|
-
* A `guide` item has no pair at all — it is a different table — and reports
|
|
2720
|
-
* both as null.
|
|
2721
|
-
*/
|
|
2722
|
-
readonly role: v.NullableSchema<v.StringSchema<undefined>, undefined>;
|
|
2723
|
-
readonly format: v.NullableSchema<v.StringSchema<undefined>, undefined>;
|
|
2724
|
-
readonly content: v.NullableSchema<v.StringSchema<undefined>, undefined>;
|
|
2725
|
-
readonly origin: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
|
|
2726
|
-
readonly version: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
|
|
2727
|
-
/**
|
|
2728
|
-
* The guide a **derived** item belongs to — its evaluation criteria, or a
|
|
2729
|
-
* skill's member files (`subscription-delivery-target-plan.md` → slice 4).
|
|
2730
|
-
*
|
|
2731
|
-
* Absent on everything else, including a guide itself: a guide member is
|
|
2732
|
-
* addressed by the guide's own id, so `id` already answers this for it.
|
|
2733
|
-
*
|
|
2734
|
-
* It exists because derived items have no bundle membership and no id of their
|
|
2735
|
-
* guide's — they are `guide_files` rows attached by `guide_id` — so a rule
|
|
2736
|
-
* expressed over guide ids (a subscriber's mute) cannot reach them from the
|
|
2737
|
-
* item alone. Muting a skill and still delivering its `scripts/` would leave a
|
|
2738
|
-
* broken half-skill on disk, which is worse than not muting at all.
|
|
2739
|
-
*/
|
|
2740
|
-
readonly guideId: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
|
|
2741
|
-
readonly root: v.OptionalSchema<v.NullableSchema<v.PicklistSchema<["project", "global"], undefined>, undefined>, undefined>;
|
|
2742
|
-
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>;
|
|
2743
|
-
readonly projectId: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
|
|
2744
|
-
/**
|
|
2745
|
-
* The repo a **document's** declared `path` is placed in — its home — as the
|
|
2746
|
-
* `project.id` of the checkout that last set the path. Documents only.
|
|
2747
|
-
*
|
|
2748
|
-
* Deliberately not `projectId` above: a reader takes a mismatch there as "this
|
|
2749
|
-
* item belongs to another repo, do not materialize it", so a home echoed on it
|
|
2750
|
-
* would stop every other subscriber receiving the document at all. A home says
|
|
2751
|
-
* only *where* the path is literal. Only the repo whose `project.id` matches
|
|
2752
|
-
* writes the document at `path`; every other repo mirrors it under the
|
|
2753
|
-
* bundle folder (`bundleMirrorPath` in `@mossbear/projections`).
|
|
2754
|
-
*
|
|
2755
|
-
* Absent and null read the same — **no home**, so no repo takes the path
|
|
2756
|
-
* literally for a new placement. A server predating the field says the same,
|
|
2757
|
-
* which is the safe direction: the file lands inside the bundle folder
|
|
2758
|
-
* instead of at a repo path it may not belong in.
|
|
2759
|
-
*/
|
|
2760
|
-
readonly pathProjectId: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
|
|
2761
|
-
readonly aliases: v.OptionalSchema<v.SchemaWithPipe<readonly [v.ArraySchema<v.ObjectSchema<{
|
|
2762
|
-
readonly root: v.PicklistSchema<["project", "global"], undefined>;
|
|
2763
|
-
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">]>;
|
|
2764
|
-
}, undefined>, undefined>, v.MaxLengthAction<{
|
|
2765
|
-
root: "project" | "global";
|
|
2766
|
-
path: string;
|
|
2767
|
-
}[], 8, undefined>]>, undefined>;
|
|
2768
|
-
/**
|
|
2769
|
-
* Open comments a person left about this item, newest first.
|
|
2770
|
-
*
|
|
2771
|
-
* Optional, and absent rather than empty when there are none — the same rule
|
|
2772
|
-
* `aliases` and `projectId` follow above, and for the same reason: an older
|
|
2773
|
-
* reader against a newer server ignores the key, and a newer reader against
|
|
2774
|
-
* an older server reads "no comments" instead of failing.
|
|
2775
|
-
*
|
|
2776
|
-
* **Absence is not a verdict.** No comments here means none were served on this
|
|
2777
|
-
* item in this response — not that nobody has anything to say about it.
|
|
2158
|
+
* Open comments a person left about this item, newest first.
|
|
2159
|
+
*
|
|
2160
|
+
* Optional, and absent rather than empty when there are none — the same rule
|
|
2161
|
+
* `aliases` and `projectId` follow above, and for the same reason: an older
|
|
2162
|
+
* reader against a newer server ignores the key, and a newer reader against
|
|
2163
|
+
* an older server reads "no comments" instead of failing.
|
|
2164
|
+
*
|
|
2165
|
+
* **Absence is not a verdict.** No comments here means none were served on this
|
|
2166
|
+
* item in this response — not that nobody has anything to say about it.
|
|
2778
2167
|
*/
|
|
2779
2168
|
readonly comments: v.OptionalSchema<v.SchemaWithPipe<readonly [v.ArraySchema<v.ObjectSchema<{
|
|
2780
2169
|
readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
@@ -3063,1477 +2452,564 @@ export declare const PushContextResponseSchema: v.ObjectSchema<{
|
|
|
3063
2452
|
branch?: string | undefined;
|
|
3064
2453
|
} | null | undefined;
|
|
3065
2454
|
removed?: true | undefined;
|
|
3066
|
-
}>]>;
|
|
3067
|
-
readonly
|
|
2455
|
+
}>]>, undefined>;
|
|
2456
|
+
readonly untrusted: v.OptionalSchema<v.NullableSchema<v.ObjectSchema<{
|
|
2457
|
+
readonly token: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
2458
|
+
readonly startMarker: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
2459
|
+
readonly endMarker: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
2460
|
+
readonly note: v.StringSchema<undefined>;
|
|
2461
|
+
}, undefined>, undefined>, undefined>;
|
|
3068
2462
|
}, undefined>;
|
|
3069
|
-
|
|
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
|
-
readonly gitSource: v.OptionalSchema<v.ObjectSchema<{
|
|
3117
|
-
/**
|
|
3118
|
-
* The committed `project.id` of the source repository — the same id space as
|
|
3119
|
-
* an item's delivery-scoping `projectId` below, but a different fact: that one
|
|
3120
|
-
* says which repo an item is materialized into and is stamped onto
|
|
3121
|
-
* Mossbear-owned rows too, this one says who may edit it.
|
|
3122
|
-
*/
|
|
3123
|
-
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">]>;
|
|
3124
|
-
readonly commitSha: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "commitSha must be 40 or 64 lowercase hex characters">]>;
|
|
3125
|
-
/**
|
|
3126
|
-
* The branch the publishing commit was on. **The one optional member**:
|
|
3127
|
-
* publication is not restricted by branch, so this is recorded so a subscriber
|
|
3128
|
-
* can see what they got, and a detached HEAD has none to record.
|
|
3129
|
-
*/
|
|
3130
|
-
readonly branch: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 255, undefined>]>, undefined>;
|
|
3131
|
-
}, undefined>, undefined>;
|
|
2463
|
+
/**
|
|
2464
|
+
* How many bundles one comments read may name.
|
|
2465
|
+
*
|
|
2466
|
+
* A repo's delivery set is the union of its committed subscriptions and the
|
|
2467
|
+
* reader's account ones, so this bounds a request, not a product limit: a
|
|
2468
|
+
* reader subscribing to more bundles than this asks in two calls rather than
|
|
2469
|
+
* losing the tail silently.
|
|
2470
|
+
*/
|
|
2471
|
+
export declare const MAX_COMMENT_BUNDLE_IDS = 100;
|
|
2472
|
+
/**
|
|
2473
|
+
* How many times one subscriber is told, in one repo, that a given comment is
|
|
2474
|
+
* waiting before the hook falls silent about it.
|
|
2475
|
+
*
|
|
2476
|
+
* **A cap on the interruption, never on the comment.** After it is reached the
|
|
2477
|
+
* comment is still open, still on the item page, and still returned in full by
|
|
2478
|
+
* the on-demand read — it simply stops being announced in front of the first
|
|
2479
|
+
* turn of every session. So silence here means "nothing new to interrupt you
|
|
2480
|
+
* about", never "nobody left anything".
|
|
2481
|
+
*
|
|
2482
|
+
* Three rather than one, for the reason the announcement exists: the first
|
|
2483
|
+
* session in a repo is often doing unrelated work, so a one-shot announcement
|
|
2484
|
+
* would routinely spend itself on the session least likely to act. Three is a
|
|
2485
|
+
* judgement, named so replacing it is one edit — the same discipline the live
|
|
2486
|
+
* session window is held to.
|
|
2487
|
+
*/
|
|
2488
|
+
export declare const MAX_COMMENT_ANNOUNCEMENTS_PER_REPO = 3;
|
|
2489
|
+
/**
|
|
2490
|
+
* Ask which comments are waiting for this reader in this repo, and be counted as
|
|
2491
|
+
* told.
|
|
2492
|
+
*
|
|
2493
|
+
* **A write, because being told is a fact the server has to keep.** The count
|
|
2494
|
+
* cannot be `item_comments.delivered_count` — that is one global number across
|
|
2495
|
+
* every subscriber and every repo, so one reader's fill of a comment would
|
|
2496
|
+
* silence it for everyone — and it cannot live in the checkout, because the
|
|
2497
|
+
* disposable environments this exists for rebuild the clone every session and
|
|
2498
|
+
* a counter there resets with it, announcing every unresolved comment as new
|
|
2499
|
+
* forever.
|
|
2500
|
+
*/
|
|
2501
|
+
export declare const AnnounceItemCommentsRequestSchema: v.ObjectSchema<{
|
|
2502
|
+
/**
|
|
2503
|
+
* The repo, as its committed config declares it. Required: it is the scope
|
|
2504
|
+
* the count is kept under, and a request with nothing to key on could only
|
|
2505
|
+
* be answered by an uncapped announcement — which is the repeating broadcast
|
|
2506
|
+
* this route exists to end.
|
|
2507
|
+
*/
|
|
2508
|
+
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">]>;
|
|
3132
2509
|
/**
|
|
3133
|
-
*
|
|
3134
|
-
* file, so the revision stops being delivered while the row and its version
|
|
3135
|
-
* history stay where they are.
|
|
2510
|
+
* The bundles this repo receives — the union the caller already resolved.
|
|
3136
2511
|
*
|
|
3137
|
-
*
|
|
3138
|
-
*
|
|
3139
|
-
*
|
|
3140
|
-
*
|
|
3141
|
-
|
|
3142
|
-
|
|
2512
|
+
* Sent rather than derived, because only half of it is the server's to know:
|
|
2513
|
+
* a repo-scoped subscription lives in the committed config and travels by
|
|
2514
|
+
* `git clone`. Declaring a bundle grants nothing: every one of them is still
|
|
2515
|
+
* filtered by the caller's own workspace membership.
|
|
2516
|
+
*/
|
|
2517
|
+
readonly bundleIds: v.SchemaWithPipe<readonly [v.ArraySchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>, v.MaxLengthAction<string[], 100, undefined>]>;
|
|
2518
|
+
}, undefined>;
|
|
2519
|
+
export type AnnounceItemCommentsRequest = v.InferOutput<typeof AnnounceItemCommentsRequestSchema>;
|
|
2520
|
+
/**
|
|
2521
|
+
* What an announcement answers: how many comments are waiting, and how many of
|
|
2522
|
+
* them this call was counted as announcing.
|
|
2523
|
+
*
|
|
2524
|
+
* **Two numbers because they answer two questions and a reader needs both.**
|
|
2525
|
+
* `open` is the true state of this repo's comments and is what a caller shows a
|
|
2526
|
+
* person — a number that is sometimes a subset of the truth would be worse
|
|
2527
|
+
* than the silence it replaced. `announced` is how many of those were still
|
|
2528
|
+
* under the cap, and it is the one that decides whether to speak at all: zero
|
|
2529
|
+
* means this reader has already been told about every one of them as often as
|
|
2530
|
+
* the cap allows.
|
|
2531
|
+
*/
|
|
2532
|
+
export declare const AnnounceItemCommentsResponseSchema: v.ObjectSchema<{
|
|
2533
|
+
/** Open, unmuted comments about the items these bundles deliver to this reader. */
|
|
2534
|
+
readonly open: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
|
|
2535
|
+
/** How many of those were under the cap and have now been counted as announced. */
|
|
2536
|
+
readonly announced: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
|
|
2537
|
+
}, undefined>;
|
|
2538
|
+
export type AnnounceItemCommentsResponse = v.InferOutput<typeof AnnounceItemCommentsResponseSchema>;
|
|
2539
|
+
/**
|
|
2540
|
+
* How many comments one agent session may leave on one subject, not counting its
|
|
2541
|
+
* whole-subject comment. Anchored comments and replies share it.
|
|
2542
|
+
*/
|
|
2543
|
+
export declare const MAX_AGENT_COMMENTS_PER_SUBJECT = 50;
|
|
2544
|
+
/** The longest an agent comment's text may be, in characters. */
|
|
2545
|
+
export declare const MAX_AGENT_COMMENT_BODY_CHARS = 4000;
|
|
2546
|
+
/**
|
|
2547
|
+
* Why an agent comment was refused, as the `code` on the error body. A caller
|
|
2548
|
+
* branches on these; the message beside one is for a person.
|
|
2549
|
+
*/
|
|
2550
|
+
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"];
|
|
2551
|
+
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>;
|
|
2552
|
+
export type AgentCommentErrorCode = v.InferOutput<typeof AgentCommentErrorCodeSchema>;
|
|
2553
|
+
/**
|
|
2554
|
+
* Leave a comment, or reply to one, as an agent (`POST /api/v1/context/comments`).
|
|
2555
|
+
*
|
|
2556
|
+
* **`target` names what the comment is about, one way.** `artifact` is the id
|
|
2557
|
+
* a bundle read gave for a guide or document, and `item` is its older name for
|
|
2558
|
+
* the same thing, accepted until every client sends `artifact`. `session` is an
|
|
2559
|
+
* agent session id of the caller's own (the key a search hit and the session digest hand out), and
|
|
2560
|
+
* `reply` is the id of a comment to answer. A reply joins that comment's thread
|
|
2561
|
+
* and the subject it is about.
|
|
2562
|
+
*
|
|
2563
|
+
* **Who the agent is comes from `agent`, and `sessionId` is the harness's own
|
|
2564
|
+
* id as the CLI read it.** A request without one is refused with
|
|
2565
|
+
* `agent_session_required`, and the CLI and tool offer no way to type one. The
|
|
2566
|
+
* server cannot check it against the harness, so it is a claim by the holder of
|
|
2567
|
+
* the token: the comment is always written under that token's account, and the
|
|
2568
|
+
* handle shown for it names a session only as far as the claim is true.
|
|
2569
|
+
*
|
|
2570
|
+
* **Text only.** There is no replacement-text field, and a request that carries
|
|
2571
|
+
* one is refused with `agent_comment_text_only` rather than having it dropped.
|
|
2572
|
+
*/
|
|
2573
|
+
export declare const AgentCommentRequestSchema: v.ObjectSchema<{
|
|
2574
|
+
readonly target: v.VariantSchema<"kind", [v.ObjectSchema<{
|
|
2575
|
+
readonly kind: v.LiteralSchema<"artifact", undefined>;
|
|
2576
|
+
readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 128, undefined>]>;
|
|
2577
|
+
}, undefined>, v.ObjectSchema<{
|
|
2578
|
+
readonly kind: v.LiteralSchema<"session", undefined>;
|
|
2579
|
+
readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 128, undefined>]>;
|
|
2580
|
+
}, undefined>, v.ObjectSchema<{
|
|
2581
|
+
readonly kind: v.LiteralSchema<"reply", undefined>;
|
|
2582
|
+
readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 128, undefined>]>;
|
|
2583
|
+
}, undefined>], undefined>;
|
|
2584
|
+
readonly body: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 4000, undefined>]>;
|
|
2585
|
+
/**
|
|
2586
|
+
* The passage an item comment is about, as the exact text of one or more whole
|
|
2587
|
+
* lines of the item (a paragraph, a heading, a list). None means the item as a
|
|
2588
|
+
* whole. The server finds the lines; a passage that is not in the item as it is
|
|
2589
|
+
* now is refused with `agent_comment_passage_not_found`.
|
|
2590
|
+
*/
|
|
2591
|
+
readonly passage: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 8000, undefined>]>, undefined>;
|
|
2592
|
+
readonly agent: v.ObjectSchema<{
|
|
2593
|
+
readonly sessionId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 128, undefined>]>;
|
|
2594
|
+
readonly harness: v.PicklistSchema<["claude_code", "codex", "antigravity", "opencode"], undefined>;
|
|
2595
|
+
/** The agent's own statement of its model, when it knows it. */
|
|
2596
|
+
readonly model: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 100, undefined>]>, undefined>;
|
|
2597
|
+
readonly cliVersion: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 64, undefined>]>, undefined>;
|
|
2598
|
+
}, undefined>;
|
|
2599
|
+
}, undefined>;
|
|
2600
|
+
export type AgentCommentRequest = v.InferOutput<typeof AgentCommentRequestSchema>;
|
|
2601
|
+
/**
|
|
2602
|
+
* The comment a create settled on. `created` is false when this agent session
|
|
2603
|
+
* already had a whole-subject comment on the subject: that comment comes back
|
|
2604
|
+
* unchanged and nothing was written.
|
|
2605
|
+
*/
|
|
2606
|
+
export declare const AgentCommentResponseSchema: v.ObjectSchema<{
|
|
2607
|
+
readonly created: v.BooleanSchema<undefined>;
|
|
2608
|
+
readonly comment: v.ObjectSchema<{
|
|
2609
|
+
readonly id: v.StringSchema<undefined>;
|
|
2610
|
+
readonly threadId: v.StringSchema<undefined>;
|
|
2611
|
+
readonly subject: v.ObjectSchema<{
|
|
2612
|
+
readonly kind: v.PicklistSchema<["artifact", "session"], undefined>;
|
|
2613
|
+
readonly id: v.StringSchema<undefined>;
|
|
2614
|
+
}, undefined>;
|
|
2615
|
+
readonly body: v.StringSchema<undefined>;
|
|
2616
|
+
readonly createdAt: v.StringSchema<undefined>;
|
|
2617
|
+
}, undefined>;
|
|
2618
|
+
}, undefined>;
|
|
2619
|
+
export type AgentCommentResponse = v.InferOutput<typeof AgentCommentResponseSchema>;
|
|
2620
|
+
/**
|
|
2621
|
+
* One comment on the on-demand read, with the item it is about named on the comment.
|
|
2622
|
+
*
|
|
2623
|
+
* The item is named here rather than the comments riding an item, because this
|
|
2624
|
+
* read answers "what has been left for me" rather than "what is in this
|
|
2625
|
+
* bundle": there is no item payload to hang them off, and an agent that has to
|
|
2626
|
+
* ask for every item to find out whether one carries a comment is the round trip
|
|
2627
|
+
* the announcement exists to avoid.
|
|
2628
|
+
*/
|
|
2629
|
+
export declare const ItemCommentWithSubjectSchema: v.ObjectSchema<{
|
|
2630
|
+
/** The item the comment is about, as the wire names it. */
|
|
2631
|
+
readonly itemName: v.StringSchema<undefined>;
|
|
2632
|
+
/** The item's declared repo-relative path, or null when it has none. */
|
|
2633
|
+
readonly itemPath: v.NullableSchema<v.StringSchema<undefined>, undefined>;
|
|
2634
|
+
readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
2635
|
+
readonly state: v.OptionalSchema<v.PicklistSchema<["open", "resolved"], undefined>, undefined>;
|
|
2636
|
+
/** Current source location of an anchored passage, or its lost quote. */
|
|
2637
|
+
readonly passage: v.OptionalSchema<v.ObjectSchema<{
|
|
2638
|
+
readonly quote: v.StringSchema<undefined>;
|
|
2639
|
+
readonly status: v.PicklistSchema<["located", "changed", "orphaned"], undefined>;
|
|
2640
|
+
readonly lines: v.NullableSchema<v.ObjectSchema<{
|
|
2641
|
+
readonly start: v.NumberSchema<undefined>;
|
|
2642
|
+
readonly end: v.NumberSchema<undefined>;
|
|
2643
|
+
}, undefined>, undefined>;
|
|
2644
|
+
}, undefined>, undefined>;
|
|
2645
|
+
/** The comment's text, already wrapped in the response's untrusted markers. */
|
|
2646
|
+
readonly body: v.StringSchema<undefined>;
|
|
2647
|
+
/**
|
|
2648
|
+
* A suggested edit: the replacement for the passage at `passage.lines`,
|
|
2649
|
+
* already wrapped in the response's untrusted markers like `body`. An
|
|
2650
|
+
* insertion is the passage plus its new lines and an empty replacement is a
|
|
2651
|
+
* deletion, so every edit is one replace. Absent on an ordinary comment.
|
|
2652
|
+
*/
|
|
2653
|
+
readonly suggestion: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
|
|
2654
|
+
/**
|
|
2655
|
+
* What a comment Mossbear wrote is: a finding about the item, never an edit.
|
|
2656
|
+
* Present only on a Mossbear comment. The comment's `body` begins with the
|
|
2657
|
+
* claim (what goes wrong); this carries what the claim rests on.
|
|
2658
|
+
*/
|
|
2659
|
+
readonly finding: v.OptionalSchema<v.ObjectSchema<{
|
|
2660
|
+
readonly tier: v.PicklistSchema<["observed", "usage", "practice"], undefined>;
|
|
2661
|
+
/** How the finding is known, in one line: "Seen in 3 sessions (2026-09-15 – 2026-10-03)". */
|
|
2662
|
+
readonly tierLine: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 300, undefined>]>;
|
|
2663
|
+
/** What the drafter did not read, fixed per tier. */
|
|
2664
|
+
readonly blindSpot: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 300, undefined>]>;
|
|
2665
|
+
/** What should change in later sessions if the finding is fixed, wrapped in the untrusted markers. */
|
|
2666
|
+
readonly prediction: v.NullableSchema<v.StringSchema<undefined>, undefined>;
|
|
2667
|
+
}, undefined>, undefined>;
|
|
2668
|
+
/**
|
|
2669
|
+
* Whether the person approved a comment Mossbear drafted. Present on every
|
|
2670
|
+
* Mossbear comment and absent on a person's or an agent's, which are
|
|
2671
|
+
* requests as written. `false` is a draft nobody has read yet: a reader shows
|
|
2672
|
+
* it to the user and acts only on their go-ahead. Only a client that reports
|
|
2673
|
+
* a version able to mark drafts is ever listed one, so an older reader that
|
|
2674
|
+
* strips this field never receives a draft it would print as a request.
|
|
2675
|
+
*/
|
|
2676
|
+
readonly approved: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
|
|
2677
|
+
/** The author's display name as the workspace shows it, or null. Never an email. */
|
|
2678
|
+
readonly authorName: v.NullableSchema<v.StringSchema<undefined>, undefined>;
|
|
2679
|
+
/** ISO timestamp, machine format. */
|
|
2680
|
+
readonly createdAt: v.StringSchema<undefined>;
|
|
2681
|
+
/** The item's content version the comment was written against. */
|
|
2682
|
+
readonly itemVersion: v.NumberSchema<undefined>;
|
|
2683
|
+
/** True when the item's current version is greater than `itemVersion`. */
|
|
2684
|
+
readonly itemChangedSince: v.BooleanSchema<undefined>;
|
|
2685
|
+
/**
|
|
2686
|
+
* How many agent reads were handed this comment **before** this one — so a
|
|
2687
|
+
* comment reaching an agent for the first time reports `0`.
|
|
3143
2688
|
*
|
|
3144
|
-
*
|
|
3145
|
-
*
|
|
3146
|
-
*
|
|
3147
|
-
*
|
|
3148
|
-
*
|
|
3149
|
-
*
|
|
2689
|
+
* It is the stored count as it read at the moment the response was built;
|
|
2690
|
+
* the serve this response *is* has not been counted yet. Excluded rather
|
|
2691
|
+
* than included because the count is recorded best-effort: a response that
|
|
2692
|
+
* claimed to include itself would be wrong whenever that record failed, and
|
|
2693
|
+
* a number that is sometimes off by one is worse than one that is
|
|
2694
|
+
* consistently the prior total.
|
|
3150
2695
|
*
|
|
3151
|
-
*
|
|
3152
|
-
*
|
|
2696
|
+
* So `deliveredCount > 0` means an earlier read was handed this comment, and
|
|
2697
|
+
* `0` means this read is the first. Neither says a model took it in — only
|
|
2698
|
+
* that the server handed it over.
|
|
3153
2699
|
*/
|
|
3154
|
-
readonly
|
|
2700
|
+
readonly deliveredCount: v.NumberSchema<undefined>;
|
|
2701
|
+
/**
|
|
2702
|
+
* This comment's thread root — its own id for every delivered root. Resolution
|
|
2703
|
+
* replies remain on the dashboard thread and are not delivered to agents.
|
|
2704
|
+
* It is on the wire from the first response
|
|
2705
|
+
* because the wire contract is consumed by installed CLI versions: reshaping
|
|
2706
|
+
* a flat `comments` array into threads-of-comments later would be a breaking
|
|
2707
|
+
* change, while a field today's readers ignore costs them nothing.
|
|
2708
|
+
*/
|
|
2709
|
+
readonly threadId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
2710
|
+
/**
|
|
2711
|
+
* Always `null` for a delivered root. Present so an older reader meeting a
|
|
2712
|
+
* future response that carries real replies degrades to
|
|
2713
|
+
* "a flat list of comments" rather than failing to parse.
|
|
2714
|
+
*/
|
|
2715
|
+
readonly replyToId: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>;
|
|
3155
2716
|
}, undefined>;
|
|
3156
|
-
export
|
|
3157
|
-
|
|
3158
|
-
|
|
2717
|
+
export type ItemCommentWithSubject = v.InferOutput<typeof ItemCommentWithSubjectSchema>;
|
|
2718
|
+
/**
|
|
2719
|
+
* Every open comment waiting for this reader across the bundles they named.
|
|
2720
|
+
*
|
|
2721
|
+
* **This read is a delivery and is counted as one**, exactly as comments riding
|
|
2722
|
+
* an item are: a body reached an agent. What it is *not* is an announcement —
|
|
2723
|
+
* nothing here touches the per-repo announcement count, so asking to read your
|
|
2724
|
+
* comments never spends the interruptions the hook is allowed.
|
|
2725
|
+
*
|
|
2726
|
+
* **Never capped.** The announcement cap governs whether a hook speaks; a
|
|
2727
|
+
* reader who asked is owed every open comment, and hiding one here would retire a
|
|
2728
|
+
* person's request without anybody deciding to.
|
|
2729
|
+
*/
|
|
2730
|
+
export declare const ItemCommentsResponseSchema: v.ObjectSchema<{
|
|
2731
|
+
readonly comments: v.ArraySchema<v.ObjectSchema<{
|
|
2732
|
+
/** The item the comment is about, as the wire names it. */
|
|
2733
|
+
readonly itemName: v.StringSchema<undefined>;
|
|
2734
|
+
/** The item's declared repo-relative path, or null when it has none. */
|
|
2735
|
+
readonly itemPath: v.NullableSchema<v.StringSchema<undefined>, undefined>;
|
|
2736
|
+
readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
2737
|
+
readonly state: v.OptionalSchema<v.PicklistSchema<["open", "resolved"], undefined>, undefined>;
|
|
2738
|
+
/** Current source location of an anchored passage, or its lost quote. */
|
|
2739
|
+
readonly passage: v.OptionalSchema<v.ObjectSchema<{
|
|
2740
|
+
readonly quote: v.StringSchema<undefined>;
|
|
2741
|
+
readonly status: v.PicklistSchema<["located", "changed", "orphaned"], undefined>;
|
|
2742
|
+
readonly lines: v.NullableSchema<v.ObjectSchema<{
|
|
2743
|
+
readonly start: v.NumberSchema<undefined>;
|
|
2744
|
+
readonly end: v.NumberSchema<undefined>;
|
|
2745
|
+
}, undefined>, undefined>;
|
|
2746
|
+
}, undefined>, undefined>;
|
|
2747
|
+
/** The comment's text, already wrapped in the response's untrusted markers. */
|
|
2748
|
+
readonly body: v.StringSchema<undefined>;
|
|
3159
2749
|
/**
|
|
3160
|
-
*
|
|
3161
|
-
*
|
|
3162
|
-
*
|
|
3163
|
-
*
|
|
2750
|
+
* A suggested edit: the replacement for the passage at `passage.lines`,
|
|
2751
|
+
* already wrapped in the response's untrusted markers like `body`. An
|
|
2752
|
+
* insertion is the passage plus its new lines and an empty replacement is a
|
|
2753
|
+
* deletion, so every edit is one replace. Absent on an ordinary comment.
|
|
3164
2754
|
*/
|
|
3165
|
-
readonly
|
|
2755
|
+
readonly suggestion: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
|
|
3166
2756
|
/**
|
|
3167
|
-
*
|
|
3168
|
-
*
|
|
3169
|
-
*
|
|
2757
|
+
* What a comment Mossbear wrote is: a finding about the item, never an edit.
|
|
2758
|
+
* Present only on a Mossbear comment. The comment's `body` begins with the
|
|
2759
|
+
* claim (what goes wrong); this carries what the claim rests on.
|
|
3170
2760
|
*/
|
|
3171
|
-
readonly
|
|
3172
|
-
|
|
2761
|
+
readonly finding: v.OptionalSchema<v.ObjectSchema<{
|
|
2762
|
+
readonly tier: v.PicklistSchema<["observed", "usage", "practice"], undefined>;
|
|
2763
|
+
/** How the finding is known, in one line: "Seen in 3 sessions (2026-09-15 – 2026-10-03)". */
|
|
2764
|
+
readonly tierLine: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 300, undefined>]>;
|
|
2765
|
+
/** What the drafter did not read, fixed per tier. */
|
|
2766
|
+
readonly blindSpot: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 300, undefined>]>;
|
|
2767
|
+
/** What should change in later sessions if the finding is fixed, wrapped in the untrusted markers. */
|
|
2768
|
+
readonly prediction: v.NullableSchema<v.StringSchema<undefined>, undefined>;
|
|
2769
|
+
}, undefined>, undefined>;
|
|
3173
2770
|
/**
|
|
3174
|
-
*
|
|
3175
|
-
*
|
|
3176
|
-
*
|
|
3177
|
-
*
|
|
3178
|
-
*
|
|
3179
|
-
*
|
|
3180
|
-
* client that has never heard of it. Narrowing them here would make every such
|
|
3181
|
-
* addition a breaking wire change for no reader's benefit.
|
|
3182
|
-
*
|
|
3183
|
-
* Null on exactly the rows that carry no content: a tombstone, and an alias.
|
|
3184
|
-
* A `guide` item has no pair at all — it is a different table — and reports
|
|
3185
|
-
* both as null.
|
|
2771
|
+
* Whether the person approved a comment Mossbear drafted. Present on every
|
|
2772
|
+
* Mossbear comment and absent on a person's or an agent's, which are
|
|
2773
|
+
* requests as written. `false` is a draft nobody has read yet: a reader shows
|
|
2774
|
+
* it to the user and acts only on their go-ahead. Only a client that reports
|
|
2775
|
+
* a version able to mark drafts is ever listed one, so an older reader that
|
|
2776
|
+
* strips this field never receives a draft it would print as a request.
|
|
3186
2777
|
*/
|
|
3187
|
-
readonly
|
|
3188
|
-
|
|
3189
|
-
readonly
|
|
3190
|
-
|
|
3191
|
-
readonly
|
|
2778
|
+
readonly approved: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
|
|
2779
|
+
/** The author's display name as the workspace shows it, or null. Never an email. */
|
|
2780
|
+
readonly authorName: v.NullableSchema<v.StringSchema<undefined>, undefined>;
|
|
2781
|
+
/** ISO timestamp, machine format. */
|
|
2782
|
+
readonly createdAt: v.StringSchema<undefined>;
|
|
2783
|
+
/** The item's content version the comment was written against. */
|
|
2784
|
+
readonly itemVersion: v.NumberSchema<undefined>;
|
|
2785
|
+
/** True when the item's current version is greater than `itemVersion`. */
|
|
2786
|
+
readonly itemChangedSince: v.BooleanSchema<undefined>;
|
|
3192
2787
|
/**
|
|
3193
|
-
*
|
|
3194
|
-
*
|
|
2788
|
+
* How many agent reads were handed this comment **before** this one — so a
|
|
2789
|
+
* comment reaching an agent for the first time reports `0`.
|
|
3195
2790
|
*
|
|
3196
|
-
*
|
|
3197
|
-
*
|
|
2791
|
+
* It is the stored count as it read at the moment the response was built;
|
|
2792
|
+
* the serve this response *is* has not been counted yet. Excluded rather
|
|
2793
|
+
* than included because the count is recorded best-effort: a response that
|
|
2794
|
+
* claimed to include itself would be wrong whenever that record failed, and
|
|
2795
|
+
* a number that is sometimes off by one is worse than one that is
|
|
2796
|
+
* consistently the prior total.
|
|
3198
2797
|
*
|
|
3199
|
-
*
|
|
3200
|
-
*
|
|
3201
|
-
*
|
|
3202
|
-
* item alone. Muting a skill and still delivering its `scripts/` would leave a
|
|
3203
|
-
* broken half-skill on disk, which is worse than not muting at all.
|
|
2798
|
+
* So `deliveredCount > 0` means an earlier read was handed this comment, and
|
|
2799
|
+
* `0` means this read is the first. Neither says a model took it in — only
|
|
2800
|
+
* that the server handed it over.
|
|
3204
2801
|
*/
|
|
3205
|
-
readonly
|
|
3206
|
-
readonly root: v.OptionalSchema<v.NullableSchema<v.PicklistSchema<["project", "global"], undefined>, undefined>, undefined>;
|
|
3207
|
-
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>;
|
|
3208
|
-
readonly projectId: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
|
|
2802
|
+
readonly deliveredCount: v.NumberSchema<undefined>;
|
|
3209
2803
|
/**
|
|
3210
|
-
*
|
|
3211
|
-
*
|
|
3212
|
-
*
|
|
3213
|
-
*
|
|
3214
|
-
*
|
|
3215
|
-
*
|
|
3216
|
-
* only *where* the path is literal. Only the repo whose `project.id` matches
|
|
3217
|
-
* writes the document at `path`; every other repo mirrors it under the
|
|
3218
|
-
* bundle folder (`bundleMirrorPath` in `@mossbear/projections`).
|
|
3219
|
-
*
|
|
3220
|
-
* Absent and null read the same — **no home**, so no repo takes the path
|
|
3221
|
-
* literally for a new placement. A server predating the field says the same,
|
|
3222
|
-
* which is the safe direction: the file lands inside the bundle folder
|
|
3223
|
-
* instead of at a repo path it may not belong in.
|
|
2804
|
+
* This comment's thread root — its own id for every delivered root. Resolution
|
|
2805
|
+
* replies remain on the dashboard thread and are not delivered to agents.
|
|
2806
|
+
* It is on the wire from the first response
|
|
2807
|
+
* because the wire contract is consumed by installed CLI versions: reshaping
|
|
2808
|
+
* a flat `comments` array into threads-of-comments later would be a breaking
|
|
2809
|
+
* change, while a field today's readers ignore costs them nothing.
|
|
3224
2810
|
*/
|
|
3225
|
-
readonly
|
|
3226
|
-
readonly aliases: v.OptionalSchema<v.SchemaWithPipe<readonly [v.ArraySchema<v.ObjectSchema<{
|
|
3227
|
-
readonly root: v.PicklistSchema<["project", "global"], undefined>;
|
|
3228
|
-
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">]>;
|
|
3229
|
-
}, undefined>, undefined>, v.MaxLengthAction<{
|
|
3230
|
-
root: "project" | "global";
|
|
3231
|
-
path: string;
|
|
3232
|
-
}[], 8, undefined>]>, undefined>;
|
|
2811
|
+
readonly threadId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
3233
2812
|
/**
|
|
3234
|
-
*
|
|
3235
|
-
*
|
|
3236
|
-
*
|
|
3237
|
-
* `aliases` and `projectId` follow above, and for the same reason: an older
|
|
3238
|
-
* reader against a newer server ignores the key, and a newer reader against
|
|
3239
|
-
* an older server reads "no comments" instead of failing.
|
|
3240
|
-
*
|
|
3241
|
-
* **Absence is not a verdict.** No comments here means none were served on this
|
|
3242
|
-
* item in this response — not that nobody has anything to say about it.
|
|
2813
|
+
* Always `null` for a delivered root. Present so an older reader meeting a
|
|
2814
|
+
* future response that carries real replies degrades to
|
|
2815
|
+
* "a flat list of comments" rather than failing to parse.
|
|
3243
2816
|
*/
|
|
3244
|
-
readonly
|
|
3245
|
-
|
|
3246
|
-
|
|
3247
|
-
/** Current source location of an anchored passage, or its lost quote. */
|
|
3248
|
-
readonly passage: v.OptionalSchema<v.ObjectSchema<{
|
|
3249
|
-
readonly quote: v.StringSchema<undefined>;
|
|
3250
|
-
readonly status: v.PicklistSchema<["located", "changed", "orphaned"], undefined>;
|
|
3251
|
-
readonly lines: v.NullableSchema<v.ObjectSchema<{
|
|
3252
|
-
readonly start: v.NumberSchema<undefined>;
|
|
3253
|
-
readonly end: v.NumberSchema<undefined>;
|
|
3254
|
-
}, undefined>, undefined>;
|
|
3255
|
-
}, undefined>, undefined>;
|
|
3256
|
-
/** The comment's text, already wrapped in the response's untrusted markers. */
|
|
3257
|
-
readonly body: v.StringSchema<undefined>;
|
|
3258
|
-
/**
|
|
3259
|
-
* A suggested edit: the replacement for the passage at `passage.lines`,
|
|
3260
|
-
* already wrapped in the response's untrusted markers like `body`. An
|
|
3261
|
-
* insertion is the passage plus its new lines and an empty replacement is a
|
|
3262
|
-
* deletion, so every edit is one replace. Absent on an ordinary comment.
|
|
3263
|
-
*/
|
|
3264
|
-
readonly suggestion: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
|
|
3265
|
-
/**
|
|
3266
|
-
* What a comment Mossbear wrote is: a finding about the item, never an edit.
|
|
3267
|
-
* Present only on a Mossbear comment. The comment's `body` begins with the
|
|
3268
|
-
* claim (what goes wrong); this carries what the claim rests on.
|
|
3269
|
-
*/
|
|
3270
|
-
readonly finding: v.OptionalSchema<v.ObjectSchema<{
|
|
3271
|
-
readonly tier: v.PicklistSchema<["observed", "usage", "practice"], undefined>;
|
|
3272
|
-
/** How the finding is known, in one line: "Seen in 3 sessions (2026-09-15 – 2026-10-03)". */
|
|
3273
|
-
readonly tierLine: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 300, undefined>]>;
|
|
3274
|
-
/** What the drafter did not read, fixed per tier. */
|
|
3275
|
-
readonly blindSpot: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 300, undefined>]>;
|
|
3276
|
-
/** What should change in later sessions if the finding is fixed, wrapped in the untrusted markers. */
|
|
3277
|
-
readonly prediction: v.NullableSchema<v.StringSchema<undefined>, undefined>;
|
|
3278
|
-
}, undefined>, undefined>;
|
|
3279
|
-
/**
|
|
3280
|
-
* Whether the person approved a comment Mossbear drafted. Present on every
|
|
3281
|
-
* Mossbear comment and absent on a person's or an agent's, which are
|
|
3282
|
-
* requests as written. `false` is a draft nobody has read yet: a reader shows
|
|
3283
|
-
* it to the user and acts only on their go-ahead. Only a client that reports
|
|
3284
|
-
* a version able to mark drafts is ever listed one, so an older reader that
|
|
3285
|
-
* strips this field never receives a draft it would print as a request.
|
|
3286
|
-
*/
|
|
3287
|
-
readonly approved: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
|
|
3288
|
-
/** The author's display name as the workspace shows it, or null. Never an email. */
|
|
3289
|
-
readonly authorName: v.NullableSchema<v.StringSchema<undefined>, undefined>;
|
|
3290
|
-
/** ISO timestamp, machine format. */
|
|
3291
|
-
readonly createdAt: v.StringSchema<undefined>;
|
|
3292
|
-
/** The item's content version the comment was written against. */
|
|
3293
|
-
readonly itemVersion: v.NumberSchema<undefined>;
|
|
3294
|
-
/** True when the item's current version is greater than `itemVersion`. */
|
|
3295
|
-
readonly itemChangedSince: v.BooleanSchema<undefined>;
|
|
3296
|
-
/**
|
|
3297
|
-
* How many agent reads were handed this comment **before** this one — so a
|
|
3298
|
-
* comment reaching an agent for the first time reports `0`.
|
|
3299
|
-
*
|
|
3300
|
-
* It is the stored count as it read at the moment the response was built;
|
|
3301
|
-
* the serve this response *is* has not been counted yet. Excluded rather
|
|
3302
|
-
* than included because the count is recorded best-effort: a response that
|
|
3303
|
-
* claimed to include itself would be wrong whenever that record failed, and
|
|
3304
|
-
* a number that is sometimes off by one is worse than one that is
|
|
3305
|
-
* consistently the prior total.
|
|
3306
|
-
*
|
|
3307
|
-
* So `deliveredCount > 0` means an earlier read was handed this comment, and
|
|
3308
|
-
* `0` means this read is the first. Neither says a model took it in — only
|
|
3309
|
-
* that the server handed it over.
|
|
3310
|
-
*/
|
|
3311
|
-
readonly deliveredCount: v.NumberSchema<undefined>;
|
|
3312
|
-
/**
|
|
3313
|
-
* This comment's thread root — its own id for every delivered root. Resolution
|
|
3314
|
-
* replies remain on the dashboard thread and are not delivered to agents.
|
|
3315
|
-
* It is on the wire from the first response
|
|
3316
|
-
* because the wire contract is consumed by installed CLI versions: reshaping
|
|
3317
|
-
* a flat `comments` array into threads-of-comments later would be a breaking
|
|
3318
|
-
* change, while a field today's readers ignore costs them nothing.
|
|
3319
|
-
*/
|
|
3320
|
-
readonly threadId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
3321
|
-
/**
|
|
3322
|
-
* Always `null` for a delivered root. Present so an older reader meeting a
|
|
3323
|
-
* future response that carries real replies degrades to
|
|
3324
|
-
* "a flat list of comments" rather than failing to parse.
|
|
3325
|
-
*/
|
|
3326
|
-
readonly replyToId: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>;
|
|
3327
|
-
}, undefined>, undefined>, v.MaxLengthAction<{
|
|
3328
|
-
id: string;
|
|
3329
|
-
state?: "open" | "resolved" | undefined;
|
|
3330
|
-
passage?: {
|
|
3331
|
-
quote: string;
|
|
3332
|
-
status: "located" | "changed" | "orphaned";
|
|
3333
|
-
lines: {
|
|
3334
|
-
start: number;
|
|
3335
|
-
end: number;
|
|
3336
|
-
} | null;
|
|
3337
|
-
} | undefined;
|
|
3338
|
-
body: string;
|
|
3339
|
-
suggestion?: string | undefined;
|
|
3340
|
-
finding?: {
|
|
3341
|
-
tier: "observed" | "usage" | "practice";
|
|
3342
|
-
tierLine: string;
|
|
3343
|
-
blindSpot: string;
|
|
3344
|
-
prediction: string | null;
|
|
3345
|
-
} | undefined;
|
|
3346
|
-
approved?: boolean | undefined;
|
|
3347
|
-
authorName: string | null;
|
|
3348
|
-
createdAt: string;
|
|
3349
|
-
itemVersion: number;
|
|
3350
|
-
itemChangedSince: boolean;
|
|
3351
|
-
deliveredCount: number;
|
|
3352
|
-
threadId: string;
|
|
3353
|
-
replyToId: string | null;
|
|
3354
|
-
}[], 20, undefined>]>, undefined>;
|
|
3355
|
-
readonly updatedAt: v.StringSchema<undefined>;
|
|
3356
|
-
/**
|
|
3357
|
-
* Present iff this artifact is owned by git. Absent means Mossbear owns it
|
|
3358
|
-
* and it is editable in the dashboard.
|
|
3359
|
-
*
|
|
3360
|
-
* **Optional, and absence is not yet a verdict.** Nothing writes this before
|
|
3361
|
-
* `publish` ships, so today every item omits it, and the existing bundle-home
|
|
3362
|
-
* rule — a bundle may name one repo as its only writer, and the server
|
|
3363
|
-
* refuses every other writer by name — is what still protects items a repo
|
|
3364
|
-
* already owns. A reader must not treat an absent `gitSource` as permission
|
|
3365
|
-
* to publish back.
|
|
3366
|
-
*
|
|
3367
|
-
* **Optional *and* nullable, like every other late-added column on this item.**
|
|
3368
|
-
* A serializer that maps the columns straight through emits `null` for a
|
|
3369
|
-
* Mossbear-owned row, and a key that only accepted `undefined` would throw on
|
|
3370
|
-
* the whole response rather than on the one item — `parseContextItemsResponse`
|
|
3371
|
-
* parses a pull as a batch. Both spellings read the same way: no git source.
|
|
3372
|
-
*
|
|
3373
|
-
* **`path` is the third required member of the subset and is not re-checked
|
|
3374
|
-
* here.** The database holds that invariant
|
|
3375
|
-
* (`guide_files_git_source_subset`), and a wire rule that looked identical
|
|
3376
|
-
* would in fact be stricter: `path` is serialized through a scope helper that
|
|
3377
|
-
* emits `null` for a path this schema cannot parse, so a single such row would
|
|
3378
|
-
* fail every other item in the same pull. A git-owned item that arrives
|
|
3379
|
-
* without a usable path is a broken item, not a broken response.
|
|
3380
|
-
*/
|
|
3381
|
-
readonly gitSource: v.OptionalSchema<v.NullableSchema<v.ObjectSchema<{
|
|
3382
|
-
/**
|
|
3383
|
-
* The committed `project.id` of the source repository — the same id space as
|
|
3384
|
-
* an item's delivery-scoping `projectId` below, but a different fact: that one
|
|
3385
|
-
* says which repo an item is materialized into and is stamped onto
|
|
3386
|
-
* Mossbear-owned rows too, this one says who may edit it.
|
|
3387
|
-
*/
|
|
3388
|
-
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">]>;
|
|
3389
|
-
readonly commitSha: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "commitSha must be 40 or 64 lowercase hex characters">]>;
|
|
3390
|
-
/**
|
|
3391
|
-
* The branch the publishing commit was on. **The one optional member**:
|
|
3392
|
-
* publication is not restricted by branch, so this is recorded so a subscriber
|
|
3393
|
-
* can see what they got, and a detached HEAD has none to record.
|
|
3394
|
-
*/
|
|
3395
|
-
readonly branch: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 255, undefined>]>, undefined>;
|
|
3396
|
-
}, undefined>, undefined>, undefined>;
|
|
3397
|
-
/**
|
|
3398
|
-
* This artifact is a **tombstone**: the repository that publishes it deleted
|
|
3399
|
-
* the file, so what the item still carries is the last revision rather than a
|
|
3400
|
-
* current one (`artifact-ownership-and-delivery-plan.md` → D28).
|
|
3401
|
-
*
|
|
3402
|
-
* **It is still delivered, and that is deliberate.** Dropping the item from
|
|
3403
|
-
* the response would say the same thing more quietly and cost two things
|
|
3404
|
-
* worth more than the byte: the publishing repo would lose the id it needs to
|
|
3405
|
-
* republish the path in place — re-adding a deleted file would create a
|
|
3406
|
-
* second artifact at the same path rather than a new revision of the one
|
|
3407
|
-
* that is there — and a reader would be left unable to tell a removal from
|
|
3408
|
-
* a bundle it has stopped being able to see. What the flag asks of a client
|
|
3409
|
-
* is one thing: do not materialize it. A file left at a discovery root keeps
|
|
3410
|
-
* feeding deleted guidance into every agent that reads that repo, which is
|
|
3411
|
-
* the failure the decision exists to stop.
|
|
3412
|
-
*
|
|
3413
|
-
* **Optional, and absent means an ordinary artifact.** A client that has
|
|
3414
|
-
* never heard of it behaves as it always did — it keeps the last published
|
|
3415
|
-
* revision on disk, which is the retain behaviour this replaces rather than a
|
|
3416
|
-
* new failure. That is what makes the server safe to ship first.
|
|
3417
|
-
*
|
|
3418
|
-
* `literal(true)` rather than a boolean: `removed: false` would be a second
|
|
3419
|
-
* spelling of absence, and an artifact that came back is content again rather
|
|
3420
|
-
* than a tombstone that says no.
|
|
3421
|
-
*/
|
|
3422
|
-
readonly removed: v.OptionalSchema<v.LiteralSchema<true, undefined>, undefined>;
|
|
3423
|
-
}, undefined>, v.TransformAction<{
|
|
3424
|
-
id: string;
|
|
3425
|
-
artifactId?: string | null | undefined;
|
|
3426
|
-
type?: string | undefined;
|
|
3427
|
-
name: string;
|
|
3428
|
-
role: string | null;
|
|
3429
|
-
format: string | null;
|
|
3430
|
-
content: string | null;
|
|
3431
|
-
origin?: string | null | undefined;
|
|
3432
|
-
version?: number | undefined;
|
|
3433
|
-
guideId?: string | null | undefined;
|
|
3434
|
-
root?: "project" | "global" | null | undefined;
|
|
3435
|
-
path?: string | null | undefined;
|
|
3436
|
-
projectId?: string | null | undefined;
|
|
3437
|
-
pathProjectId?: string | null | undefined;
|
|
3438
|
-
aliases?: {
|
|
3439
|
-
root: "project" | "global";
|
|
3440
|
-
path: string;
|
|
3441
|
-
}[] | undefined;
|
|
3442
|
-
comments?: {
|
|
3443
|
-
id: string;
|
|
3444
|
-
state?: "open" | "resolved" | undefined;
|
|
3445
|
-
passage?: {
|
|
3446
|
-
quote: string;
|
|
3447
|
-
status: "located" | "changed" | "orphaned";
|
|
3448
|
-
lines: {
|
|
3449
|
-
start: number;
|
|
3450
|
-
end: number;
|
|
3451
|
-
} | null;
|
|
3452
|
-
} | undefined;
|
|
3453
|
-
body: string;
|
|
3454
|
-
suggestion?: string | undefined;
|
|
3455
|
-
finding?: {
|
|
3456
|
-
tier: "observed" | "usage" | "practice";
|
|
3457
|
-
tierLine: string;
|
|
3458
|
-
blindSpot: string;
|
|
3459
|
-
prediction: string | null;
|
|
3460
|
-
} | undefined;
|
|
3461
|
-
approved?: boolean | undefined;
|
|
3462
|
-
authorName: string | null;
|
|
3463
|
-
createdAt: string;
|
|
3464
|
-
itemVersion: number;
|
|
3465
|
-
itemChangedSince: boolean;
|
|
3466
|
-
deliveredCount: number;
|
|
3467
|
-
threadId: string;
|
|
3468
|
-
replyToId: string | null;
|
|
3469
|
-
}[] | undefined;
|
|
3470
|
-
updatedAt: string;
|
|
3471
|
-
gitSource?: {
|
|
3472
|
-
projectId: string;
|
|
3473
|
-
commitSha: string;
|
|
3474
|
-
branch?: string | undefined;
|
|
3475
|
-
} | null | undefined;
|
|
3476
|
-
removed?: true | undefined;
|
|
3477
|
-
}, {
|
|
3478
|
-
type: string;
|
|
3479
|
-
id: string;
|
|
3480
|
-
artifactId?: string | null | undefined;
|
|
3481
|
-
name: string;
|
|
3482
|
-
role: string | null;
|
|
3483
|
-
format: string | null;
|
|
3484
|
-
content: string | null;
|
|
3485
|
-
origin?: string | null | undefined;
|
|
3486
|
-
version?: number | undefined;
|
|
3487
|
-
guideId?: string | null | undefined;
|
|
3488
|
-
root?: "project" | "global" | null | undefined;
|
|
3489
|
-
path?: string | null | undefined;
|
|
3490
|
-
projectId?: string | null | undefined;
|
|
3491
|
-
pathProjectId?: string | null | undefined;
|
|
3492
|
-
aliases?: {
|
|
3493
|
-
root: "project" | "global";
|
|
3494
|
-
path: string;
|
|
3495
|
-
}[] | undefined;
|
|
3496
|
-
comments?: {
|
|
3497
|
-
id: string;
|
|
3498
|
-
state?: "open" | "resolved" | undefined;
|
|
3499
|
-
passage?: {
|
|
3500
|
-
quote: string;
|
|
3501
|
-
status: "located" | "changed" | "orphaned";
|
|
3502
|
-
lines: {
|
|
3503
|
-
start: number;
|
|
3504
|
-
end: number;
|
|
3505
|
-
} | null;
|
|
3506
|
-
} | undefined;
|
|
3507
|
-
body: string;
|
|
3508
|
-
suggestion?: string | undefined;
|
|
3509
|
-
finding?: {
|
|
3510
|
-
tier: "observed" | "usage" | "practice";
|
|
3511
|
-
tierLine: string;
|
|
3512
|
-
blindSpot: string;
|
|
3513
|
-
prediction: string | null;
|
|
3514
|
-
} | undefined;
|
|
3515
|
-
approved?: boolean | undefined;
|
|
3516
|
-
authorName: string | null;
|
|
3517
|
-
createdAt: string;
|
|
3518
|
-
itemVersion: number;
|
|
3519
|
-
itemChangedSince: boolean;
|
|
3520
|
-
deliveredCount: number;
|
|
3521
|
-
threadId: string;
|
|
3522
|
-
replyToId: string | null;
|
|
3523
|
-
}[] | undefined;
|
|
3524
|
-
updatedAt: string;
|
|
3525
|
-
gitSource?: {
|
|
3526
|
-
projectId: string;
|
|
3527
|
-
commitSha: string;
|
|
3528
|
-
branch?: string | undefined;
|
|
3529
|
-
} | null | undefined;
|
|
3530
|
-
removed?: true | undefined;
|
|
3531
|
-
}>]>;
|
|
3532
|
-
readonly updated: v.BooleanSchema<undefined>;
|
|
3533
|
-
}, undefined>;
|
|
3534
|
-
export declare const UpdateContextItemBodySchema: Omit<v.ObjectSchema<{
|
|
3535
|
-
readonly itemId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
3536
|
-
readonly name: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 200, undefined>]>, undefined>;
|
|
3537
|
-
readonly content: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.CheckAction<string, "content must be at most 524288 bytes">]>, undefined>;
|
|
3538
|
-
readonly expectedVersion: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>, undefined>;
|
|
3539
|
-
/**
|
|
3540
|
-
* The committed `project.id` of the checkout this write comes from — same
|
|
3541
|
-
* meaning and same two uses as on `PushContextRequestSchema`: a bundle that
|
|
3542
|
-
* claims a home accepts writes only from that repo, and a request declaring
|
|
3543
|
-
* nothing is not it; and when this update sets `path`, it is stored as the
|
|
3544
|
-
* repo that path is placed in. Parsed as on `PushContextRequestSchema`.
|
|
3545
|
-
*/
|
|
3546
|
-
readonly projectId: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>]>, undefined>;
|
|
2817
|
+
readonly replyToId: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>;
|
|
2818
|
+
}, undefined>, undefined>;
|
|
2819
|
+
readonly cursor: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
|
|
3547
2820
|
/**
|
|
3548
|
-
*
|
|
3549
|
-
*
|
|
3550
|
-
*
|
|
3551
|
-
* **Three states, the same shape `sourceItemIds` takes.** Omitted leaves the
|
|
3552
|
-
* stored path and its home alone — every name or body edit. A path replaces
|
|
3553
|
-
* both: the path, and the home as `projectId` above declares it, since a path
|
|
3554
|
-
* is relative to the repo that declared it. `null` clears both.
|
|
3555
|
-
*
|
|
3556
|
-
* The same schema as the create side and the read side, for the reason
|
|
3557
|
-
* `PushContextRequestSchema` gives, and the same refusals in the routes —
|
|
3558
|
-
* agent guidance, Mossbear's state directory, git's.
|
|
3559
|
-
*
|
|
3560
|
-
* **Documents only.** A guide's path is its discovery path, which import
|
|
3561
|
-
* reconciles on; moving it here would fork it from the file it came from, so
|
|
3562
|
-
* the routes refuse it on a guide by name. A git-published artifact cannot
|
|
3563
|
-
* drop its path either, because the published-source group is only legal
|
|
3564
|
-
* beside one.
|
|
2821
|
+
* The markers every `body` above is wrapped in, plus a statement of what
|
|
2822
|
+
* they mean. Present exactly when at least one comment came back.
|
|
3565
2823
|
*/
|
|
3566
|
-
readonly
|
|
3567
|
-
|
|
2824
|
+
readonly untrusted: v.OptionalSchema<v.NullableSchema<v.ObjectSchema<{
|
|
2825
|
+
readonly token: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
2826
|
+
readonly startMarker: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
2827
|
+
readonly endMarker: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
2828
|
+
readonly note: v.StringSchema<undefined>;
|
|
2829
|
+
}, undefined>, undefined>, undefined>;
|
|
2830
|
+
}, undefined>;
|
|
2831
|
+
export type ItemCommentsResponse = v.InferOutput<typeof ItemCommentsResponseSchema>;
|
|
2832
|
+
/**
|
|
2833
|
+
* The evidence behind one Mossbear finding an agent was handed
|
|
2834
|
+
* (`GET /api/v1/context/comments/evidence`).
|
|
2835
|
+
*
|
|
2836
|
+
* `list_comments` carries the claim and a one-line tier; this is the finding
|
|
2837
|
+
* in full: the claim, the change it predicts in future sessions, what the
|
|
2838
|
+
* drafter did not read, and the evidence for its tier. Readable only through a
|
|
2839
|
+
* comment the comment read itself would deliver to this reader, so another
|
|
2840
|
+
* person's finding, one drafted from another repo, or a draft listed only to a
|
|
2841
|
+
* newer client has no evidence here either. A draft the reader was listed
|
|
2842
|
+
* does: an agent can say why it was raised before the person approves it.
|
|
2843
|
+
*
|
|
2844
|
+
* Citations (observed and usage findings) are reduced to what the reader may
|
|
2845
|
+
* see: their own sessions, with a date and a short excerpt of the grader's
|
|
2846
|
+
* reasoning or of their own redacted correction turn. A `navigation` citation
|
|
2847
|
+
* has an empty excerpt: it is dated evidence that a session loaded the skill,
|
|
2848
|
+
* and nothing more. `citationsWithheld` counts any that were dropped, so a
|
|
2849
|
+
* short list is never mistaken for the whole of it.
|
|
2850
|
+
*/
|
|
2851
|
+
export declare const CommentEvidenceCitationSchema: v.ObjectSchema<{
|
|
3568
2852
|
/**
|
|
3569
|
-
*
|
|
3570
|
-
*
|
|
3571
|
-
*
|
|
3572
|
-
*
|
|
3573
|
-
*
|
|
3574
|
-
* **Omitted leaves the stored group alone; it never clears it.** An update
|
|
3575
|
-
* that says nothing about provenance is a name or body edit, not a claim that
|
|
3576
|
-
* the artifact stopped being git-owned — and an absent key that silently
|
|
3577
|
-
* un-owned a row would hand a subscriber write access by omission, which is
|
|
3578
|
-
* the failure the whole ownership model exists to prevent. Ownership is given
|
|
3579
|
-
* up by promotion, not by a missing field.
|
|
2853
|
+
* `navigation` is a skill load counted when a finding was drafted from how
|
|
2854
|
+
* the skill's files were read: evidence of how a skill was used, not of a
|
|
2855
|
+
* failure. `action` is a recorded step of a workflow repeated across
|
|
2856
|
+
* sessions. A server sends it only to a client that names a version new
|
|
2857
|
+
* enough to parse it.
|
|
3580
2858
|
*/
|
|
3581
|
-
readonly
|
|
3582
|
-
|
|
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
|
-
* **`gitSource` is required alongside it and the route enforces that.** A
|
|
3610
|
-
* tombstone's whole claim is *which revision removed the file*: without one
|
|
3611
|
-
* the row would say an artifact stopped being delivered and be unable to say
|
|
3612
|
-
* why, which is the silent withdrawal this field exists to replace. That also
|
|
3613
|
-
* keeps the only writer of a removal here the publication path — this is not
|
|
3614
|
-
* a general delete verb for the context layer.
|
|
3615
|
-
*
|
|
3616
|
-
* **Never sent with `content`.** A removal has no bytes; a body carrying both
|
|
3617
|
-
* is two answers to one question and the route refuses it rather than picking.
|
|
3618
|
-
*/
|
|
3619
|
-
readonly removed: v.OptionalSchema<v.LiteralSchema<true, undefined>, undefined>;
|
|
3620
|
-
}, undefined>, "entries" | "~types" | "~run" | "~standard"> & {
|
|
3621
|
-
readonly entries: Omit<{
|
|
3622
|
-
readonly itemId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
3623
|
-
readonly name: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 200, undefined>]>, undefined>;
|
|
3624
|
-
readonly content: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.CheckAction<string, "content must be at most 524288 bytes">]>, undefined>;
|
|
3625
|
-
readonly expectedVersion: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>, undefined>;
|
|
3626
|
-
/**
|
|
3627
|
-
* The committed `project.id` of the checkout this write comes from — same
|
|
3628
|
-
* meaning and same two uses as on `PushContextRequestSchema`: a bundle that
|
|
3629
|
-
* claims a home accepts writes only from that repo, and a request declaring
|
|
3630
|
-
* nothing is not it; and when this update sets `path`, it is stored as the
|
|
3631
|
-
* repo that path is placed in. Parsed as on `PushContextRequestSchema`.
|
|
3632
|
-
*/
|
|
3633
|
-
readonly projectId: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>]>, undefined>;
|
|
3634
|
-
/**
|
|
3635
|
-
* Move the document: its new placement, or `null` to take the placement away
|
|
3636
|
-
* so it lands in the bundle folder again.
|
|
3637
|
-
*
|
|
3638
|
-
* **Three states, the same shape `sourceItemIds` takes.** Omitted leaves the
|
|
3639
|
-
* stored path and its home alone — every name or body edit. A path replaces
|
|
3640
|
-
* both: the path, and the home as `projectId` above declares it, since a path
|
|
3641
|
-
* is relative to the repo that declared it. `null` clears both.
|
|
3642
|
-
*
|
|
3643
|
-
* The same schema as the create side and the read side, for the reason
|
|
3644
|
-
* `PushContextRequestSchema` gives, and the same refusals in the routes —
|
|
3645
|
-
* agent guidance, Mossbear's state directory, git's.
|
|
3646
|
-
*
|
|
3647
|
-
* **Documents only.** A guide's path is its discovery path, which import
|
|
3648
|
-
* reconciles on; moving it here would fork it from the file it came from, so
|
|
3649
|
-
* the routes refuse it on a guide by name. A git-published artifact cannot
|
|
3650
|
-
* drop its path either, because the published-source group is only legal
|
|
3651
|
-
* beside one.
|
|
3652
|
-
*/
|
|
3653
|
-
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>;
|
|
3654
|
-
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>;
|
|
3655
|
-
/**
|
|
3656
|
-
* The revision this update's bytes were read from — same meaning as on
|
|
3657
|
-
* `PushContextRequestSchema` above, and the field that makes a republication
|
|
3658
|
-
* advance an artifact's provenance rather than leave it pointing at the
|
|
3659
|
-
* commit it was first published from.
|
|
3660
|
-
*
|
|
3661
|
-
* **Omitted leaves the stored group alone; it never clears it.** An update
|
|
3662
|
-
* that says nothing about provenance is a name or body edit, not a claim that
|
|
3663
|
-
* the artifact stopped being git-owned — and an absent key that silently
|
|
3664
|
-
* un-owned a row would hand a subscriber write access by omission, which is
|
|
3665
|
-
* the failure the whole ownership model exists to prevent. Ownership is given
|
|
3666
|
-
* up by promotion, not by a missing field.
|
|
3667
|
-
*/
|
|
3668
|
-
readonly gitSource: v.OptionalSchema<v.ObjectSchema<{
|
|
3669
|
-
/**
|
|
3670
|
-
* The committed `project.id` of the source repository — the same id space as
|
|
3671
|
-
* an item's delivery-scoping `projectId` below, but a different fact: that one
|
|
3672
|
-
* says which repo an item is materialized into and is stamped onto
|
|
3673
|
-
* Mossbear-owned rows too, this one says who may edit it.
|
|
3674
|
-
*/
|
|
3675
|
-
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">]>;
|
|
3676
|
-
readonly commitSha: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "commitSha must be 40 or 64 lowercase hex characters">]>;
|
|
3677
|
-
/**
|
|
3678
|
-
* The branch the publishing commit was on. **The one optional member**:
|
|
3679
|
-
* publication is not restricted by branch, so this is recorded so a subscriber
|
|
3680
|
-
* can see what they got, and a detached HEAD has none to record.
|
|
3681
|
-
*/
|
|
3682
|
-
readonly branch: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 255, undefined>]>, undefined>;
|
|
3683
|
-
}, undefined>, undefined>;
|
|
3684
|
-
/**
|
|
3685
|
-
* Tombstone this artifact: the commit that published it has since deleted the
|
|
3686
|
-
* file, so the revision stops being delivered while the row and its version
|
|
3687
|
-
* history stay where they are.
|
|
3688
|
-
*
|
|
3689
|
-
* **A verb, not a column state**, the same shape the dashboard's own removal
|
|
3690
|
-
* takes (`~/zero/mutators.ts` → `guideFiles.update`'s `removed`). There is no
|
|
3691
|
-
* writable field here that a removal and an ordinary edit could disagree
|
|
3692
|
-
* about, and `literal(true)` is what keeps `removed: false` from reading as a
|
|
3693
|
-
* request to bring something back — un-removing is republishing, which is an
|
|
3694
|
-
* ordinary content write.
|
|
3695
|
-
*
|
|
3696
|
-
* **`gitSource` is required alongside it and the route enforces that.** A
|
|
3697
|
-
* tombstone's whole claim is *which revision removed the file*: without one
|
|
3698
|
-
* the row would say an artifact stopped being delivered and be unable to say
|
|
3699
|
-
* why, which is the silent withdrawal this field exists to replace. That also
|
|
3700
|
-
* keeps the only writer of a removal here the publication path — this is not
|
|
3701
|
-
* a general delete verb for the context layer.
|
|
3702
|
-
*
|
|
3703
|
-
* **Never sent with `content`.** A removal has no bytes; a body carrying both
|
|
3704
|
-
* is two answers to one question and the route refuses it rather than picking.
|
|
3705
|
-
*/
|
|
3706
|
-
readonly removed: v.OptionalSchema<v.LiteralSchema<true, undefined>, undefined>;
|
|
3707
|
-
}, "itemId">;
|
|
3708
|
-
readonly "~standard": v.StandardProps<{
|
|
3709
|
-
content?: string | undefined;
|
|
3710
|
-
path?: string | null | undefined;
|
|
3711
|
-
expectedVersion?: number | undefined;
|
|
3712
|
-
projectId?: string | undefined;
|
|
3713
|
-
name?: string | undefined;
|
|
3714
|
-
gitSource?: {
|
|
3715
|
-
projectId: string;
|
|
3716
|
-
commitSha: string;
|
|
3717
|
-
branch?: string | undefined;
|
|
3718
|
-
} | undefined;
|
|
3719
|
-
removed?: true | undefined;
|
|
3720
|
-
sourceItemIds?: string[] | undefined;
|
|
3721
|
-
}, {
|
|
3722
|
-
content?: string | undefined;
|
|
3723
|
-
path?: string | null | undefined;
|
|
3724
|
-
expectedVersion?: number | undefined;
|
|
3725
|
-
projectId?: string | undefined;
|
|
3726
|
-
name?: string | undefined;
|
|
3727
|
-
gitSource?: {
|
|
3728
|
-
projectId: string;
|
|
3729
|
-
commitSha: string;
|
|
3730
|
-
branch?: string | undefined;
|
|
3731
|
-
} | undefined;
|
|
3732
|
-
removed?: true | undefined;
|
|
3733
|
-
sourceItemIds?: string[] | undefined;
|
|
3734
|
-
}>;
|
|
3735
|
-
readonly "~run": (dataset: v.UnknownDataset, config: v.Config<v.BaseIssue<unknown>>) => v.OutputDataset<{
|
|
3736
|
-
content?: string | undefined;
|
|
3737
|
-
path?: string | null | undefined;
|
|
3738
|
-
expectedVersion?: number | undefined;
|
|
3739
|
-
projectId?: string | undefined;
|
|
3740
|
-
name?: string | undefined;
|
|
3741
|
-
gitSource?: {
|
|
3742
|
-
projectId: string;
|
|
3743
|
-
commitSha: string;
|
|
3744
|
-
branch?: string | undefined;
|
|
3745
|
-
} | undefined;
|
|
3746
|
-
removed?: true | undefined;
|
|
3747
|
-
sourceItemIds?: string[] | undefined;
|
|
3748
|
-
}, 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>>;
|
|
3749
|
-
readonly "~types"?: {
|
|
3750
|
-
readonly input: {
|
|
3751
|
-
content?: string | undefined;
|
|
3752
|
-
path?: string | null | undefined;
|
|
3753
|
-
expectedVersion?: number | undefined;
|
|
3754
|
-
projectId?: string | undefined;
|
|
3755
|
-
name?: string | undefined;
|
|
3756
|
-
gitSource?: {
|
|
3757
|
-
projectId: string;
|
|
3758
|
-
commitSha: string;
|
|
3759
|
-
branch?: string | undefined;
|
|
3760
|
-
} | undefined;
|
|
3761
|
-
removed?: true | undefined;
|
|
3762
|
-
sourceItemIds?: string[] | undefined;
|
|
3763
|
-
};
|
|
3764
|
-
readonly output: {
|
|
3765
|
-
content?: string | undefined;
|
|
3766
|
-
path?: string | null | undefined;
|
|
3767
|
-
expectedVersion?: number | undefined;
|
|
3768
|
-
projectId?: string | undefined;
|
|
3769
|
-
name?: string | undefined;
|
|
3770
|
-
gitSource?: {
|
|
3771
|
-
projectId: string;
|
|
3772
|
-
commitSha: string;
|
|
3773
|
-
branch?: string | undefined;
|
|
3774
|
-
} | undefined;
|
|
3775
|
-
removed?: true | undefined;
|
|
3776
|
-
sourceItemIds?: string[] | undefined;
|
|
3777
|
-
};
|
|
3778
|
-
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>;
|
|
3779
|
-
} | undefined;
|
|
3780
|
-
};
|
|
3781
|
-
/** A single canonical item, for the item-scoped read route. */
|
|
3782
|
-
export declare const ContextItemResponseSchema: v.ObjectSchema<{
|
|
3783
|
-
readonly item: v.SchemaWithPipe<readonly [v.ObjectSchema<{
|
|
2859
|
+
readonly kind: v.PicklistSchema<["verdict", "turn", "navigation", "action"], undefined>;
|
|
2860
|
+
readonly sessionId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
2861
|
+
/** ISO, when the verdict was graded, the turn was said, the skill loaded, or the action was recorded. */
|
|
2862
|
+
readonly at: v.StringSchema<undefined>;
|
|
2863
|
+
/** Wrapped in the response's untrusted markers. */
|
|
2864
|
+
readonly excerpt: v.StringSchema<undefined>;
|
|
2865
|
+
}, undefined>;
|
|
2866
|
+
export type CommentEvidenceCitation = v.InferOutput<typeof CommentEvidenceCitationSchema>;
|
|
2867
|
+
/** What a usage finding adds to its citations: the counts for one reference file. */
|
|
2868
|
+
export declare const CommentEvidenceUsageSchema: v.ObjectSchema<{
|
|
2869
|
+
/** The reference's skill-relative path, wrapped in the response's untrusted markers. */
|
|
2870
|
+
readonly path: v.StringSchema<undefined>;
|
|
2871
|
+
/** Eligible loads of the skill. */
|
|
2872
|
+
readonly loads: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>]>;
|
|
2873
|
+
/** Distinct sessions those loads span. */
|
|
2874
|
+
readonly sessions: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>]>;
|
|
2875
|
+
/** Loads followed by a successful read of the reference. */
|
|
2876
|
+
readonly loadsWithRead: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>]>;
|
|
2877
|
+
}, undefined>;
|
|
2878
|
+
/**
|
|
2879
|
+
* What a practice finding adds: the rubric check it answers and the rubric's
|
|
2880
|
+
* version, the practice lines it weighs with their sources, the facts measured
|
|
2881
|
+
* from the file, and the answer to each item of evidence the check asks for.
|
|
2882
|
+
* `answers[].answer` is model-written, so it travels wrapped in the response's
|
|
2883
|
+
* untrusted markers.
|
|
2884
|
+
*/
|
|
2885
|
+
export declare const CommentEvidencePracticeSchema: v.ObjectSchema<{
|
|
2886
|
+
readonly check: v.ObjectSchema<{
|
|
3784
2887
|
readonly id: v.StringSchema<undefined>;
|
|
3785
|
-
/**
|
|
3786
|
-
* The id every artifact route addresses: the body file's id for a guide
|
|
3787
|
-
* (null only for a guide with no body yet), the item's own id otherwise.
|
|
3788
|
-
* Optional so a client tolerates a server that predates it, and one that
|
|
3789
|
-
* stops sending it (the item id is the artifact id).
|
|
3790
|
-
*/
|
|
3791
|
-
readonly artifactId: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
|
|
3792
|
-
/**
|
|
3793
|
-
* Leaving the wire: a reader tells a guide from content by `role` and the
|
|
3794
|
-
* guide fields, not by this. Optional so a client parses a server that no
|
|
3795
|
-
* longer sends it.
|
|
3796
|
-
*/
|
|
3797
|
-
readonly type: v.OptionalSchema<v.PicklistSchema<string[], undefined>, undefined>;
|
|
3798
2888
|
readonly name: v.StringSchema<undefined>;
|
|
3799
|
-
|
|
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
|
-
readonly
|
|
3852
|
-
|
|
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
|
-
readonly itemChangedSince: v.BooleanSchema<undefined>;
|
|
3922
|
-
/**
|
|
3923
|
-
* How many agent reads were handed this comment **before** this one — so a
|
|
3924
|
-
* comment reaching an agent for the first time reports `0`.
|
|
3925
|
-
*
|
|
3926
|
-
* It is the stored count as it read at the moment the response was built;
|
|
3927
|
-
* the serve this response *is* has not been counted yet. Excluded rather
|
|
3928
|
-
* than included because the count is recorded best-effort: a response that
|
|
3929
|
-
* claimed to include itself would be wrong whenever that record failed, and
|
|
3930
|
-
* a number that is sometimes off by one is worse than one that is
|
|
3931
|
-
* consistently the prior total.
|
|
3932
|
-
*
|
|
3933
|
-
* So `deliveredCount > 0` means an earlier read was handed this comment, and
|
|
3934
|
-
* `0` means this read is the first. Neither says a model took it in — only
|
|
3935
|
-
* that the server handed it over.
|
|
3936
|
-
*/
|
|
3937
|
-
readonly deliveredCount: v.NumberSchema<undefined>;
|
|
3938
|
-
/**
|
|
3939
|
-
* This comment's thread root — its own id for every delivered root. Resolution
|
|
3940
|
-
* replies remain on the dashboard thread and are not delivered to agents.
|
|
3941
|
-
* It is on the wire from the first response
|
|
3942
|
-
* because the wire contract is consumed by installed CLI versions: reshaping
|
|
3943
|
-
* a flat `comments` array into threads-of-comments later would be a breaking
|
|
3944
|
-
* change, while a field today's readers ignore costs them nothing.
|
|
3945
|
-
*/
|
|
3946
|
-
readonly threadId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
3947
|
-
/**
|
|
3948
|
-
* Always `null` for a delivered root. Present so an older reader meeting a
|
|
3949
|
-
* future response that carries real replies degrades to
|
|
3950
|
-
* "a flat list of comments" rather than failing to parse.
|
|
3951
|
-
*/
|
|
3952
|
-
readonly replyToId: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>;
|
|
3953
|
-
}, undefined>, undefined>, v.MaxLengthAction<{
|
|
3954
|
-
id: string;
|
|
3955
|
-
state?: "open" | "resolved" | undefined;
|
|
3956
|
-
passage?: {
|
|
3957
|
-
quote: string;
|
|
3958
|
-
status: "located" | "changed" | "orphaned";
|
|
3959
|
-
lines: {
|
|
3960
|
-
start: number;
|
|
3961
|
-
end: number;
|
|
3962
|
-
} | null;
|
|
3963
|
-
} | undefined;
|
|
3964
|
-
body: string;
|
|
3965
|
-
suggestion?: string | undefined;
|
|
3966
|
-
finding?: {
|
|
3967
|
-
tier: "observed" | "usage" | "practice";
|
|
3968
|
-
tierLine: string;
|
|
3969
|
-
blindSpot: string;
|
|
3970
|
-
prediction: string | null;
|
|
3971
|
-
} | undefined;
|
|
3972
|
-
approved?: boolean | undefined;
|
|
3973
|
-
authorName: string | null;
|
|
3974
|
-
createdAt: string;
|
|
3975
|
-
itemVersion: number;
|
|
3976
|
-
itemChangedSince: boolean;
|
|
3977
|
-
deliveredCount: number;
|
|
3978
|
-
threadId: string;
|
|
3979
|
-
replyToId: string | null;
|
|
3980
|
-
}[], 20, undefined>]>, undefined>;
|
|
3981
|
-
readonly updatedAt: v.StringSchema<undefined>;
|
|
3982
|
-
/**
|
|
3983
|
-
* Present iff this artifact is owned by git. Absent means Mossbear owns it
|
|
3984
|
-
* and it is editable in the dashboard.
|
|
3985
|
-
*
|
|
3986
|
-
* **Optional, and absence is not yet a verdict.** Nothing writes this before
|
|
3987
|
-
* `publish` ships, so today every item omits it, and the existing bundle-home
|
|
3988
|
-
* rule — a bundle may name one repo as its only writer, and the server
|
|
3989
|
-
* refuses every other writer by name — is what still protects items a repo
|
|
3990
|
-
* already owns. A reader must not treat an absent `gitSource` as permission
|
|
3991
|
-
* to publish back.
|
|
3992
|
-
*
|
|
3993
|
-
* **Optional *and* nullable, like every other late-added column on this item.**
|
|
3994
|
-
* A serializer that maps the columns straight through emits `null` for a
|
|
3995
|
-
* Mossbear-owned row, and a key that only accepted `undefined` would throw on
|
|
3996
|
-
* the whole response rather than on the one item — `parseContextItemsResponse`
|
|
3997
|
-
* parses a pull as a batch. Both spellings read the same way: no git source.
|
|
3998
|
-
*
|
|
3999
|
-
* **`path` is the third required member of the subset and is not re-checked
|
|
4000
|
-
* here.** The database holds that invariant
|
|
4001
|
-
* (`guide_files_git_source_subset`), and a wire rule that looked identical
|
|
4002
|
-
* would in fact be stricter: `path` is serialized through a scope helper that
|
|
4003
|
-
* emits `null` for a path this schema cannot parse, so a single such row would
|
|
4004
|
-
* fail every other item in the same pull. A git-owned item that arrives
|
|
4005
|
-
* without a usable path is a broken item, not a broken response.
|
|
4006
|
-
*/
|
|
4007
|
-
readonly gitSource: v.OptionalSchema<v.NullableSchema<v.ObjectSchema<{
|
|
4008
|
-
/**
|
|
4009
|
-
* The committed `project.id` of the source repository — the same id space as
|
|
4010
|
-
* an item's delivery-scoping `projectId` below, but a different fact: that one
|
|
4011
|
-
* says which repo an item is materialized into and is stamped onto
|
|
4012
|
-
* Mossbear-owned rows too, this one says who may edit it.
|
|
4013
|
-
*/
|
|
4014
|
-
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">]>;
|
|
4015
|
-
readonly commitSha: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "commitSha must be 40 or 64 lowercase hex characters">]>;
|
|
4016
|
-
/**
|
|
4017
|
-
* The branch the publishing commit was on. **The one optional member**:
|
|
4018
|
-
* publication is not restricted by branch, so this is recorded so a subscriber
|
|
4019
|
-
* can see what they got, and a detached HEAD has none to record.
|
|
4020
|
-
*/
|
|
4021
|
-
readonly branch: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 255, undefined>]>, undefined>;
|
|
4022
|
-
}, undefined>, undefined>, undefined>;
|
|
4023
|
-
/**
|
|
4024
|
-
* This artifact is a **tombstone**: the repository that publishes it deleted
|
|
4025
|
-
* the file, so what the item still carries is the last revision rather than a
|
|
4026
|
-
* current one (`artifact-ownership-and-delivery-plan.md` → D28).
|
|
4027
|
-
*
|
|
4028
|
-
* **It is still delivered, and that is deliberate.** Dropping the item from
|
|
4029
|
-
* the response would say the same thing more quietly and cost two things
|
|
4030
|
-
* worth more than the byte: the publishing repo would lose the id it needs to
|
|
4031
|
-
* republish the path in place — re-adding a deleted file would create a
|
|
4032
|
-
* second artifact at the same path rather than a new revision of the one
|
|
4033
|
-
* that is there — and a reader would be left unable to tell a removal from
|
|
4034
|
-
* a bundle it has stopped being able to see. What the flag asks of a client
|
|
4035
|
-
* is one thing: do not materialize it. A file left at a discovery root keeps
|
|
4036
|
-
* feeding deleted guidance into every agent that reads that repo, which is
|
|
4037
|
-
* the failure the decision exists to stop.
|
|
4038
|
-
*
|
|
4039
|
-
* **Optional, and absent means an ordinary artifact.** A client that has
|
|
4040
|
-
* never heard of it behaves as it always did — it keeps the last published
|
|
4041
|
-
* revision on disk, which is the retain behaviour this replaces rather than a
|
|
4042
|
-
* new failure. That is what makes the server safe to ship first.
|
|
4043
|
-
*
|
|
4044
|
-
* `literal(true)` rather than a boolean: `removed: false` would be a second
|
|
4045
|
-
* spelling of absence, and an artifact that came back is content again rather
|
|
4046
|
-
* than a tombstone that says no.
|
|
4047
|
-
*/
|
|
4048
|
-
readonly removed: v.OptionalSchema<v.LiteralSchema<true, undefined>, undefined>;
|
|
4049
|
-
}, undefined>, v.TransformAction<{
|
|
4050
|
-
id: string;
|
|
4051
|
-
artifactId?: string | null | undefined;
|
|
4052
|
-
type?: string | undefined;
|
|
4053
|
-
name: string;
|
|
4054
|
-
role: string | null;
|
|
4055
|
-
format: string | null;
|
|
4056
|
-
content: string | null;
|
|
4057
|
-
origin?: string | null | undefined;
|
|
4058
|
-
version?: number | undefined;
|
|
4059
|
-
guideId?: string | null | undefined;
|
|
4060
|
-
root?: "project" | "global" | null | undefined;
|
|
4061
|
-
path?: string | null | undefined;
|
|
4062
|
-
projectId?: string | null | undefined;
|
|
4063
|
-
pathProjectId?: string | null | undefined;
|
|
4064
|
-
aliases?: {
|
|
4065
|
-
root: "project" | "global";
|
|
4066
|
-
path: string;
|
|
4067
|
-
}[] | undefined;
|
|
4068
|
-
comments?: {
|
|
4069
|
-
id: string;
|
|
4070
|
-
state?: "open" | "resolved" | undefined;
|
|
4071
|
-
passage?: {
|
|
4072
|
-
quote: string;
|
|
4073
|
-
status: "located" | "changed" | "orphaned";
|
|
4074
|
-
lines: {
|
|
4075
|
-
start: number;
|
|
4076
|
-
end: number;
|
|
4077
|
-
} | null;
|
|
4078
|
-
} | undefined;
|
|
4079
|
-
body: string;
|
|
4080
|
-
suggestion?: string | undefined;
|
|
4081
|
-
finding?: {
|
|
4082
|
-
tier: "observed" | "usage" | "practice";
|
|
4083
|
-
tierLine: string;
|
|
4084
|
-
blindSpot: string;
|
|
4085
|
-
prediction: string | null;
|
|
4086
|
-
} | undefined;
|
|
4087
|
-
approved?: boolean | undefined;
|
|
4088
|
-
authorName: string | null;
|
|
4089
|
-
createdAt: string;
|
|
4090
|
-
itemVersion: number;
|
|
4091
|
-
itemChangedSince: boolean;
|
|
4092
|
-
deliveredCount: number;
|
|
4093
|
-
threadId: string;
|
|
4094
|
-
replyToId: string | null;
|
|
4095
|
-
}[] | undefined;
|
|
4096
|
-
updatedAt: string;
|
|
4097
|
-
gitSource?: {
|
|
4098
|
-
projectId: string;
|
|
4099
|
-
commitSha: string;
|
|
4100
|
-
branch?: string | undefined;
|
|
4101
|
-
} | null | undefined;
|
|
4102
|
-
removed?: true | undefined;
|
|
4103
|
-
}, {
|
|
4104
|
-
type: string;
|
|
4105
|
-
id: string;
|
|
4106
|
-
artifactId?: string | null | undefined;
|
|
4107
|
-
name: string;
|
|
4108
|
-
role: string | null;
|
|
4109
|
-
format: string | null;
|
|
4110
|
-
content: string | null;
|
|
4111
|
-
origin?: string | null | undefined;
|
|
4112
|
-
version?: number | undefined;
|
|
4113
|
-
guideId?: string | null | undefined;
|
|
4114
|
-
root?: "project" | "global" | null | undefined;
|
|
4115
|
-
path?: string | null | undefined;
|
|
4116
|
-
projectId?: string | null | undefined;
|
|
4117
|
-
pathProjectId?: string | null | undefined;
|
|
4118
|
-
aliases?: {
|
|
4119
|
-
root: "project" | "global";
|
|
4120
|
-
path: string;
|
|
4121
|
-
}[] | undefined;
|
|
4122
|
-
comments?: {
|
|
4123
|
-
id: string;
|
|
4124
|
-
state?: "open" | "resolved" | undefined;
|
|
4125
|
-
passage?: {
|
|
4126
|
-
quote: string;
|
|
4127
|
-
status: "located" | "changed" | "orphaned";
|
|
4128
|
-
lines: {
|
|
4129
|
-
start: number;
|
|
4130
|
-
end: number;
|
|
4131
|
-
} | null;
|
|
4132
|
-
} | undefined;
|
|
4133
|
-
body: string;
|
|
4134
|
-
suggestion?: string | undefined;
|
|
4135
|
-
finding?: {
|
|
4136
|
-
tier: "observed" | "usage" | "practice";
|
|
4137
|
-
tierLine: string;
|
|
4138
|
-
blindSpot: string;
|
|
4139
|
-
prediction: string | null;
|
|
4140
|
-
} | undefined;
|
|
4141
|
-
approved?: boolean | undefined;
|
|
4142
|
-
authorName: string | null;
|
|
4143
|
-
createdAt: string;
|
|
4144
|
-
itemVersion: number;
|
|
4145
|
-
itemChangedSince: boolean;
|
|
4146
|
-
deliveredCount: number;
|
|
4147
|
-
threadId: string;
|
|
4148
|
-
replyToId: string | null;
|
|
4149
|
-
}[] | undefined;
|
|
4150
|
-
updatedAt: string;
|
|
4151
|
-
gitSource?: {
|
|
4152
|
-
projectId: string;
|
|
4153
|
-
commitSha: string;
|
|
4154
|
-
branch?: string | undefined;
|
|
4155
|
-
} | null | undefined;
|
|
4156
|
-
removed?: true | undefined;
|
|
4157
|
-
}>]>;
|
|
4158
|
-
}, undefined>;
|
|
4159
|
-
export declare const ArchiveContextItemResponseSchema: v.ObjectSchema<{
|
|
4160
|
-
readonly archived: v.BooleanSchema<undefined>;
|
|
4161
|
-
readonly item: v.SchemaWithPipe<readonly [v.ObjectSchema<{
|
|
4162
|
-
readonly id: v.StringSchema<undefined>;
|
|
4163
|
-
/**
|
|
4164
|
-
* The id every artifact route addresses: the body file's id for a guide
|
|
4165
|
-
* (null only for a guide with no body yet), the item's own id otherwise.
|
|
4166
|
-
* Optional so a client tolerates a server that predates it, and one that
|
|
4167
|
-
* stops sending it (the item id is the artifact id).
|
|
4168
|
-
*/
|
|
4169
|
-
readonly artifactId: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
|
|
4170
|
-
/**
|
|
4171
|
-
* Leaving the wire: a reader tells a guide from content by `role` and the
|
|
4172
|
-
* guide fields, not by this. Optional so a client parses a server that no
|
|
4173
|
-
* longer sends it.
|
|
4174
|
-
*/
|
|
4175
|
-
readonly type: v.OptionalSchema<v.PicklistSchema<string[], undefined>, undefined>;
|
|
4176
|
-
readonly name: v.StringSchema<undefined>;
|
|
4177
|
-
/**
|
|
4178
|
-
* The stored `(role, format)` pair, as two bare nullable strings.
|
|
4179
|
-
*
|
|
4180
|
-
* **Both are deliberately unenumerated.** A client switches on one value it
|
|
4181
|
-
* cares about — `role === 'criteria'` is how a rubric is told from ordinary
|
|
4182
|
-
* prose, which `type` cannot say because a rubric serializes as a `document` —
|
|
4183
|
-
* and a server that adds a fourth role or a fifth format must not break a
|
|
4184
|
-
* client that has never heard of it. Narrowing them here would make every such
|
|
4185
|
-
* addition a breaking wire change for no reader's benefit.
|
|
4186
|
-
*
|
|
4187
|
-
* Null on exactly the rows that carry no content: a tombstone, and an alias.
|
|
4188
|
-
* A `guide` item has no pair at all — it is a different table — and reports
|
|
4189
|
-
* both as null.
|
|
4190
|
-
*/
|
|
4191
|
-
readonly role: v.NullableSchema<v.StringSchema<undefined>, undefined>;
|
|
4192
|
-
readonly format: v.NullableSchema<v.StringSchema<undefined>, undefined>;
|
|
4193
|
-
readonly content: v.NullableSchema<v.StringSchema<undefined>, undefined>;
|
|
4194
|
-
readonly origin: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
|
|
4195
|
-
readonly version: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
|
|
4196
|
-
/**
|
|
4197
|
-
* The guide a **derived** item belongs to — its evaluation criteria, or a
|
|
4198
|
-
* skill's member files (`subscription-delivery-target-plan.md` → slice 4).
|
|
4199
|
-
*
|
|
4200
|
-
* Absent on everything else, including a guide itself: a guide member is
|
|
4201
|
-
* addressed by the guide's own id, so `id` already answers this for it.
|
|
4202
|
-
*
|
|
4203
|
-
* It exists because derived items have no bundle membership and no id of their
|
|
4204
|
-
* guide's — they are `guide_files` rows attached by `guide_id` — so a rule
|
|
4205
|
-
* expressed over guide ids (a subscriber's mute) cannot reach them from the
|
|
4206
|
-
* item alone. Muting a skill and still delivering its `scripts/` would leave a
|
|
4207
|
-
* broken half-skill on disk, which is worse than not muting at all.
|
|
4208
|
-
*/
|
|
4209
|
-
readonly guideId: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
|
|
4210
|
-
readonly root: v.OptionalSchema<v.NullableSchema<v.PicklistSchema<["project", "global"], undefined>, undefined>, undefined>;
|
|
4211
|
-
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>;
|
|
4212
|
-
readonly projectId: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
|
|
4213
|
-
/**
|
|
4214
|
-
* The repo a **document's** declared `path` is placed in — its home — as the
|
|
4215
|
-
* `project.id` of the checkout that last set the path. Documents only.
|
|
4216
|
-
*
|
|
4217
|
-
* Deliberately not `projectId` above: a reader takes a mismatch there as "this
|
|
4218
|
-
* item belongs to another repo, do not materialize it", so a home echoed on it
|
|
4219
|
-
* would stop every other subscriber receiving the document at all. A home says
|
|
4220
|
-
* only *where* the path is literal. Only the repo whose `project.id` matches
|
|
4221
|
-
* writes the document at `path`; every other repo mirrors it under the
|
|
4222
|
-
* bundle folder (`bundleMirrorPath` in `@mossbear/projections`).
|
|
4223
|
-
*
|
|
4224
|
-
* Absent and null read the same — **no home**, so no repo takes the path
|
|
4225
|
-
* literally for a new placement. A server predating the field says the same,
|
|
4226
|
-
* which is the safe direction: the file lands inside the bundle folder
|
|
4227
|
-
* instead of at a repo path it may not belong in.
|
|
4228
|
-
*/
|
|
4229
|
-
readonly pathProjectId: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
|
|
4230
|
-
readonly aliases: v.OptionalSchema<v.SchemaWithPipe<readonly [v.ArraySchema<v.ObjectSchema<{
|
|
4231
|
-
readonly root: v.PicklistSchema<["project", "global"], undefined>;
|
|
4232
|
-
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">]>;
|
|
4233
|
-
}, undefined>, undefined>, v.MaxLengthAction<{
|
|
4234
|
-
root: "project" | "global";
|
|
4235
|
-
path: string;
|
|
4236
|
-
}[], 8, undefined>]>, undefined>;
|
|
4237
|
-
/**
|
|
4238
|
-
* Open comments a person left about this item, newest first.
|
|
4239
|
-
*
|
|
4240
|
-
* Optional, and absent rather than empty when there are none — the same rule
|
|
4241
|
-
* `aliases` and `projectId` follow above, and for the same reason: an older
|
|
4242
|
-
* reader against a newer server ignores the key, and a newer reader against
|
|
4243
|
-
* an older server reads "no comments" instead of failing.
|
|
4244
|
-
*
|
|
4245
|
-
* **Absence is not a verdict.** No comments here means none were served on this
|
|
4246
|
-
* item in this response — not that nobody has anything to say about it.
|
|
4247
|
-
*/
|
|
4248
|
-
readonly comments: v.OptionalSchema<v.SchemaWithPipe<readonly [v.ArraySchema<v.ObjectSchema<{
|
|
4249
|
-
readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
4250
|
-
readonly state: v.OptionalSchema<v.PicklistSchema<["open", "resolved"], undefined>, undefined>;
|
|
4251
|
-
/** Current source location of an anchored passage, or its lost quote. */
|
|
4252
|
-
readonly passage: v.OptionalSchema<v.ObjectSchema<{
|
|
4253
|
-
readonly quote: v.StringSchema<undefined>;
|
|
4254
|
-
readonly status: v.PicklistSchema<["located", "changed", "orphaned"], undefined>;
|
|
4255
|
-
readonly lines: v.NullableSchema<v.ObjectSchema<{
|
|
4256
|
-
readonly start: v.NumberSchema<undefined>;
|
|
4257
|
-
readonly end: v.NumberSchema<undefined>;
|
|
4258
|
-
}, undefined>, undefined>;
|
|
4259
|
-
}, undefined>, undefined>;
|
|
4260
|
-
/** The comment's text, already wrapped in the response's untrusted markers. */
|
|
4261
|
-
readonly body: v.StringSchema<undefined>;
|
|
4262
|
-
/**
|
|
4263
|
-
* A suggested edit: the replacement for the passage at `passage.lines`,
|
|
4264
|
-
* already wrapped in the response's untrusted markers like `body`. An
|
|
4265
|
-
* insertion is the passage plus its new lines and an empty replacement is a
|
|
4266
|
-
* deletion, so every edit is one replace. Absent on an ordinary comment.
|
|
4267
|
-
*/
|
|
4268
|
-
readonly suggestion: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
|
|
4269
|
-
/**
|
|
4270
|
-
* What a comment Mossbear wrote is: a finding about the item, never an edit.
|
|
4271
|
-
* Present only on a Mossbear comment. The comment's `body` begins with the
|
|
4272
|
-
* claim (what goes wrong); this carries what the claim rests on.
|
|
4273
|
-
*/
|
|
4274
|
-
readonly finding: v.OptionalSchema<v.ObjectSchema<{
|
|
4275
|
-
readonly tier: v.PicklistSchema<["observed", "usage", "practice"], undefined>;
|
|
4276
|
-
/** How the finding is known, in one line: "Seen in 3 sessions (2026-09-15 – 2026-10-03)". */
|
|
4277
|
-
readonly tierLine: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 300, undefined>]>;
|
|
4278
|
-
/** What the drafter did not read, fixed per tier. */
|
|
4279
|
-
readonly blindSpot: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 300, undefined>]>;
|
|
4280
|
-
/** What should change in later sessions if the finding is fixed, wrapped in the untrusted markers. */
|
|
4281
|
-
readonly prediction: v.NullableSchema<v.StringSchema<undefined>, undefined>;
|
|
4282
|
-
}, undefined>, undefined>;
|
|
4283
|
-
/**
|
|
4284
|
-
* Whether the person approved a comment Mossbear drafted. Present on every
|
|
4285
|
-
* Mossbear comment and absent on a person's or an agent's, which are
|
|
4286
|
-
* requests as written. `false` is a draft nobody has read yet: a reader shows
|
|
4287
|
-
* it to the user and acts only on their go-ahead. Only a client that reports
|
|
4288
|
-
* a version able to mark drafts is ever listed one, so an older reader that
|
|
4289
|
-
* strips this field never receives a draft it would print as a request.
|
|
4290
|
-
*/
|
|
4291
|
-
readonly approved: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
|
|
4292
|
-
/** The author's display name as the workspace shows it, or null. Never an email. */
|
|
4293
|
-
readonly authorName: v.NullableSchema<v.StringSchema<undefined>, undefined>;
|
|
4294
|
-
/** ISO timestamp, machine format. */
|
|
4295
|
-
readonly createdAt: v.StringSchema<undefined>;
|
|
4296
|
-
/** The item's content version the comment was written against. */
|
|
4297
|
-
readonly itemVersion: v.NumberSchema<undefined>;
|
|
4298
|
-
/** True when the item's current version is greater than `itemVersion`. */
|
|
4299
|
-
readonly itemChangedSince: v.BooleanSchema<undefined>;
|
|
4300
|
-
/**
|
|
4301
|
-
* How many agent reads were handed this comment **before** this one — so a
|
|
4302
|
-
* comment reaching an agent for the first time reports `0`.
|
|
4303
|
-
*
|
|
4304
|
-
* It is the stored count as it read at the moment the response was built;
|
|
4305
|
-
* the serve this response *is* has not been counted yet. Excluded rather
|
|
4306
|
-
* than included because the count is recorded best-effort: a response that
|
|
4307
|
-
* claimed to include itself would be wrong whenever that record failed, and
|
|
4308
|
-
* a number that is sometimes off by one is worse than one that is
|
|
4309
|
-
* consistently the prior total.
|
|
4310
|
-
*
|
|
4311
|
-
* So `deliveredCount > 0` means an earlier read was handed this comment, and
|
|
4312
|
-
* `0` means this read is the first. Neither says a model took it in — only
|
|
4313
|
-
* that the server handed it over.
|
|
4314
|
-
*/
|
|
4315
|
-
readonly deliveredCount: v.NumberSchema<undefined>;
|
|
4316
|
-
/**
|
|
4317
|
-
* This comment's thread root — its own id for every delivered root. Resolution
|
|
4318
|
-
* replies remain on the dashboard thread and are not delivered to agents.
|
|
4319
|
-
* It is on the wire from the first response
|
|
4320
|
-
* because the wire contract is consumed by installed CLI versions: reshaping
|
|
4321
|
-
* a flat `comments` array into threads-of-comments later would be a breaking
|
|
4322
|
-
* change, while a field today's readers ignore costs them nothing.
|
|
4323
|
-
*/
|
|
4324
|
-
readonly threadId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
4325
|
-
/**
|
|
4326
|
-
* Always `null` for a delivered root. Present so an older reader meeting a
|
|
4327
|
-
* future response that carries real replies degrades to
|
|
4328
|
-
* "a flat list of comments" rather than failing to parse.
|
|
4329
|
-
*/
|
|
4330
|
-
readonly replyToId: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>;
|
|
4331
|
-
}, undefined>, undefined>, v.MaxLengthAction<{
|
|
4332
|
-
id: string;
|
|
4333
|
-
state?: "open" | "resolved" | undefined;
|
|
4334
|
-
passage?: {
|
|
4335
|
-
quote: string;
|
|
4336
|
-
status: "located" | "changed" | "orphaned";
|
|
4337
|
-
lines: {
|
|
4338
|
-
start: number;
|
|
4339
|
-
end: number;
|
|
4340
|
-
} | null;
|
|
4341
|
-
} | undefined;
|
|
4342
|
-
body: string;
|
|
4343
|
-
suggestion?: string | undefined;
|
|
4344
|
-
finding?: {
|
|
4345
|
-
tier: "observed" | "usage" | "practice";
|
|
4346
|
-
tierLine: string;
|
|
4347
|
-
blindSpot: string;
|
|
4348
|
-
prediction: string | null;
|
|
4349
|
-
} | undefined;
|
|
4350
|
-
approved?: boolean | undefined;
|
|
4351
|
-
authorName: string | null;
|
|
4352
|
-
createdAt: string;
|
|
4353
|
-
itemVersion: number;
|
|
4354
|
-
itemChangedSince: boolean;
|
|
4355
|
-
deliveredCount: number;
|
|
4356
|
-
threadId: string;
|
|
4357
|
-
replyToId: string | null;
|
|
4358
|
-
}[], 20, undefined>]>, undefined>;
|
|
4359
|
-
readonly updatedAt: v.StringSchema<undefined>;
|
|
4360
|
-
/**
|
|
4361
|
-
* Present iff this artifact is owned by git. Absent means Mossbear owns it
|
|
4362
|
-
* and it is editable in the dashboard.
|
|
4363
|
-
*
|
|
4364
|
-
* **Optional, and absence is not yet a verdict.** Nothing writes this before
|
|
4365
|
-
* `publish` ships, so today every item omits it, and the existing bundle-home
|
|
4366
|
-
* rule — a bundle may name one repo as its only writer, and the server
|
|
4367
|
-
* refuses every other writer by name — is what still protects items a repo
|
|
4368
|
-
* already owns. A reader must not treat an absent `gitSource` as permission
|
|
4369
|
-
* to publish back.
|
|
4370
|
-
*
|
|
4371
|
-
* **Optional *and* nullable, like every other late-added column on this item.**
|
|
4372
|
-
* A serializer that maps the columns straight through emits `null` for a
|
|
4373
|
-
* Mossbear-owned row, and a key that only accepted `undefined` would throw on
|
|
4374
|
-
* the whole response rather than on the one item — `parseContextItemsResponse`
|
|
4375
|
-
* parses a pull as a batch. Both spellings read the same way: no git source.
|
|
4376
|
-
*
|
|
4377
|
-
* **`path` is the third required member of the subset and is not re-checked
|
|
4378
|
-
* here.** The database holds that invariant
|
|
4379
|
-
* (`guide_files_git_source_subset`), and a wire rule that looked identical
|
|
4380
|
-
* would in fact be stricter: `path` is serialized through a scope helper that
|
|
4381
|
-
* emits `null` for a path this schema cannot parse, so a single such row would
|
|
4382
|
-
* fail every other item in the same pull. A git-owned item that arrives
|
|
4383
|
-
* without a usable path is a broken item, not a broken response.
|
|
4384
|
-
*/
|
|
4385
|
-
readonly gitSource: v.OptionalSchema<v.NullableSchema<v.ObjectSchema<{
|
|
4386
|
-
/**
|
|
4387
|
-
* The committed `project.id` of the source repository — the same id space as
|
|
4388
|
-
* an item's delivery-scoping `projectId` below, but a different fact: that one
|
|
4389
|
-
* says which repo an item is materialized into and is stamped onto
|
|
4390
|
-
* Mossbear-owned rows too, this one says who may edit it.
|
|
4391
|
-
*/
|
|
4392
|
-
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">]>;
|
|
4393
|
-
readonly commitSha: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "commitSha must be 40 or 64 lowercase hex characters">]>;
|
|
4394
|
-
/**
|
|
4395
|
-
* The branch the publishing commit was on. **The one optional member**:
|
|
4396
|
-
* publication is not restricted by branch, so this is recorded so a subscriber
|
|
4397
|
-
* can see what they got, and a detached HEAD has none to record.
|
|
4398
|
-
*/
|
|
4399
|
-
readonly branch: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 255, undefined>]>, undefined>;
|
|
4400
|
-
}, undefined>, undefined>, undefined>;
|
|
4401
|
-
/**
|
|
4402
|
-
* This artifact is a **tombstone**: the repository that publishes it deleted
|
|
4403
|
-
* the file, so what the item still carries is the last revision rather than a
|
|
4404
|
-
* current one (`artifact-ownership-and-delivery-plan.md` → D28).
|
|
4405
|
-
*
|
|
4406
|
-
* **It is still delivered, and that is deliberate.** Dropping the item from
|
|
4407
|
-
* the response would say the same thing more quietly and cost two things
|
|
4408
|
-
* worth more than the byte: the publishing repo would lose the id it needs to
|
|
4409
|
-
* republish the path in place — re-adding a deleted file would create a
|
|
4410
|
-
* second artifact at the same path rather than a new revision of the one
|
|
4411
|
-
* that is there — and a reader would be left unable to tell a removal from
|
|
4412
|
-
* a bundle it has stopped being able to see. What the flag asks of a client
|
|
4413
|
-
* is one thing: do not materialize it. A file left at a discovery root keeps
|
|
4414
|
-
* feeding deleted guidance into every agent that reads that repo, which is
|
|
4415
|
-
* the failure the decision exists to stop.
|
|
4416
|
-
*
|
|
4417
|
-
* **Optional, and absent means an ordinary artifact.** A client that has
|
|
4418
|
-
* never heard of it behaves as it always did — it keeps the last published
|
|
4419
|
-
* revision on disk, which is the retain behaviour this replaces rather than a
|
|
4420
|
-
* new failure. That is what makes the server safe to ship first.
|
|
4421
|
-
*
|
|
4422
|
-
* `literal(true)` rather than a boolean: `removed: false` would be a second
|
|
4423
|
-
* spelling of absence, and an artifact that came back is content again rather
|
|
4424
|
-
* than a tombstone that says no.
|
|
4425
|
-
*/
|
|
4426
|
-
readonly removed: v.OptionalSchema<v.LiteralSchema<true, undefined>, undefined>;
|
|
4427
|
-
}, undefined>, v.TransformAction<{
|
|
4428
|
-
id: string;
|
|
4429
|
-
artifactId?: string | null | undefined;
|
|
4430
|
-
type?: string | undefined;
|
|
4431
|
-
name: string;
|
|
4432
|
-
role: string | null;
|
|
4433
|
-
format: string | null;
|
|
4434
|
-
content: string | null;
|
|
4435
|
-
origin?: string | null | undefined;
|
|
4436
|
-
version?: number | undefined;
|
|
4437
|
-
guideId?: string | null | undefined;
|
|
4438
|
-
root?: "project" | "global" | null | undefined;
|
|
4439
|
-
path?: string | null | undefined;
|
|
4440
|
-
projectId?: string | null | undefined;
|
|
4441
|
-
pathProjectId?: string | null | undefined;
|
|
4442
|
-
aliases?: {
|
|
4443
|
-
root: "project" | "global";
|
|
4444
|
-
path: string;
|
|
4445
|
-
}[] | undefined;
|
|
4446
|
-
comments?: {
|
|
4447
|
-
id: string;
|
|
4448
|
-
state?: "open" | "resolved" | undefined;
|
|
4449
|
-
passage?: {
|
|
4450
|
-
quote: string;
|
|
4451
|
-
status: "located" | "changed" | "orphaned";
|
|
4452
|
-
lines: {
|
|
4453
|
-
start: number;
|
|
4454
|
-
end: number;
|
|
4455
|
-
} | null;
|
|
4456
|
-
} | undefined;
|
|
4457
|
-
body: string;
|
|
4458
|
-
suggestion?: string | undefined;
|
|
4459
|
-
finding?: {
|
|
4460
|
-
tier: "observed" | "usage" | "practice";
|
|
4461
|
-
tierLine: string;
|
|
4462
|
-
blindSpot: string;
|
|
4463
|
-
prediction: string | null;
|
|
4464
|
-
} | undefined;
|
|
4465
|
-
approved?: boolean | undefined;
|
|
4466
|
-
authorName: string | null;
|
|
4467
|
-
createdAt: string;
|
|
4468
|
-
itemVersion: number;
|
|
4469
|
-
itemChangedSince: boolean;
|
|
4470
|
-
deliveredCount: number;
|
|
4471
|
-
threadId: string;
|
|
4472
|
-
replyToId: string | null;
|
|
4473
|
-
}[] | undefined;
|
|
4474
|
-
updatedAt: string;
|
|
4475
|
-
gitSource?: {
|
|
4476
|
-
projectId: string;
|
|
4477
|
-
commitSha: string;
|
|
4478
|
-
branch?: string | undefined;
|
|
4479
|
-
} | null | undefined;
|
|
4480
|
-
removed?: true | undefined;
|
|
4481
|
-
}, {
|
|
4482
|
-
type: string;
|
|
4483
|
-
id: string;
|
|
4484
|
-
artifactId?: string | null | undefined;
|
|
4485
|
-
name: string;
|
|
4486
|
-
role: string | null;
|
|
4487
|
-
format: string | null;
|
|
4488
|
-
content: string | null;
|
|
4489
|
-
origin?: string | null | undefined;
|
|
4490
|
-
version?: number | undefined;
|
|
4491
|
-
guideId?: string | null | undefined;
|
|
4492
|
-
root?: "project" | "global" | null | undefined;
|
|
4493
|
-
path?: string | null | undefined;
|
|
4494
|
-
projectId?: string | null | undefined;
|
|
4495
|
-
pathProjectId?: string | null | undefined;
|
|
4496
|
-
aliases?: {
|
|
4497
|
-
root: "project" | "global";
|
|
4498
|
-
path: string;
|
|
4499
|
-
}[] | undefined;
|
|
4500
|
-
comments?: {
|
|
4501
|
-
id: string;
|
|
4502
|
-
state?: "open" | "resolved" | undefined;
|
|
4503
|
-
passage?: {
|
|
4504
|
-
quote: string;
|
|
4505
|
-
status: "located" | "changed" | "orphaned";
|
|
4506
|
-
lines: {
|
|
4507
|
-
start: number;
|
|
4508
|
-
end: number;
|
|
4509
|
-
} | null;
|
|
4510
|
-
} | undefined;
|
|
4511
|
-
body: string;
|
|
4512
|
-
suggestion?: string | undefined;
|
|
4513
|
-
finding?: {
|
|
4514
|
-
tier: "observed" | "usage" | "practice";
|
|
4515
|
-
tierLine: string;
|
|
4516
|
-
blindSpot: string;
|
|
4517
|
-
prediction: string | null;
|
|
4518
|
-
} | undefined;
|
|
4519
|
-
approved?: boolean | undefined;
|
|
4520
|
-
authorName: string | null;
|
|
4521
|
-
createdAt: string;
|
|
4522
|
-
itemVersion: number;
|
|
4523
|
-
itemChangedSince: boolean;
|
|
4524
|
-
deliveredCount: number;
|
|
4525
|
-
threadId: string;
|
|
4526
|
-
replyToId: string | null;
|
|
4527
|
-
}[] | undefined;
|
|
4528
|
-
updatedAt: string;
|
|
4529
|
-
gitSource?: {
|
|
4530
|
-
projectId: string;
|
|
4531
|
-
commitSha: string;
|
|
4532
|
-
branch?: string | undefined;
|
|
4533
|
-
} | null | undefined;
|
|
4534
|
-
removed?: true | undefined;
|
|
4535
|
-
}>]>;
|
|
2889
|
+
}, undefined>;
|
|
2890
|
+
readonly rubricVersion: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>]>;
|
|
2891
|
+
readonly practices: v.OptionalSchema<v.ArraySchema<v.ObjectSchema<{
|
|
2892
|
+
readonly text: v.StringSchema<undefined>;
|
|
2893
|
+
readonly source: v.ObjectSchema<{
|
|
2894
|
+
readonly title: v.StringSchema<undefined>;
|
|
2895
|
+
readonly url: v.StringSchema<undefined>;
|
|
2896
|
+
}, undefined>;
|
|
2897
|
+
}, undefined>, undefined>, readonly []>;
|
|
2898
|
+
readonly facts: v.OptionalSchema<v.ArraySchema<v.StringSchema<undefined>, undefined>, readonly []>;
|
|
2899
|
+
readonly answers: v.OptionalSchema<v.ArraySchema<v.ObjectSchema<{
|
|
2900
|
+
readonly item: v.StringSchema<undefined>;
|
|
2901
|
+
readonly answer: v.StringSchema<undefined>;
|
|
2902
|
+
}, undefined>, undefined>, readonly []>;
|
|
2903
|
+
}, undefined>;
|
|
2904
|
+
/**
|
|
2905
|
+
* A comment the person (or Mossbear) left on one of the sessions a finding
|
|
2906
|
+
* cites — the person's own account of what the agent should have known, set
|
|
2907
|
+
* beside the grader's excerpt (`guide-findings-plan.md` → Your note on a
|
|
2908
|
+
* session).
|
|
2909
|
+
*
|
|
2910
|
+
* **Reachable only here.** A comment about a session is never listed by
|
|
2911
|
+
* `list_comments` or announced at session start: it is context for a finding,
|
|
2912
|
+
* found by following the finding's citation, not a request.
|
|
2913
|
+
*/
|
|
2914
|
+
export declare const CommentEvidenceSessionCommentSchema: v.ObjectSchema<{
|
|
2915
|
+
readonly sessionId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
2916
|
+
/** Only the person's own notes are sent today; `mossbear` is reserved. */
|
|
2917
|
+
readonly authorKind: v.PicklistSchema<["person", "mossbear"], undefined>;
|
|
2918
|
+
/** ISO, when the comment was written. */
|
|
2919
|
+
readonly at: v.StringSchema<undefined>;
|
|
2920
|
+
/** Wrapped in the response's untrusted markers. */
|
|
2921
|
+
readonly body: v.StringSchema<undefined>;
|
|
2922
|
+
}, undefined>;
|
|
2923
|
+
export type CommentEvidenceSessionComment = v.InferOutput<typeof CommentEvidenceSessionCommentSchema>;
|
|
2924
|
+
export declare const CommentEvidenceResponseSchema: v.ObjectSchema<{
|
|
2925
|
+
/** The comment's full id, even when the request named a prefix. */
|
|
2926
|
+
readonly commentId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
2927
|
+
readonly itemName: v.StringSchema<undefined>;
|
|
2928
|
+
readonly itemPath: v.NullableSchema<v.StringSchema<undefined>, undefined>;
|
|
2929
|
+
readonly tier: v.PicklistSchema<["observed", "usage", "practice"], undefined>;
|
|
2930
|
+
/** One line saying how the finding is known; server-written, outside the markers. */
|
|
2931
|
+
readonly tierLine: v.StringSchema<undefined>;
|
|
2932
|
+
/** What the drafter did not read; server-written, outside the markers. */
|
|
2933
|
+
readonly blindSpot: v.StringSchema<undefined>;
|
|
2934
|
+
/** What goes wrong, wrapped in the response's untrusted markers. */
|
|
2935
|
+
readonly claim: v.StringSchema<undefined>;
|
|
2936
|
+
/** What future sessions should show if the finding is fixed, wrapped; null if none. */
|
|
2937
|
+
readonly prediction: v.NullableSchema<v.StringSchema<undefined>, undefined>;
|
|
2938
|
+
/** A usage finding's counts; null on every other tier. */
|
|
2939
|
+
readonly usage: v.NullableSchema<v.ObjectSchema<{
|
|
2940
|
+
/** The reference's skill-relative path, wrapped in the response's untrusted markers. */
|
|
2941
|
+
readonly path: v.StringSchema<undefined>;
|
|
2942
|
+
/** Eligible loads of the skill. */
|
|
2943
|
+
readonly loads: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>]>;
|
|
2944
|
+
/** Distinct sessions those loads span. */
|
|
2945
|
+
readonly sessions: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>]>;
|
|
2946
|
+
/** Loads followed by a successful read of the reference. */
|
|
2947
|
+
readonly loadsWithRead: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>]>;
|
|
2948
|
+
}, undefined>, undefined>;
|
|
2949
|
+
/** A practice finding's rubric check; null on every other tier. */
|
|
2950
|
+
readonly practice: v.NullableSchema<v.ObjectSchema<{
|
|
2951
|
+
readonly check: v.ObjectSchema<{
|
|
2952
|
+
readonly id: v.StringSchema<undefined>;
|
|
2953
|
+
readonly name: v.StringSchema<undefined>;
|
|
2954
|
+
}, undefined>;
|
|
2955
|
+
readonly rubricVersion: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>]>;
|
|
2956
|
+
readonly practices: v.OptionalSchema<v.ArraySchema<v.ObjectSchema<{
|
|
2957
|
+
readonly text: v.StringSchema<undefined>;
|
|
2958
|
+
readonly source: v.ObjectSchema<{
|
|
2959
|
+
readonly title: v.StringSchema<undefined>;
|
|
2960
|
+
readonly url: v.StringSchema<undefined>;
|
|
2961
|
+
}, undefined>;
|
|
2962
|
+
}, undefined>, undefined>, readonly []>;
|
|
2963
|
+
readonly facts: v.OptionalSchema<v.ArraySchema<v.StringSchema<undefined>, undefined>, readonly []>;
|
|
2964
|
+
readonly answers: v.OptionalSchema<v.ArraySchema<v.ObjectSchema<{
|
|
2965
|
+
readonly item: v.StringSchema<undefined>;
|
|
2966
|
+
readonly answer: v.StringSchema<undefined>;
|
|
2967
|
+
}, undefined>, undefined>, readonly []>;
|
|
2968
|
+
}, undefined>, undefined>;
|
|
2969
|
+
readonly citations: v.ArraySchema<v.ObjectSchema<{
|
|
2970
|
+
/**
|
|
2971
|
+
* `navigation` is a skill load counted when a finding was drafted from how
|
|
2972
|
+
* the skill's files were read: evidence of how a skill was used, not of a
|
|
2973
|
+
* failure. `action` is a recorded step of a workflow repeated across
|
|
2974
|
+
* sessions. A server sends it only to a client that names a version new
|
|
2975
|
+
* enough to parse it.
|
|
2976
|
+
*/
|
|
2977
|
+
readonly kind: v.PicklistSchema<["verdict", "turn", "navigation", "action"], undefined>;
|
|
2978
|
+
readonly sessionId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
2979
|
+
/** ISO, when the verdict was graded, the turn was said, the skill loaded, or the action was recorded. */
|
|
2980
|
+
readonly at: v.StringSchema<undefined>;
|
|
2981
|
+
/** Wrapped in the response's untrusted markers. */
|
|
2982
|
+
readonly excerpt: v.StringSchema<undefined>;
|
|
2983
|
+
}, undefined>, undefined>;
|
|
2984
|
+
readonly citationsWithheld: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>]>;
|
|
2985
|
+
/**
|
|
2986
|
+
* Comments on the cited sessions, newest first, wrapped in the untrusted
|
|
2987
|
+
* markers. Defaulted so a response from a server that predates the field
|
|
2988
|
+
* still parses.
|
|
2989
|
+
*/
|
|
2990
|
+
readonly sessionComments: v.OptionalSchema<v.ArraySchema<v.ObjectSchema<{
|
|
2991
|
+
readonly sessionId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
2992
|
+
/** Only the person's own notes are sent today; `mossbear` is reserved. */
|
|
2993
|
+
readonly authorKind: v.PicklistSchema<["person", "mossbear"], undefined>;
|
|
2994
|
+
/** ISO, when the comment was written. */
|
|
2995
|
+
readonly at: v.StringSchema<undefined>;
|
|
2996
|
+
/** Wrapped in the response's untrusted markers. */
|
|
2997
|
+
readonly body: v.StringSchema<undefined>;
|
|
2998
|
+
}, undefined>, undefined>, readonly []>;
|
|
2999
|
+
/**
|
|
3000
|
+
* Comments on the cited sessions that were left out to keep the response
|
|
3001
|
+
* bounded (the newest few per session are sent), so a short list is never
|
|
3002
|
+
* mistaken for the whole of it. Zero when none were.
|
|
3003
|
+
*/
|
|
3004
|
+
readonly sessionCommentsWithheld: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>]>, 0>;
|
|
3005
|
+
readonly untrusted: v.ObjectSchema<{
|
|
3006
|
+
readonly token: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
3007
|
+
readonly startMarker: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
3008
|
+
readonly endMarker: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
3009
|
+
readonly note: v.StringSchema<undefined>;
|
|
3010
|
+
}, undefined>;
|
|
4536
3011
|
}, undefined>;
|
|
3012
|
+
export type CommentEvidenceResponse = v.InferOutput<typeof CommentEvidenceResponseSchema>;
|
|
4537
3013
|
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">]>;
|
|
4538
3014
|
export declare const InboxCaptureRequestSchema: v.ObjectSchema<{
|
|
4539
3015
|
/**
|
|
@@ -4625,24 +3101,7 @@ export declare const ArtifactVersionDetailSchema: v.ObjectSchema<{
|
|
|
4625
3101
|
readonly createdAt: v.StringSchema<undefined>;
|
|
4626
3102
|
}, undefined>;
|
|
4627
3103
|
/** The item routes' names for the version schemas, kept while those routes are served. */
|
|
4628
|
-
export declare const
|
|
4629
|
-
readonly id: v.StringSchema<undefined>;
|
|
4630
|
-
readonly version: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>;
|
|
4631
|
-
readonly contentHash: v.StringSchema<undefined>;
|
|
4632
|
-
readonly authorType: v.StringSchema<undefined>;
|
|
4633
|
-
readonly metadata: v.OptionalSchema<v.NullableSchema<v.RecordSchema<v.StringSchema<undefined>, v.UnknownSchema, undefined>, undefined>, undefined>;
|
|
4634
|
-
readonly createdAt: v.StringSchema<undefined>;
|
|
4635
|
-
}, undefined>;
|
|
4636
|
-
export declare const ContextItemVersionDetailSchema: v.ObjectSchema<{
|
|
4637
|
-
readonly id: v.StringSchema<undefined>;
|
|
4638
|
-
readonly version: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>;
|
|
4639
|
-
readonly content: v.NullableSchema<v.StringSchema<undefined>, undefined>;
|
|
4640
|
-
readonly contentHash: v.StringSchema<undefined>;
|
|
4641
|
-
readonly authorType: v.StringSchema<undefined>;
|
|
4642
|
-
readonly metadata: v.OptionalSchema<v.NullableSchema<v.RecordSchema<v.StringSchema<undefined>, v.UnknownSchema, undefined>, undefined>, undefined>;
|
|
4643
|
-
readonly createdAt: v.StringSchema<undefined>;
|
|
4644
|
-
}, undefined>;
|
|
4645
|
-
export declare const ContextItemVersionsResponseSchema: v.ObjectSchema<{
|
|
3104
|
+
export declare const BundleArtifactVersionsResponseSchema: v.ObjectSchema<{
|
|
4646
3105
|
readonly versions: v.ArraySchema<v.ObjectSchema<{
|
|
4647
3106
|
readonly id: v.StringSchema<undefined>;
|
|
4648
3107
|
readonly version: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>;
|
|
@@ -4653,17 +3112,6 @@ export declare const ContextItemVersionsResponseSchema: v.ObjectSchema<{
|
|
|
4653
3112
|
}, undefined>, undefined>;
|
|
4654
3113
|
readonly nextCursor: v.NullableSchema<v.NumberSchema<undefined>, undefined>;
|
|
4655
3114
|
}, undefined>;
|
|
4656
|
-
export declare const ContextItemVersionResponseSchema: v.ObjectSchema<{
|
|
4657
|
-
readonly version: v.ObjectSchema<{
|
|
4658
|
-
readonly id: v.StringSchema<undefined>;
|
|
4659
|
-
readonly version: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>;
|
|
4660
|
-
readonly content: v.NullableSchema<v.StringSchema<undefined>, undefined>;
|
|
4661
|
-
readonly contentHash: v.StringSchema<undefined>;
|
|
4662
|
-
readonly authorType: v.StringSchema<undefined>;
|
|
4663
|
-
readonly metadata: v.OptionalSchema<v.NullableSchema<v.RecordSchema<v.StringSchema<undefined>, v.UnknownSchema, undefined>, undefined>, undefined>;
|
|
4664
|
-
readonly createdAt: v.StringSchema<undefined>;
|
|
4665
|
-
}, undefined>;
|
|
4666
|
-
}, undefined>;
|
|
4667
3115
|
/** Default and max page size for the version-history list endpoint. */
|
|
4668
3116
|
export declare const DEFAULT_VERSIONS_LIMIT = 50;
|
|
4669
3117
|
export declare const MAX_VERSIONS_LIMIT = 200;
|
|
@@ -8123,27 +6571,18 @@ export declare const SEARCH_COMMENT_AUTHOR_KINDS: readonly ["person", "agent", "
|
|
|
8123
6571
|
export declare const SearchCommentAuthorKindSchema: v.PicklistSchema<readonly ["person", "agent", "mossbear"], undefined>;
|
|
8124
6572
|
export type SearchCommentAuthorKind = v.InferOutput<typeof SearchCommentAuthorKindSchema>;
|
|
8125
6573
|
/**
|
|
8126
|
-
* What a comment is attached to. `
|
|
8127
|
-
* run the caller made. Session comments are the caller's own and never reach
|
|
8128
|
-
* workspace-mate.
|
|
6574
|
+
* What a comment is attached to. `artifact` is a guide or a document; `session`
|
|
6575
|
+
* is a run the caller made. Session comments are the caller's own and never reach
|
|
6576
|
+
* a workspace-mate.
|
|
8129
6577
|
*/
|
|
8130
|
-
export declare const SEARCH_COMMENT_SUBJECT_KINDS: readonly ["item", "session"];
|
|
8131
|
-
export declare const SearchCommentSubjectKindSchema: v.PicklistSchema<readonly ["item", "session"], undefined>;
|
|
8132
|
-
export type SearchCommentSubjectKind = v.InferOutput<typeof SearchCommentSubjectKindSchema>;
|
|
8133
6578
|
/**
|
|
8134
6579
|
* The subject kinds a client names in a search: `artifact`, never its older
|
|
8135
6580
|
* name `item`.
|
|
8136
6581
|
*/
|
|
8137
6582
|
export declare const SEARCH_COMMENT_SUBJECT_KIND_NAMES: readonly ["artifact", "session"];
|
|
8138
|
-
export
|
|
8139
|
-
/**
|
|
8140
|
-
* The subject kinds a search request may name. `artifact` is the new name for
|
|
8141
|
-
* `item` and means the same subjects; both are accepted until every client sends
|
|
8142
|
-
* `artifact`, while hits and the advertised list above still say `item`.
|
|
8143
|
-
*/
|
|
8144
|
-
export declare const SEARCH_COMMENT_SUBJECT_KIND_FILTERS: readonly ["item", "session", "artifact"];
|
|
8145
|
-
export declare const SearchCommentSubjectKindFilterSchema: v.PicklistSchema<readonly ["item", "session", "artifact"], undefined>;
|
|
6583
|
+
export declare const SearchCommentSubjectKindFilterSchema: v.PicklistSchema<readonly ["artifact", "session"], undefined>;
|
|
8146
6584
|
export type SearchCommentSubjectKindFilter = v.InferOutput<typeof SearchCommentSubjectKindFilterSchema>;
|
|
6585
|
+
export type SearchCommentSubjectKindName = (typeof SEARCH_COMMENT_SUBJECT_KIND_NAMES)[number];
|
|
8147
6586
|
/**
|
|
8148
6587
|
* What a user turn was, as the session classifier labels it. The same
|
|
8149
6588
|
* vocabulary the classifier writes; a `turns` search may keep only some.
|
|
@@ -8198,7 +6637,7 @@ export declare const SearchRequestObjectSchema: v.ObjectSchema<{
|
|
|
8198
6637
|
* Restrict the `comments` corpus to comments on these kinds of subject. Does
|
|
8199
6638
|
* not touch other corpora.
|
|
8200
6639
|
*/
|
|
8201
|
-
readonly subjectKinds: v.OptionalSchema<v.SchemaWithPipe<readonly [v.ArraySchema<v.PicklistSchema<readonly ["
|
|
6640
|
+
readonly subjectKinds: v.OptionalSchema<v.SchemaWithPipe<readonly [v.ArraySchema<v.PicklistSchema<readonly ["artifact", "session"], undefined>, undefined>, v.MinLengthAction<("artifact" | "session")[], 1, undefined>]>, undefined>;
|
|
8202
6641
|
/**
|
|
8203
6642
|
* Restrict the `turns` corpus to turns the classifier gave one of these
|
|
8204
6643
|
* labels. A turn with no label never matches. Does not touch other corpora.
|
|
@@ -8268,7 +6707,7 @@ export declare const SearchRequestSchema: v.SchemaWithPipe<readonly [v.ObjectSch
|
|
|
8268
6707
|
* Restrict the `comments` corpus to comments on these kinds of subject. Does
|
|
8269
6708
|
* not touch other corpora.
|
|
8270
6709
|
*/
|
|
8271
|
-
readonly subjectKinds: v.OptionalSchema<v.SchemaWithPipe<readonly [v.ArraySchema<v.PicklistSchema<readonly ["
|
|
6710
|
+
readonly subjectKinds: v.OptionalSchema<v.SchemaWithPipe<readonly [v.ArraySchema<v.PicklistSchema<readonly ["artifact", "session"], undefined>, undefined>, v.MinLengthAction<("artifact" | "session")[], 1, undefined>]>, undefined>;
|
|
8272
6711
|
/**
|
|
8273
6712
|
* Restrict the `turns` corpus to turns the classifier gave one of these
|
|
8274
6713
|
* labels. A turn with no label never matches. Does not touch other corpora.
|
|
@@ -8303,7 +6742,7 @@ export declare const SearchRequestSchema: v.SchemaWithPipe<readonly [v.ObjectSch
|
|
|
8303
6742
|
[x: string]: string;
|
|
8304
6743
|
} | undefined;
|
|
8305
6744
|
authorKinds?: ("agent" | "person" | "mossbear")[] | undefined;
|
|
8306
|
-
subjectKinds?: ("
|
|
6745
|
+
subjectKinds?: ("artifact" | "session")[] | undefined;
|
|
8307
6746
|
steeringLabels?: ("correction" | "steering" | "new request" | "acknowledgement" | "insufficient evidence")[] | undefined;
|
|
8308
6747
|
headSha?: string | undefined;
|
|
8309
6748
|
branch?: string | undefined;
|
|
@@ -8320,7 +6759,7 @@ export declare const SearchRequestSchema: v.SchemaWithPipe<readonly [v.ObjectSch
|
|
|
8320
6759
|
[x: string]: string;
|
|
8321
6760
|
} | undefined;
|
|
8322
6761
|
authorKinds?: ("agent" | "person" | "mossbear")[] | undefined;
|
|
8323
|
-
subjectKinds?: ("
|
|
6762
|
+
subjectKinds?: ("artifact" | "session")[] | undefined;
|
|
8324
6763
|
steeringLabels?: ("correction" | "steering" | "new request" | "acknowledgement" | "insufficient evidence")[] | undefined;
|
|
8325
6764
|
headSha?: string | undefined;
|
|
8326
6765
|
branch?: string | undefined;
|
|
@@ -8337,7 +6776,7 @@ export declare const SearchRequestSchema: v.SchemaWithPipe<readonly [v.ObjectSch
|
|
|
8337
6776
|
[x: string]: string;
|
|
8338
6777
|
} | undefined;
|
|
8339
6778
|
authorKinds?: ("agent" | "person" | "mossbear")[] | undefined;
|
|
8340
|
-
subjectKinds?: ("
|
|
6779
|
+
subjectKinds?: ("artifact" | "session")[] | undefined;
|
|
8341
6780
|
steeringLabels?: ("correction" | "steering" | "new request" | "acknowledgement" | "insufficient evidence")[] | undefined;
|
|
8342
6781
|
headSha?: string | undefined;
|
|
8343
6782
|
branch?: string | undefined;
|
|
@@ -8354,7 +6793,7 @@ export declare const SearchRequestSchema: v.SchemaWithPipe<readonly [v.ObjectSch
|
|
|
8354
6793
|
[x: string]: string;
|
|
8355
6794
|
} | undefined;
|
|
8356
6795
|
authorKinds?: ("agent" | "person" | "mossbear")[] | undefined;
|
|
8357
|
-
subjectKinds?: ("
|
|
6796
|
+
subjectKinds?: ("artifact" | "session")[] | undefined;
|
|
8358
6797
|
steeringLabels?: ("correction" | "steering" | "new request" | "acknowledgement" | "insufficient evidence")[] | undefined;
|
|
8359
6798
|
headSha?: string | undefined;
|
|
8360
6799
|
branch?: string | undefined;
|
|
@@ -8371,7 +6810,7 @@ export declare const SearchRequestSchema: v.SchemaWithPipe<readonly [v.ObjectSch
|
|
|
8371
6810
|
[x: string]: string;
|
|
8372
6811
|
} | undefined;
|
|
8373
6812
|
authorKinds?: ("agent" | "person" | "mossbear")[] | undefined;
|
|
8374
|
-
subjectKinds?: ("
|
|
6813
|
+
subjectKinds?: ("artifact" | "session")[] | undefined;
|
|
8375
6814
|
steeringLabels?: ("correction" | "steering" | "new request" | "acknowledgement" | "insufficient evidence")[] | undefined;
|
|
8376
6815
|
headSha?: string | undefined;
|
|
8377
6816
|
branch?: string | undefined;
|
|
@@ -8388,7 +6827,7 @@ export declare const SearchRequestSchema: v.SchemaWithPipe<readonly [v.ObjectSch
|
|
|
8388
6827
|
[x: string]: string;
|
|
8389
6828
|
} | undefined;
|
|
8390
6829
|
authorKinds?: ("agent" | "person" | "mossbear")[] | undefined;
|
|
8391
|
-
subjectKinds?: ("
|
|
6830
|
+
subjectKinds?: ("artifact" | "session")[] | undefined;
|
|
8392
6831
|
steeringLabels?: ("correction" | "steering" | "new request" | "acknowledgement" | "insufficient evidence")[] | undefined;
|
|
8393
6832
|
headSha?: string | undefined;
|
|
8394
6833
|
branch?: string | undefined;
|
|
@@ -8482,8 +6921,8 @@ export type SearchContentHit = v.InferOutput<typeof SearchContentHitSchema>;
|
|
|
8482
6921
|
* A comment on a guide or document that matched. `body` and `itemName` and
|
|
8483
6922
|
* `workspaceName` are wrapped in `untrusted`'s markers.
|
|
8484
6923
|
*/
|
|
8485
|
-
export declare const
|
|
8486
|
-
readonly subjectKind: v.LiteralSchema<"
|
|
6924
|
+
export declare const SearchArtifactCommentHitSchema: v.ObjectSchema<{
|
|
6925
|
+
readonly subjectKind: v.LiteralSchema<"artifact", undefined>;
|
|
8487
6926
|
readonly itemId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
8488
6927
|
/**
|
|
8489
6928
|
* The guide the item belongs to, or null for a standalone document. A comment
|
|
@@ -8533,44 +6972,6 @@ export declare const SearchSessionCommentHitSchema: v.ObjectSchema<{
|
|
|
8533
6972
|
readonly url: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
|
|
8534
6973
|
readonly excerpt: v.StringSchema<undefined>;
|
|
8535
6974
|
}, undefined>;
|
|
8536
|
-
/**
|
|
8537
|
-
* The same hit under the new name for its subject (one-artifact Stage 3): a
|
|
8538
|
-
* client reads either until every server sends `artifact`.
|
|
8539
|
-
*/
|
|
8540
|
-
export declare const SearchArtifactCommentHitSchema: v.ObjectSchema<{
|
|
8541
|
-
readonly subjectKind: v.LiteralSchema<"artifact", undefined>;
|
|
8542
|
-
readonly itemId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
8543
|
-
/**
|
|
8544
|
-
* The guide the item belongs to, or null for a standalone document. A comment
|
|
8545
|
-
* on a guide sits on its body file, so this is the id the dashboard's guide
|
|
8546
|
-
* page takes; `itemId` is the one a document page takes.
|
|
8547
|
-
*/
|
|
8548
|
-
readonly guideId: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>;
|
|
8549
|
-
/** Wrapped in `untrusted`'s markers; null when the item has no name. */
|
|
8550
|
-
readonly itemName: v.NullableSchema<v.StringSchema<undefined>, undefined>;
|
|
8551
|
-
readonly workspaceId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
8552
|
-
/** Wrapped in `untrusted`'s markers. */
|
|
8553
|
-
readonly workspaceName: v.StringSchema<undefined>;
|
|
8554
|
-
/** Whether the item has been edited since the comment was written. */
|
|
8555
|
-
readonly itemChangedSince: v.BooleanSchema<undefined>;
|
|
8556
|
-
/**
|
|
8557
|
-
* Whether the match is in the comment's text or in the replacement it
|
|
8558
|
-
* suggests (Mossbear's drafted edits).
|
|
8559
|
-
*/
|
|
8560
|
-
readonly matchedIn: v.PicklistSchema<["body", "suggestion"], undefined>;
|
|
8561
|
-
/**
|
|
8562
|
-
* A Mossbear suggestion's draft state: whether its owner has handed it to
|
|
8563
|
-
* their agents. Absent on a person's or an agent's comment and on a reply.
|
|
8564
|
-
*/
|
|
8565
|
-
readonly approved: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
|
|
8566
|
-
readonly commentId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
8567
|
-
readonly threadId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
8568
|
-
readonly authorKind: v.PicklistSchema<readonly ["person", "agent", "mossbear"], undefined>;
|
|
8569
|
-
readonly resolved: v.BooleanSchema<undefined>;
|
|
8570
|
-
readonly createdAt: v.StringSchema<undefined>;
|
|
8571
|
-
readonly url: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
|
|
8572
|
-
readonly excerpt: v.StringSchema<undefined>;
|
|
8573
|
-
}, undefined>;
|
|
8574
6975
|
export declare const SearchCommentHitSchema: v.VariantSchema<"subjectKind", [v.ObjectSchema<{
|
|
8575
6976
|
readonly subjectKind: v.LiteralSchema<"artifact", undefined>;
|
|
8576
6977
|
readonly itemId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
@@ -8604,39 +7005,6 @@ export declare const SearchCommentHitSchema: v.VariantSchema<"subjectKind", [v.O
|
|
|
8604
7005
|
readonly createdAt: v.StringSchema<undefined>;
|
|
8605
7006
|
readonly url: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
|
|
8606
7007
|
readonly excerpt: v.StringSchema<undefined>;
|
|
8607
|
-
}, undefined>, v.ObjectSchema<{
|
|
8608
|
-
readonly subjectKind: v.LiteralSchema<"item", undefined>;
|
|
8609
|
-
readonly itemId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
8610
|
-
/**
|
|
8611
|
-
* The guide the item belongs to, or null for a standalone document. A comment
|
|
8612
|
-
* on a guide sits on its body file, so this is the id the dashboard's guide
|
|
8613
|
-
* page takes; `itemId` is the one a document page takes.
|
|
8614
|
-
*/
|
|
8615
|
-
readonly guideId: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>;
|
|
8616
|
-
/** Wrapped in `untrusted`'s markers; null when the item has no name. */
|
|
8617
|
-
readonly itemName: v.NullableSchema<v.StringSchema<undefined>, undefined>;
|
|
8618
|
-
readonly workspaceId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
8619
|
-
/** Wrapped in `untrusted`'s markers. */
|
|
8620
|
-
readonly workspaceName: v.StringSchema<undefined>;
|
|
8621
|
-
/** Whether the item has been edited since the comment was written. */
|
|
8622
|
-
readonly itemChangedSince: v.BooleanSchema<undefined>;
|
|
8623
|
-
/**
|
|
8624
|
-
* Whether the match is in the comment's text or in the replacement it
|
|
8625
|
-
* suggests (Mossbear's drafted edits).
|
|
8626
|
-
*/
|
|
8627
|
-
readonly matchedIn: v.PicklistSchema<["body", "suggestion"], undefined>;
|
|
8628
|
-
/**
|
|
8629
|
-
* A Mossbear suggestion's draft state: whether its owner has handed it to
|
|
8630
|
-
* their agents. Absent on a person's or an agent's comment and on a reply.
|
|
8631
|
-
*/
|
|
8632
|
-
readonly approved: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
|
|
8633
|
-
readonly commentId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
8634
|
-
readonly threadId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
8635
|
-
readonly authorKind: v.PicklistSchema<readonly ["person", "agent", "mossbear"], undefined>;
|
|
8636
|
-
readonly resolved: v.BooleanSchema<undefined>;
|
|
8637
|
-
readonly createdAt: v.StringSchema<undefined>;
|
|
8638
|
-
readonly url: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
|
|
8639
|
-
readonly excerpt: v.StringSchema<undefined>;
|
|
8640
7008
|
}, undefined>, v.ObjectSchema<{
|
|
8641
7009
|
readonly subjectKind: v.LiteralSchema<"session", undefined>;
|
|
8642
7010
|
readonly sessionId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
@@ -8649,7 +7017,7 @@ export declare const SearchCommentHitSchema: v.VariantSchema<"subjectKind", [v.O
|
|
|
8649
7017
|
readonly url: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
|
|
8650
7018
|
readonly excerpt: v.StringSchema<undefined>;
|
|
8651
7019
|
}, undefined>], undefined>;
|
|
8652
|
-
export type
|
|
7020
|
+
export type SearchArtifactCommentHit = v.InferOutput<typeof SearchArtifactCommentHitSchema>;
|
|
8653
7021
|
export type SearchSessionCommentHit = v.InferOutput<typeof SearchSessionCommentHitSchema>;
|
|
8654
7022
|
export type SearchCommentHit = v.InferOutput<typeof SearchCommentHitSchema>;
|
|
8655
7023
|
/**
|
|
@@ -8796,65 +7164,32 @@ export declare const SearchContentReportSchema: v.VariantSchema<"status", [v.Obj
|
|
|
8796
7164
|
/** Wrapped in `untrusted`'s markers. */
|
|
8797
7165
|
readonly workspaceName: v.StringSchema<undefined>;
|
|
8798
7166
|
/**
|
|
8799
|
-
* Slugs of the bundles that hold the item and that the caller may read — the
|
|
8800
|
-
* argument `pull_bundle` takes to read the whole document. Never more than
|
|
8801
|
-
* a scoped caller's allowlist reaches.
|
|
8802
|
-
*/
|
|
8803
|
-
readonly bundles: v.ArraySchema<v.StringSchema<undefined>, undefined>;
|
|
8804
|
-
readonly updatedAt: v.StringSchema<undefined>;
|
|
8805
|
-
/**
|
|
8806
|
-
* Where the item opens on the dashboard. Added by the CLI, which knows the
|
|
8807
|
-
* dashboard's address; the server does not send it.
|
|
8808
|
-
*/
|
|
8809
|
-
readonly url: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
|
|
8810
|
-
/** A window around the match, wrapped in `untrusted`'s markers. */
|
|
8811
|
-
readonly excerpt: v.StringSchema<undefined>;
|
|
8812
|
-
}, undefined>, undefined>;
|
|
8813
|
-
}, undefined>, v.ObjectSchema<{
|
|
8814
|
-
readonly status: v.LiteralSchema<"skipped", undefined>;
|
|
8815
|
-
readonly reason: v.PicklistSchema<["excluded-by-caller", "timed-out", "not-granted", "not-yet-searchable"], undefined>;
|
|
8816
|
-
}, undefined>], undefined>;
|
|
8817
|
-
export declare const SearchCommentsReportSchema: v.VariantSchema<"status", [v.ObjectSchema<{
|
|
8818
|
-
readonly status: v.LiteralSchema<"searched", undefined>;
|
|
8819
|
-
/** Every match in scope, counted past the returned page. */
|
|
8820
|
-
readonly total: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
|
|
8821
|
-
readonly narrowedBy: v.NullableSchema<v.PicklistSchema<["narrowed-by-bundle-allowlist"], undefined>, undefined>;
|
|
8822
|
-
/** Newest first, at most the request's limit. */
|
|
8823
|
-
readonly hits: v.ArraySchema<v.VariantSchema<"subjectKind", [v.ObjectSchema<{
|
|
8824
|
-
readonly subjectKind: v.LiteralSchema<"artifact", undefined>;
|
|
8825
|
-
readonly itemId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
8826
|
-
/**
|
|
8827
|
-
* The guide the item belongs to, or null for a standalone document. A comment
|
|
8828
|
-
* on a guide sits on its body file, so this is the id the dashboard's guide
|
|
8829
|
-
* page takes; `itemId` is the one a document page takes.
|
|
8830
|
-
*/
|
|
8831
|
-
readonly guideId: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>;
|
|
8832
|
-
/** Wrapped in `untrusted`'s markers; null when the item has no name. */
|
|
8833
|
-
readonly itemName: v.NullableSchema<v.StringSchema<undefined>, undefined>;
|
|
8834
|
-
readonly workspaceId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
8835
|
-
/** Wrapped in `untrusted`'s markers. */
|
|
8836
|
-
readonly workspaceName: v.StringSchema<undefined>;
|
|
8837
|
-
/** Whether the item has been edited since the comment was written. */
|
|
8838
|
-
readonly itemChangedSince: v.BooleanSchema<undefined>;
|
|
8839
|
-
/**
|
|
8840
|
-
* Whether the match is in the comment's text or in the replacement it
|
|
8841
|
-
* suggests (Mossbear's drafted edits).
|
|
7167
|
+
* Slugs of the bundles that hold the item and that the caller may read — the
|
|
7168
|
+
* argument `pull_bundle` takes to read the whole document. Never more than
|
|
7169
|
+
* a scoped caller's allowlist reaches.
|
|
8842
7170
|
*/
|
|
8843
|
-
readonly
|
|
7171
|
+
readonly bundles: v.ArraySchema<v.StringSchema<undefined>, undefined>;
|
|
7172
|
+
readonly updatedAt: v.StringSchema<undefined>;
|
|
8844
7173
|
/**
|
|
8845
|
-
*
|
|
8846
|
-
*
|
|
7174
|
+
* Where the item opens on the dashboard. Added by the CLI, which knows the
|
|
7175
|
+
* dashboard's address; the server does not send it.
|
|
8847
7176
|
*/
|
|
8848
|
-
readonly approved: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
|
|
8849
|
-
readonly commentId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
8850
|
-
readonly threadId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
8851
|
-
readonly authorKind: v.PicklistSchema<readonly ["person", "agent", "mossbear"], undefined>;
|
|
8852
|
-
readonly resolved: v.BooleanSchema<undefined>;
|
|
8853
|
-
readonly createdAt: v.StringSchema<undefined>;
|
|
8854
7177
|
readonly url: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
|
|
7178
|
+
/** A window around the match, wrapped in `untrusted`'s markers. */
|
|
8855
7179
|
readonly excerpt: v.StringSchema<undefined>;
|
|
8856
|
-
}, undefined>,
|
|
8857
|
-
|
|
7180
|
+
}, undefined>, undefined>;
|
|
7181
|
+
}, undefined>, v.ObjectSchema<{
|
|
7182
|
+
readonly status: v.LiteralSchema<"skipped", undefined>;
|
|
7183
|
+
readonly reason: v.PicklistSchema<["excluded-by-caller", "timed-out", "not-granted", "not-yet-searchable"], undefined>;
|
|
7184
|
+
}, undefined>], undefined>;
|
|
7185
|
+
export declare const SearchCommentsReportSchema: v.VariantSchema<"status", [v.ObjectSchema<{
|
|
7186
|
+
readonly status: v.LiteralSchema<"searched", undefined>;
|
|
7187
|
+
/** Every match in scope, counted past the returned page. */
|
|
7188
|
+
readonly total: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
|
|
7189
|
+
readonly narrowedBy: v.NullableSchema<v.PicklistSchema<["narrowed-by-bundle-allowlist"], undefined>, undefined>;
|
|
7190
|
+
/** Newest first, at most the request's limit. */
|
|
7191
|
+
readonly hits: v.ArraySchema<v.VariantSchema<"subjectKind", [v.ObjectSchema<{
|
|
7192
|
+
readonly subjectKind: v.LiteralSchema<"artifact", undefined>;
|
|
8858
7193
|
readonly itemId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
8859
7194
|
/**
|
|
8860
7195
|
* The guide the item belongs to, or null for a standalone document. A comment
|
|
@@ -9128,39 +7463,6 @@ export declare const SearchResponseSchema: v.ObjectSchema<{
|
|
|
9128
7463
|
readonly createdAt: v.StringSchema<undefined>;
|
|
9129
7464
|
readonly url: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
|
|
9130
7465
|
readonly excerpt: v.StringSchema<undefined>;
|
|
9131
|
-
}, undefined>, v.ObjectSchema<{
|
|
9132
|
-
readonly subjectKind: v.LiteralSchema<"item", undefined>;
|
|
9133
|
-
readonly itemId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
9134
|
-
/**
|
|
9135
|
-
* The guide the item belongs to, or null for a standalone document. A comment
|
|
9136
|
-
* on a guide sits on its body file, so this is the id the dashboard's guide
|
|
9137
|
-
* page takes; `itemId` is the one a document page takes.
|
|
9138
|
-
*/
|
|
9139
|
-
readonly guideId: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>;
|
|
9140
|
-
/** Wrapped in `untrusted`'s markers; null when the item has no name. */
|
|
9141
|
-
readonly itemName: v.NullableSchema<v.StringSchema<undefined>, undefined>;
|
|
9142
|
-
readonly workspaceId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
9143
|
-
/** Wrapped in `untrusted`'s markers. */
|
|
9144
|
-
readonly workspaceName: v.StringSchema<undefined>;
|
|
9145
|
-
/** Whether the item has been edited since the comment was written. */
|
|
9146
|
-
readonly itemChangedSince: v.BooleanSchema<undefined>;
|
|
9147
|
-
/**
|
|
9148
|
-
* Whether the match is in the comment's text or in the replacement it
|
|
9149
|
-
* suggests (Mossbear's drafted edits).
|
|
9150
|
-
*/
|
|
9151
|
-
readonly matchedIn: v.PicklistSchema<["body", "suggestion"], undefined>;
|
|
9152
|
-
/**
|
|
9153
|
-
* A Mossbear suggestion's draft state: whether its owner has handed it to
|
|
9154
|
-
* their agents. Absent on a person's or an agent's comment and on a reply.
|
|
9155
|
-
*/
|
|
9156
|
-
readonly approved: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
|
|
9157
|
-
readonly commentId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
9158
|
-
readonly threadId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
9159
|
-
readonly authorKind: v.PicklistSchema<readonly ["person", "agent", "mossbear"], undefined>;
|
|
9160
|
-
readonly resolved: v.BooleanSchema<undefined>;
|
|
9161
|
-
readonly createdAt: v.StringSchema<undefined>;
|
|
9162
|
-
readonly url: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
|
|
9163
|
-
readonly excerpt: v.StringSchema<undefined>;
|
|
9164
7466
|
}, undefined>, v.ObjectSchema<{
|
|
9165
7467
|
readonly subjectKind: v.LiteralSchema<"session", undefined>;
|
|
9166
7468
|
readonly sessionId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
@@ -9351,371 +7653,93 @@ export declare function parseWorkspaceListResponse(data: unknown): {
|
|
|
9351
7653
|
workspaces: {
|
|
9352
7654
|
id: string;
|
|
9353
7655
|
name: string;
|
|
9354
|
-
slug: string;
|
|
9355
|
-
role: string;
|
|
9356
|
-
isDefault: boolean;
|
|
9357
|
-
}[];
|
|
9358
|
-
};
|
|
9359
|
-
export declare function parseCreateScopedTokenRequest(data: unknown): {
|
|
9360
|
-
label: string;
|
|
9361
|
-
grants: {
|
|
9362
|
-
bundleId: string;
|
|
9363
|
-
access: "read" | "write";
|
|
9364
|
-
}[];
|
|
9365
|
-
};
|
|
9366
|
-
export declare function parseRevokeScopedTokenRequest(data: unknown): {
|
|
9367
|
-
id: string;
|
|
9368
|
-
};
|
|
9369
|
-
export declare function parseCreateBundleRequest(data: unknown): {
|
|
9370
|
-
slug: string;
|
|
9371
|
-
name: string;
|
|
9372
|
-
};
|
|
9373
|
-
export declare function parseCreateBundleResponse(data: unknown): {
|
|
9374
|
-
bundle: {
|
|
9375
|
-
id: string;
|
|
9376
|
-
slug: string;
|
|
9377
|
-
name: string;
|
|
9378
|
-
createdAt: string;
|
|
9379
|
-
home?: string | undefined;
|
|
9380
|
-
};
|
|
9381
|
-
};
|
|
9382
|
-
export declare function parseAttachBundleMemberRequest(data: unknown): {
|
|
9383
|
-
itemId: string;
|
|
9384
|
-
};
|
|
9385
|
-
export declare function parseAttachBundleMemberResponse(data: unknown): {
|
|
9386
|
-
attached: boolean;
|
|
9387
|
-
};
|
|
9388
|
-
export declare function parseDetachBundleMemberResponse(data: unknown): {
|
|
9389
|
-
detached: boolean;
|
|
9390
|
-
};
|
|
9391
|
-
export declare function parseSubscribeBundleRequest(data: unknown): {
|
|
9392
|
-
bundleId: string;
|
|
9393
|
-
deliver?: "global" | "repo" | null | undefined;
|
|
9394
|
-
muted?: string[] | undefined;
|
|
9395
|
-
};
|
|
9396
|
-
export declare function parseSubscribeBundleResponse(data: unknown): {
|
|
9397
|
-
bundleId: string;
|
|
9398
|
-
created: boolean;
|
|
9399
|
-
deliver?: "global" | "repo" | undefined;
|
|
9400
|
-
muted?: string[] | undefined;
|
|
9401
|
-
};
|
|
9402
|
-
export declare function parseResolveSubscriptionsRequest(data: unknown): {
|
|
9403
|
-
repoBundleIds: string[];
|
|
9404
|
-
};
|
|
9405
|
-
export declare function parseResolveSubscriptionsResponse(data: unknown): {
|
|
9406
|
-
bundles: {
|
|
9407
|
-
id: string;
|
|
9408
|
-
slug: string;
|
|
9409
|
-
name: string;
|
|
9410
|
-
scopes: ("repo" | "user")[];
|
|
9411
|
-
deliver?: "global" | "repo" | undefined;
|
|
9412
|
-
home?: string | undefined;
|
|
9413
|
-
muted?: string[] | undefined;
|
|
9414
|
-
}[];
|
|
9415
|
-
unresolved: {
|
|
9416
|
-
id: string;
|
|
9417
|
-
}[];
|
|
9418
|
-
account?: {
|
|
9419
|
-
deliverGlobalSkills: boolean;
|
|
9420
|
-
} | undefined;
|
|
9421
|
-
limitedToken?: boolean | undefined;
|
|
9422
|
-
};
|
|
9423
|
-
export declare function parseUpdateBundleRequest(data: unknown): {
|
|
9424
|
-
name?: string | undefined;
|
|
9425
|
-
home?: string | null | undefined;
|
|
9426
|
-
};
|
|
9427
|
-
export declare function parseUpdateBundleResponse(data: unknown): {
|
|
9428
|
-
bundle: {
|
|
9429
|
-
id: string;
|
|
9430
|
-
slug: string;
|
|
9431
|
-
name: string;
|
|
9432
|
-
createdAt: string;
|
|
9433
|
-
home?: string | undefined;
|
|
9434
|
-
};
|
|
9435
|
-
};
|
|
9436
|
-
export declare function parseDeleteBundleResponse(data: unknown): {
|
|
9437
|
-
deleted: boolean;
|
|
9438
|
-
};
|
|
9439
|
-
export declare function parseContextItem(data: unknown): {
|
|
9440
|
-
type: string;
|
|
9441
|
-
id: string;
|
|
9442
|
-
artifactId?: string | null | undefined;
|
|
9443
|
-
name: string;
|
|
9444
|
-
role: string | null;
|
|
9445
|
-
format: string | null;
|
|
9446
|
-
content: string | null;
|
|
9447
|
-
origin?: string | null | undefined;
|
|
9448
|
-
version?: number | undefined;
|
|
9449
|
-
guideId?: string | null | undefined;
|
|
9450
|
-
root?: "project" | "global" | null | undefined;
|
|
9451
|
-
path?: string | null | undefined;
|
|
9452
|
-
projectId?: string | null | undefined;
|
|
9453
|
-
pathProjectId?: string | null | undefined;
|
|
9454
|
-
aliases?: {
|
|
9455
|
-
root: "project" | "global";
|
|
9456
|
-
path: string;
|
|
9457
|
-
}[] | undefined;
|
|
9458
|
-
comments?: {
|
|
9459
|
-
id: string;
|
|
9460
|
-
state?: "open" | "resolved" | undefined;
|
|
9461
|
-
passage?: {
|
|
9462
|
-
quote: string;
|
|
9463
|
-
status: "located" | "changed" | "orphaned";
|
|
9464
|
-
lines: {
|
|
9465
|
-
start: number;
|
|
9466
|
-
end: number;
|
|
9467
|
-
} | null;
|
|
9468
|
-
} | undefined;
|
|
9469
|
-
body: string;
|
|
9470
|
-
suggestion?: string | undefined;
|
|
9471
|
-
finding?: {
|
|
9472
|
-
tier: "observed" | "usage" | "practice";
|
|
9473
|
-
tierLine: string;
|
|
9474
|
-
blindSpot: string;
|
|
9475
|
-
prediction: string | null;
|
|
9476
|
-
} | undefined;
|
|
9477
|
-
approved?: boolean | undefined;
|
|
9478
|
-
authorName: string | null;
|
|
9479
|
-
createdAt: string;
|
|
9480
|
-
itemVersion: number;
|
|
9481
|
-
itemChangedSince: boolean;
|
|
9482
|
-
deliveredCount: number;
|
|
9483
|
-
threadId: string;
|
|
9484
|
-
replyToId: string | null;
|
|
9485
|
-
}[] | undefined;
|
|
9486
|
-
updatedAt: string;
|
|
9487
|
-
gitSource?: {
|
|
9488
|
-
projectId: string;
|
|
9489
|
-
commitSha: string;
|
|
9490
|
-
branch?: string | undefined;
|
|
9491
|
-
} | null | undefined;
|
|
9492
|
-
removed?: true | undefined;
|
|
9493
|
-
};
|
|
9494
|
-
export declare function parseContextItemsResponse(data: unknown): {
|
|
9495
|
-
items: {
|
|
9496
|
-
type: string;
|
|
9497
|
-
id: string;
|
|
9498
|
-
artifactId?: string | null | undefined;
|
|
9499
|
-
name: string;
|
|
9500
|
-
role: string | null;
|
|
9501
|
-
format: string | null;
|
|
9502
|
-
content: string | null;
|
|
9503
|
-
origin?: string | null | undefined;
|
|
9504
|
-
version?: number | undefined;
|
|
9505
|
-
guideId?: string | null | undefined;
|
|
9506
|
-
root?: "project" | "global" | null | undefined;
|
|
9507
|
-
path?: string | null | undefined;
|
|
9508
|
-
projectId?: string | null | undefined;
|
|
9509
|
-
pathProjectId?: string | null | undefined;
|
|
9510
|
-
aliases?: {
|
|
9511
|
-
root: "project" | "global";
|
|
9512
|
-
path: string;
|
|
9513
|
-
}[] | undefined;
|
|
9514
|
-
comments?: {
|
|
9515
|
-
id: string;
|
|
9516
|
-
state?: "open" | "resolved" | undefined;
|
|
9517
|
-
passage?: {
|
|
9518
|
-
quote: string;
|
|
9519
|
-
status: "located" | "changed" | "orphaned";
|
|
9520
|
-
lines: {
|
|
9521
|
-
start: number;
|
|
9522
|
-
end: number;
|
|
9523
|
-
} | null;
|
|
9524
|
-
} | undefined;
|
|
9525
|
-
body: string;
|
|
9526
|
-
suggestion?: string | undefined;
|
|
9527
|
-
finding?: {
|
|
9528
|
-
tier: "observed" | "usage" | "practice";
|
|
9529
|
-
tierLine: string;
|
|
9530
|
-
blindSpot: string;
|
|
9531
|
-
prediction: string | null;
|
|
9532
|
-
} | undefined;
|
|
9533
|
-
approved?: boolean | undefined;
|
|
9534
|
-
authorName: string | null;
|
|
9535
|
-
createdAt: string;
|
|
9536
|
-
itemVersion: number;
|
|
9537
|
-
itemChangedSince: boolean;
|
|
9538
|
-
deliveredCount: number;
|
|
9539
|
-
threadId: string;
|
|
9540
|
-
replyToId: string | null;
|
|
9541
|
-
}[] | undefined;
|
|
9542
|
-
updatedAt: string;
|
|
9543
|
-
gitSource?: {
|
|
9544
|
-
projectId: string;
|
|
9545
|
-
commitSha: string;
|
|
9546
|
-
branch?: string | undefined;
|
|
9547
|
-
} | null | undefined;
|
|
9548
|
-
removed?: true | undefined;
|
|
7656
|
+
slug: string;
|
|
7657
|
+
role: string;
|
|
7658
|
+
isDefault: boolean;
|
|
7659
|
+
}[];
|
|
7660
|
+
};
|
|
7661
|
+
export declare function parseCreateScopedTokenRequest(data: unknown): {
|
|
7662
|
+
label: string;
|
|
7663
|
+
grants: {
|
|
7664
|
+
bundleId: string;
|
|
7665
|
+
access: "read" | "write";
|
|
9549
7666
|
}[];
|
|
9550
|
-
untrusted?: {
|
|
9551
|
-
token: string;
|
|
9552
|
-
startMarker: string;
|
|
9553
|
-
endMarker: string;
|
|
9554
|
-
note: string;
|
|
9555
|
-
} | null | undefined;
|
|
9556
7667
|
};
|
|
9557
|
-
export declare function
|
|
7668
|
+
export declare function parseRevokeScopedTokenRequest(data: unknown): {
|
|
7669
|
+
id: string;
|
|
7670
|
+
};
|
|
7671
|
+
export declare function parseCreateBundleRequest(data: unknown): {
|
|
7672
|
+
slug: string;
|
|
9558
7673
|
name: string;
|
|
9559
|
-
contentType: "content" | "asset";
|
|
9560
|
-
content: string;
|
|
9561
|
-
itemId?: string | undefined;
|
|
9562
|
-
origin?: string | null | undefined;
|
|
9563
|
-
sourceItemIds?: string[] | undefined;
|
|
9564
|
-
path?: string | null | undefined;
|
|
9565
|
-
projectId?: string | undefined;
|
|
9566
|
-
gitSource?: {
|
|
9567
|
-
projectId: string;
|
|
9568
|
-
commitSha: string;
|
|
9569
|
-
branch?: string | undefined;
|
|
9570
|
-
} | undefined;
|
|
9571
7674
|
};
|
|
9572
|
-
export declare function
|
|
9573
|
-
|
|
9574
|
-
type: string;
|
|
7675
|
+
export declare function parseCreateBundleResponse(data: unknown): {
|
|
7676
|
+
bundle: {
|
|
9575
7677
|
id: string;
|
|
9576
|
-
|
|
7678
|
+
slug: string;
|
|
9577
7679
|
name: string;
|
|
9578
|
-
|
|
9579
|
-
|
|
9580
|
-
content: string | null;
|
|
9581
|
-
origin?: string | null | undefined;
|
|
9582
|
-
version?: number | undefined;
|
|
9583
|
-
guideId?: string | null | undefined;
|
|
9584
|
-
root?: "project" | "global" | null | undefined;
|
|
9585
|
-
path?: string | null | undefined;
|
|
9586
|
-
projectId?: string | null | undefined;
|
|
9587
|
-
pathProjectId?: string | null | undefined;
|
|
9588
|
-
aliases?: {
|
|
9589
|
-
root: "project" | "global";
|
|
9590
|
-
path: string;
|
|
9591
|
-
}[] | undefined;
|
|
9592
|
-
comments?: {
|
|
9593
|
-
id: string;
|
|
9594
|
-
state?: "open" | "resolved" | undefined;
|
|
9595
|
-
passage?: {
|
|
9596
|
-
quote: string;
|
|
9597
|
-
status: "located" | "changed" | "orphaned";
|
|
9598
|
-
lines: {
|
|
9599
|
-
start: number;
|
|
9600
|
-
end: number;
|
|
9601
|
-
} | null;
|
|
9602
|
-
} | undefined;
|
|
9603
|
-
body: string;
|
|
9604
|
-
suggestion?: string | undefined;
|
|
9605
|
-
finding?: {
|
|
9606
|
-
tier: "observed" | "usage" | "practice";
|
|
9607
|
-
tierLine: string;
|
|
9608
|
-
blindSpot: string;
|
|
9609
|
-
prediction: string | null;
|
|
9610
|
-
} | undefined;
|
|
9611
|
-
approved?: boolean | undefined;
|
|
9612
|
-
authorName: string | null;
|
|
9613
|
-
createdAt: string;
|
|
9614
|
-
itemVersion: number;
|
|
9615
|
-
itemChangedSince: boolean;
|
|
9616
|
-
deliveredCount: number;
|
|
9617
|
-
threadId: string;
|
|
9618
|
-
replyToId: string | null;
|
|
9619
|
-
}[] | undefined;
|
|
9620
|
-
updatedAt: string;
|
|
9621
|
-
gitSource?: {
|
|
9622
|
-
projectId: string;
|
|
9623
|
-
commitSha: string;
|
|
9624
|
-
branch?: string | undefined;
|
|
9625
|
-
} | null | undefined;
|
|
9626
|
-
removed?: true | undefined;
|
|
7680
|
+
createdAt: string;
|
|
7681
|
+
home?: string | undefined;
|
|
9627
7682
|
};
|
|
7683
|
+
};
|
|
7684
|
+
export declare function parseAttachBundleMemberRequest(data: unknown): {
|
|
7685
|
+
artifactId: string;
|
|
7686
|
+
};
|
|
7687
|
+
export declare function parseAttachBundleMemberResponse(data: unknown): {
|
|
7688
|
+
attached: boolean;
|
|
7689
|
+
};
|
|
7690
|
+
export declare function parseDetachBundleMemberResponse(data: unknown): {
|
|
7691
|
+
detached: boolean;
|
|
7692
|
+
};
|
|
7693
|
+
export declare function parseSubscribeBundleRequest(data: unknown): {
|
|
7694
|
+
bundleId: string;
|
|
7695
|
+
deliver?: "global" | "repo" | null | undefined;
|
|
7696
|
+
muted?: string[] | undefined;
|
|
7697
|
+
};
|
|
7698
|
+
export declare function parseSubscribeBundleResponse(data: unknown): {
|
|
7699
|
+
bundleId: string;
|
|
9628
7700
|
created: boolean;
|
|
7701
|
+
deliver?: "global" | "repo" | undefined;
|
|
7702
|
+
muted?: string[] | undefined;
|
|
9629
7703
|
};
|
|
9630
|
-
export declare function
|
|
9631
|
-
|
|
9632
|
-
|
|
9633
|
-
|
|
9634
|
-
|
|
9635
|
-
|
|
9636
|
-
|
|
9637
|
-
|
|
9638
|
-
|
|
9639
|
-
|
|
9640
|
-
|
|
9641
|
-
|
|
7704
|
+
export declare function parseResolveSubscriptionsRequest(data: unknown): {
|
|
7705
|
+
repoBundleIds: string[];
|
|
7706
|
+
};
|
|
7707
|
+
export declare function parseResolveSubscriptionsResponse(data: unknown): {
|
|
7708
|
+
bundles: {
|
|
7709
|
+
id: string;
|
|
7710
|
+
slug: string;
|
|
7711
|
+
name: string;
|
|
7712
|
+
scopes: ("repo" | "user")[];
|
|
7713
|
+
deliver?: "global" | "repo" | undefined;
|
|
7714
|
+
home?: string | undefined;
|
|
7715
|
+
muted?: string[] | undefined;
|
|
7716
|
+
}[];
|
|
7717
|
+
unresolved: {
|
|
7718
|
+
id: string;
|
|
7719
|
+
}[];
|
|
7720
|
+
account?: {
|
|
7721
|
+
deliverGlobalSkills: boolean;
|
|
9642
7722
|
} | undefined;
|
|
9643
|
-
|
|
7723
|
+
limitedToken?: boolean | undefined;
|
|
9644
7724
|
};
|
|
9645
|
-
export declare function
|
|
9646
|
-
|
|
9647
|
-
|
|
7725
|
+
export declare function parseUpdateBundleRequest(data: unknown): {
|
|
7726
|
+
name?: string | undefined;
|
|
7727
|
+
home?: string | null | undefined;
|
|
7728
|
+
};
|
|
7729
|
+
export declare function parseUpdateBundleResponse(data: unknown): {
|
|
7730
|
+
bundle: {
|
|
9648
7731
|
id: string;
|
|
9649
|
-
|
|
7732
|
+
slug: string;
|
|
9650
7733
|
name: string;
|
|
9651
|
-
|
|
9652
|
-
|
|
9653
|
-
content: string | null;
|
|
9654
|
-
origin?: string | null | undefined;
|
|
9655
|
-
version?: number | undefined;
|
|
9656
|
-
guideId?: string | null | undefined;
|
|
9657
|
-
root?: "project" | "global" | null | undefined;
|
|
9658
|
-
path?: string | null | undefined;
|
|
9659
|
-
projectId?: string | null | undefined;
|
|
9660
|
-
pathProjectId?: string | null | undefined;
|
|
9661
|
-
aliases?: {
|
|
9662
|
-
root: "project" | "global";
|
|
9663
|
-
path: string;
|
|
9664
|
-
}[] | undefined;
|
|
9665
|
-
comments?: {
|
|
9666
|
-
id: string;
|
|
9667
|
-
state?: "open" | "resolved" | undefined;
|
|
9668
|
-
passage?: {
|
|
9669
|
-
quote: string;
|
|
9670
|
-
status: "located" | "changed" | "orphaned";
|
|
9671
|
-
lines: {
|
|
9672
|
-
start: number;
|
|
9673
|
-
end: number;
|
|
9674
|
-
} | null;
|
|
9675
|
-
} | undefined;
|
|
9676
|
-
body: string;
|
|
9677
|
-
suggestion?: string | undefined;
|
|
9678
|
-
finding?: {
|
|
9679
|
-
tier: "observed" | "usage" | "practice";
|
|
9680
|
-
tierLine: string;
|
|
9681
|
-
blindSpot: string;
|
|
9682
|
-
prediction: string | null;
|
|
9683
|
-
} | undefined;
|
|
9684
|
-
approved?: boolean | undefined;
|
|
9685
|
-
authorName: string | null;
|
|
9686
|
-
createdAt: string;
|
|
9687
|
-
itemVersion: number;
|
|
9688
|
-
itemChangedSince: boolean;
|
|
9689
|
-
deliveredCount: number;
|
|
9690
|
-
threadId: string;
|
|
9691
|
-
replyToId: string | null;
|
|
9692
|
-
}[] | undefined;
|
|
9693
|
-
updatedAt: string;
|
|
9694
|
-
gitSource?: {
|
|
9695
|
-
projectId: string;
|
|
9696
|
-
commitSha: string;
|
|
9697
|
-
branch?: string | undefined;
|
|
9698
|
-
} | null | undefined;
|
|
9699
|
-
removed?: true | undefined;
|
|
7734
|
+
createdAt: string;
|
|
7735
|
+
home?: string | undefined;
|
|
9700
7736
|
};
|
|
9701
|
-
updated: boolean;
|
|
9702
7737
|
};
|
|
9703
|
-
export declare function
|
|
9704
|
-
|
|
9705
|
-
path?: string | null | undefined;
|
|
9706
|
-
expectedVersion?: number | undefined;
|
|
9707
|
-
projectId?: string | undefined;
|
|
9708
|
-
name?: string | undefined;
|
|
9709
|
-
gitSource?: {
|
|
9710
|
-
projectId: string;
|
|
9711
|
-
commitSha: string;
|
|
9712
|
-
branch?: string | undefined;
|
|
9713
|
-
} | undefined;
|
|
9714
|
-
removed?: true | undefined;
|
|
9715
|
-
sourceItemIds?: string[] | undefined;
|
|
7738
|
+
export declare function parseDeleteBundleResponse(data: unknown): {
|
|
7739
|
+
deleted: boolean;
|
|
9716
7740
|
};
|
|
9717
|
-
export declare function
|
|
9718
|
-
|
|
7741
|
+
export declare function parseContextItemsResponse(data: unknown): {
|
|
7742
|
+
items: {
|
|
9719
7743
|
type: string;
|
|
9720
7744
|
id: string;
|
|
9721
7745
|
artifactId?: string | null | undefined;
|
|
@@ -9769,11 +7793,16 @@ export declare function parseContextItemResponse(data: unknown): {
|
|
|
9769
7793
|
branch?: string | undefined;
|
|
9770
7794
|
} | null | undefined;
|
|
9771
7795
|
removed?: true | undefined;
|
|
9772
|
-
};
|
|
7796
|
+
}[];
|
|
7797
|
+
untrusted?: {
|
|
7798
|
+
token: string;
|
|
7799
|
+
startMarker: string;
|
|
7800
|
+
endMarker: string;
|
|
7801
|
+
note: string;
|
|
7802
|
+
} | null | undefined;
|
|
9773
7803
|
};
|
|
9774
|
-
export declare function
|
|
9775
|
-
|
|
9776
|
-
item: {
|
|
7804
|
+
export declare function parseBundleArtifactsResponse(data: unknown): {
|
|
7805
|
+
artifacts: {
|
|
9777
7806
|
type: string;
|
|
9778
7807
|
id: string;
|
|
9779
7808
|
artifactId?: string | null | undefined;
|
|
@@ -9827,7 +7856,13 @@ export declare function parseArchiveContextItemResponse(data: unknown): {
|
|
|
9827
7856
|
branch?: string | undefined;
|
|
9828
7857
|
} | null | undefined;
|
|
9829
7858
|
removed?: true | undefined;
|
|
9830
|
-
};
|
|
7859
|
+
}[];
|
|
7860
|
+
untrusted?: {
|
|
7861
|
+
token: string;
|
|
7862
|
+
startMarker: string;
|
|
7863
|
+
endMarker: string;
|
|
7864
|
+
note: string;
|
|
7865
|
+
} | null | undefined;
|
|
9831
7866
|
};
|
|
9832
7867
|
export declare function parseInboxCaptureRequest(data: unknown): {
|
|
9833
7868
|
id?: string | undefined;
|
|
@@ -9865,7 +7900,7 @@ export declare function parseInboxListResponse(data: unknown): {
|
|
|
9865
7900
|
updatedAt: string;
|
|
9866
7901
|
}[];
|
|
9867
7902
|
};
|
|
9868
|
-
export declare function
|
|
7903
|
+
export declare function parseBundleArtifactVersionsResponse(data: unknown): {
|
|
9869
7904
|
versions: {
|
|
9870
7905
|
id: string;
|
|
9871
7906
|
version: number;
|
|
@@ -9878,19 +7913,6 @@ export declare function parseContextItemVersionsResponse(data: unknown): {
|
|
|
9878
7913
|
}[];
|
|
9879
7914
|
nextCursor: number | null;
|
|
9880
7915
|
};
|
|
9881
|
-
export declare function parseContextItemVersionResponse(data: unknown): {
|
|
9882
|
-
version: {
|
|
9883
|
-
id: string;
|
|
9884
|
-
version: number;
|
|
9885
|
-
content: string | null;
|
|
9886
|
-
contentHash: string;
|
|
9887
|
-
authorType: string;
|
|
9888
|
-
metadata?: {
|
|
9889
|
-
[x: string]: unknown;
|
|
9890
|
-
} | null | undefined;
|
|
9891
|
-
createdAt: string;
|
|
9892
|
-
};
|
|
9893
|
-
};
|
|
9894
7916
|
export declare function parseInboxArchiveRequest(data: unknown): {
|
|
9895
7917
|
ids: string[];
|
|
9896
7918
|
};
|
|
@@ -10149,7 +8171,7 @@ export declare function parseAgentCommentResponse(data: unknown): {
|
|
|
10149
8171
|
id: string;
|
|
10150
8172
|
threadId: string;
|
|
10151
8173
|
subject: {
|
|
10152
|
-
kind: "
|
|
8174
|
+
kind: "artifact" | "session";
|
|
10153
8175
|
id: string;
|
|
10154
8176
|
};
|
|
10155
8177
|
body: string;
|
|
@@ -10386,23 +8408,6 @@ export declare function parseSearchResponse(data: unknown): {
|
|
|
10386
8408
|
total: number;
|
|
10387
8409
|
narrowedBy: "narrowed-by-bundle-allowlist" | null;
|
|
10388
8410
|
hits: ({
|
|
10389
|
-
subjectKind: "item";
|
|
10390
|
-
itemId: string;
|
|
10391
|
-
guideId: string | null;
|
|
10392
|
-
itemName: string | null;
|
|
10393
|
-
workspaceId: string;
|
|
10394
|
-
workspaceName: string;
|
|
10395
|
-
itemChangedSince: boolean;
|
|
10396
|
-
matchedIn: "suggestion" | "body";
|
|
10397
|
-
approved?: boolean | undefined;
|
|
10398
|
-
commentId: string;
|
|
10399
|
-
threadId: string;
|
|
10400
|
-
authorKind: "agent" | "person" | "mossbear";
|
|
10401
|
-
resolved: boolean;
|
|
10402
|
-
createdAt: string;
|
|
10403
|
-
url?: string | undefined;
|
|
10404
|
-
excerpt: string;
|
|
10405
|
-
} | {
|
|
10406
8411
|
subjectKind: "artifact";
|
|
10407
8412
|
itemId: string;
|
|
10408
8413
|
guideId: string | null;
|