@mossbear/protocol 0.1.0-alpha.88 → 0.1.0-alpha.89
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/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 +749 -2751
- package/dist/schemas.d.ts.map +1 -1
- package/dist/schemas.js +38 -336
- package/dist/schemas.js.map +1 -1
- package/dist/schemas.test.js +35 -142
- package/dist/schemas.test.js.map +1 -1
- package/dist/types.d.ts +5 -10
- package/dist/types.d.ts.map +1 -1
- package/dist/types.js.map +1 -1
- package/package.json +1 -1
package/dist/schemas.d.ts
CHANGED
|
@@ -924,9 +924,23 @@ export declare const ListScopedTokensResponseSchema: v.ObjectSchema<{
|
|
|
924
924
|
export declare const RevokeScopedTokenRequestSchema: v.ObjectSchema<{
|
|
925
925
|
readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
926
926
|
}, undefined>;
|
|
927
|
-
|
|
928
|
-
|
|
929
|
-
|
|
927
|
+
/**
|
|
928
|
+
* The member to attach, by its artifact id. `itemId` is the name a CLI from before
|
|
929
|
+
* release step 2 sends; both are read, and the parsed value is always `artifactId`.
|
|
930
|
+
* Drop `itemId` once no such CLI is left to send it.
|
|
931
|
+
*/
|
|
932
|
+
export declare const AttachBundleMemberRequestSchema: v.SchemaWithPipe<readonly [v.ObjectSchema<{
|
|
933
|
+
readonly artifactId: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>;
|
|
934
|
+
readonly itemId: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>;
|
|
935
|
+
}, undefined>, v.CheckAction<{
|
|
936
|
+
artifactId?: string | undefined;
|
|
937
|
+
itemId?: string | undefined;
|
|
938
|
+
}, "A member needs an artifactId.">, v.TransformAction<{
|
|
939
|
+
artifactId?: string | undefined;
|
|
940
|
+
itemId?: string | undefined;
|
|
941
|
+
}, {
|
|
942
|
+
artifactId: string;
|
|
943
|
+
}>]>;
|
|
930
944
|
export declare const AttachBundleMemberResponseSchema: v.ObjectSchema<{
|
|
931
945
|
readonly attached: v.BooleanSchema<undefined>;
|
|
932
946
|
}, undefined>;
|
|
@@ -984,7 +998,6 @@ export declare const ContextItemTypeSchema: v.PicklistSchema<string[], undefined
|
|
|
984
998
|
* the release that moved the CLI's own vocabulary onto `content`.
|
|
985
999
|
*/
|
|
986
1000
|
export declare const ContextItemTypeFilterSchema: v.PicklistSchema<string[], undefined>;
|
|
987
|
-
export declare const PushContentTypeSchema: v.PicklistSchema<("content" | "asset")[], undefined>;
|
|
988
1001
|
export declare const InboxContentTypeSchema: v.PicklistSchema<("content" | "asset")[], undefined>;
|
|
989
1002
|
export { MAX_CONTEXT_CONTENT_BYTES };
|
|
990
1003
|
/**
|
|
@@ -2054,727 +2067,96 @@ export declare const ContextItemsResponseSchema: v.ObjectSchema<{
|
|
|
2054
2067
|
}, undefined>, undefined>, undefined>;
|
|
2055
2068
|
}, undefined>;
|
|
2056
2069
|
/**
|
|
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.
|
|
2070
|
+
* The bundle pull under its artifact name: the same members and comments as
|
|
2071
|
+
* {@link ContextItemsResponseSchema}, under `artifacts`.
|
|
2201
2072
|
*/
|
|
2202
|
-
export declare const
|
|
2203
|
-
readonly
|
|
2204
|
-
readonly comment: v.ObjectSchema<{
|
|
2073
|
+
export declare const BundleArtifactsResponseSchema: v.ObjectSchema<{
|
|
2074
|
+
readonly artifacts: v.ArraySchema<v.SchemaWithPipe<readonly [v.ObjectSchema<{
|
|
2205
2075
|
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
2076
|
/**
|
|
2346
|
-
*
|
|
2347
|
-
*
|
|
2348
|
-
*
|
|
2349
|
-
*
|
|
2077
|
+
* The id every artifact route addresses: the body file's id for a guide
|
|
2078
|
+
* (null only for a guide with no body yet), the item's own id otherwise.
|
|
2079
|
+
* Optional so a client tolerates a server that predates it, and one that
|
|
2080
|
+
* stops sending it (the item id is the artifact id).
|
|
2350
2081
|
*/
|
|
2351
|
-
readonly
|
|
2082
|
+
readonly artifactId: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
|
|
2352
2083
|
/**
|
|
2353
|
-
*
|
|
2354
|
-
*
|
|
2355
|
-
*
|
|
2084
|
+
* Leaving the wire: a reader tells a guide from content by `role` and the
|
|
2085
|
+
* guide fields, not by this. Optional so a client parses a server that no
|
|
2086
|
+
* longer sends it.
|
|
2356
2087
|
*/
|
|
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>;
|
|
2088
|
+
readonly type: v.OptionalSchema<v.PicklistSchema<string[], undefined>, undefined>;
|
|
2089
|
+
readonly name: v.StringSchema<undefined>;
|
|
2366
2090
|
/**
|
|
2367
|
-
*
|
|
2368
|
-
*
|
|
2369
|
-
*
|
|
2370
|
-
*
|
|
2371
|
-
*
|
|
2372
|
-
*
|
|
2091
|
+
* The stored `(role, format)` pair, as two bare nullable strings.
|
|
2092
|
+
*
|
|
2093
|
+
* **Both are deliberately unenumerated.** A client switches on one value it
|
|
2094
|
+
* cares about — `role === 'criteria'` is how a rubric is told from ordinary
|
|
2095
|
+
* prose, which `type` cannot say because a rubric serializes as a `document` —
|
|
2096
|
+
* and a server that adds a fourth role or a fifth format must not break a
|
|
2097
|
+
* client that has never heard of it. Narrowing them here would make every such
|
|
2098
|
+
* addition a breaking wire change for no reader's benefit.
|
|
2099
|
+
*
|
|
2100
|
+
* Null on exactly the rows that carry no content: a tombstone, and an alias.
|
|
2101
|
+
* A `guide` item has no pair at all — it is a different table — and reports
|
|
2102
|
+
* both as null.
|
|
2373
2103
|
*/
|
|
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>;
|
|
2104
|
+
readonly role: v.NullableSchema<v.StringSchema<undefined>, undefined>;
|
|
2105
|
+
readonly format: v.NullableSchema<v.StringSchema<undefined>, undefined>;
|
|
2106
|
+
readonly content: v.NullableSchema<v.StringSchema<undefined>, undefined>;
|
|
2107
|
+
readonly origin: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
|
|
2108
|
+
readonly version: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
|
|
2383
2109
|
/**
|
|
2384
|
-
*
|
|
2385
|
-
*
|
|
2110
|
+
* The guide a **derived** item belongs to — its evaluation criteria, or a
|
|
2111
|
+
* skill's member files (`subscription-delivery-target-plan.md` → slice 4).
|
|
2386
2112
|
*
|
|
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.
|
|
2113
|
+
* Absent on everything else, including a guide itself: a guide member is
|
|
2114
|
+
* addressed by the guide's own id, so `id` already answers this for it.
|
|
2393
2115
|
*
|
|
2394
|
-
*
|
|
2395
|
-
*
|
|
2396
|
-
*
|
|
2116
|
+
* It exists because derived items have no bundle membership and no id of their
|
|
2117
|
+
* guide's — they are `guide_files` rows attached by `guide_id` — so a rule
|
|
2118
|
+
* expressed over guide ids (a subscriber's mute) cannot reach them from the
|
|
2119
|
+
* item alone. Muting a skill and still delivering its `scripts/` would leave a
|
|
2120
|
+
* broken half-skill on disk, which is worse than not muting at all.
|
|
2397
2121
|
*/
|
|
2398
|
-
readonly
|
|
2122
|
+
readonly guideId: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
|
|
2123
|
+
readonly root: v.OptionalSchema<v.NullableSchema<v.PicklistSchema<["project", "global"], undefined>, undefined>, undefined>;
|
|
2124
|
+
readonly path: v.OptionalSchema<v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 512, undefined>, v.CheckAction<string, "path must use forward slashes">, v.CheckAction<string, "path must be relative">, v.CheckAction<string, "path must not contain control characters">, v.CheckAction<string, "path must not contain empty, \".\" or \"..\" segments">]>, undefined>, undefined>;
|
|
2125
|
+
readonly projectId: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
|
|
2399
2126
|
/**
|
|
2400
|
-
*
|
|
2401
|
-
*
|
|
2402
|
-
*
|
|
2403
|
-
*
|
|
2404
|
-
*
|
|
2405
|
-
*
|
|
2127
|
+
* The repo a **document's** declared `path` is placed in — its home — as the
|
|
2128
|
+
* `project.id` of the checkout that last set the path. Documents only.
|
|
2129
|
+
*
|
|
2130
|
+
* Deliberately not `projectId` above: a reader takes a mismatch there as "this
|
|
2131
|
+
* item belongs to another repo, do not materialize it", so a home echoed on it
|
|
2132
|
+
* would stop every other subscriber receiving the document at all. A home says
|
|
2133
|
+
* only *where* the path is literal. Only the repo whose `project.id` matches
|
|
2134
|
+
* writes the document at `path`; every other repo mirrors it under the
|
|
2135
|
+
* bundle folder (`bundleMirrorPath` in `@mossbear/projections`).
|
|
2136
|
+
*
|
|
2137
|
+
* Absent and null read the same — **no home**, so no repo takes the path
|
|
2138
|
+
* literally for a new placement. A server predating the field says the same,
|
|
2139
|
+
* which is the safe direction: the file lands inside the bundle folder
|
|
2140
|
+
* instead of at a repo path it may not belong in.
|
|
2406
2141
|
*/
|
|
2407
|
-
readonly
|
|
2142
|
+
readonly pathProjectId: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
|
|
2143
|
+
readonly aliases: v.OptionalSchema<v.SchemaWithPipe<readonly [v.ArraySchema<v.ObjectSchema<{
|
|
2144
|
+
readonly root: v.PicklistSchema<["project", "global"], undefined>;
|
|
2145
|
+
readonly path: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 512, undefined>, v.CheckAction<string, "path must use forward slashes">, v.CheckAction<string, "path must be relative">, v.CheckAction<string, "path must not contain control characters">, v.CheckAction<string, "path must not contain empty, \".\" or \"..\" segments">]>;
|
|
2146
|
+
}, undefined>, undefined>, v.MaxLengthAction<{
|
|
2147
|
+
root: "project" | "global";
|
|
2148
|
+
path: string;
|
|
2149
|
+
}[], 8, undefined>]>, undefined>;
|
|
2408
2150
|
/**
|
|
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.
|
|
2151
|
+
* Open comments a person left about this item, newest first.
|
|
2152
|
+
*
|
|
2153
|
+
* Optional, and absent rather than empty when there are none — the same rule
|
|
2154
|
+
* `aliases` and `projectId` follow above, and for the same reason: an older
|
|
2155
|
+
* reader against a newer server ignores the key, and a newer reader against
|
|
2156
|
+
* an older server reads "no comments" instead of failing.
|
|
2157
|
+
*
|
|
2158
|
+
* **Absence is not a verdict.** No comments here means none were served on this
|
|
2159
|
+
* item in this response — not that nobody has anything to say about it.
|
|
2778
2160
|
*/
|
|
2779
2161
|
readonly comments: v.OptionalSchema<v.SchemaWithPipe<readonly [v.ArraySchema<v.ObjectSchema<{
|
|
2780
2162
|
readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
@@ -3063,1477 +2445,564 @@ export declare const PushContextResponseSchema: v.ObjectSchema<{
|
|
|
3063
2445
|
branch?: string | undefined;
|
|
3064
2446
|
} | null | undefined;
|
|
3065
2447
|
removed?: true | undefined;
|
|
3066
|
-
}>]>;
|
|
3067
|
-
readonly
|
|
2448
|
+
}>]>, undefined>;
|
|
2449
|
+
readonly untrusted: v.OptionalSchema<v.NullableSchema<v.ObjectSchema<{
|
|
2450
|
+
readonly token: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
2451
|
+
readonly startMarker: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
2452
|
+
readonly endMarker: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
2453
|
+
readonly note: v.StringSchema<undefined>;
|
|
2454
|
+
}, undefined>, undefined>, undefined>;
|
|
3068
2455
|
}, 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>;
|
|
2456
|
+
/**
|
|
2457
|
+
* How many bundles one comments read may name.
|
|
2458
|
+
*
|
|
2459
|
+
* A repo's delivery set is the union of its committed subscriptions and the
|
|
2460
|
+
* reader's account ones, so this bounds a request, not a product limit: a
|
|
2461
|
+
* reader subscribing to more bundles than this asks in two calls rather than
|
|
2462
|
+
* losing the tail silently.
|
|
2463
|
+
*/
|
|
2464
|
+
export declare const MAX_COMMENT_BUNDLE_IDS = 100;
|
|
2465
|
+
/**
|
|
2466
|
+
* How many times one subscriber is told, in one repo, that a given comment is
|
|
2467
|
+
* waiting before the hook falls silent about it.
|
|
2468
|
+
*
|
|
2469
|
+
* **A cap on the interruption, never on the comment.** After it is reached the
|
|
2470
|
+
* comment is still open, still on the item page, and still returned in full by
|
|
2471
|
+
* the on-demand read — it simply stops being announced in front of the first
|
|
2472
|
+
* turn of every session. So silence here means "nothing new to interrupt you
|
|
2473
|
+
* about", never "nobody left anything".
|
|
2474
|
+
*
|
|
2475
|
+
* Three rather than one, for the reason the announcement exists: the first
|
|
2476
|
+
* session in a repo is often doing unrelated work, so a one-shot announcement
|
|
2477
|
+
* would routinely spend itself on the session least likely to act. Three is a
|
|
2478
|
+
* judgement, named so replacing it is one edit — the same discipline the live
|
|
2479
|
+
* session window is held to.
|
|
2480
|
+
*/
|
|
2481
|
+
export declare const MAX_COMMENT_ANNOUNCEMENTS_PER_REPO = 3;
|
|
2482
|
+
/**
|
|
2483
|
+
* Ask which comments are waiting for this reader in this repo, and be counted as
|
|
2484
|
+
* told.
|
|
2485
|
+
*
|
|
2486
|
+
* **A write, because being told is a fact the server has to keep.** The count
|
|
2487
|
+
* cannot be `item_comments.delivered_count` — that is one global number across
|
|
2488
|
+
* every subscriber and every repo, so one reader's fill of a comment would
|
|
2489
|
+
* silence it for everyone — and it cannot live in the checkout, because the
|
|
2490
|
+
* disposable environments this exists for rebuild the clone every session and
|
|
2491
|
+
* a counter there resets with it, announcing every unresolved comment as new
|
|
2492
|
+
* forever.
|
|
2493
|
+
*/
|
|
2494
|
+
export declare const AnnounceItemCommentsRequestSchema: v.ObjectSchema<{
|
|
2495
|
+
/**
|
|
2496
|
+
* The repo, as its committed config declares it. Required: it is the scope
|
|
2497
|
+
* the count is kept under, and a request with nothing to key on could only
|
|
2498
|
+
* be answered by an uncapped announcement — which is the repeating broadcast
|
|
2499
|
+
* this route exists to end.
|
|
2500
|
+
*/
|
|
2501
|
+
readonly projectId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 128, undefined>, v.RegexAction<string, "projectId must contain only letters, digits, underscore, dot or hyphen">]>;
|
|
3132
2502
|
/**
|
|
3133
|
-
*
|
|
3134
|
-
* file, so the revision stops being delivered while the row and its version
|
|
3135
|
-
* history stay where they are.
|
|
2503
|
+
* The bundles this repo receives — the union the caller already resolved.
|
|
3136
2504
|
*
|
|
3137
|
-
*
|
|
3138
|
-
*
|
|
3139
|
-
*
|
|
3140
|
-
*
|
|
3141
|
-
|
|
3142
|
-
|
|
2505
|
+
* Sent rather than derived, because only half of it is the server's to know:
|
|
2506
|
+
* a repo-scoped subscription lives in the committed config and travels by
|
|
2507
|
+
* `git clone`. Declaring a bundle grants nothing: every one of them is still
|
|
2508
|
+
* filtered by the caller's own workspace membership.
|
|
2509
|
+
*/
|
|
2510
|
+
readonly bundleIds: v.SchemaWithPipe<readonly [v.ArraySchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>, v.MaxLengthAction<string[], 100, undefined>]>;
|
|
2511
|
+
}, undefined>;
|
|
2512
|
+
export type AnnounceItemCommentsRequest = v.InferOutput<typeof AnnounceItemCommentsRequestSchema>;
|
|
2513
|
+
/**
|
|
2514
|
+
* What an announcement answers: how many comments are waiting, and how many of
|
|
2515
|
+
* them this call was counted as announcing.
|
|
2516
|
+
*
|
|
2517
|
+
* **Two numbers because they answer two questions and a reader needs both.**
|
|
2518
|
+
* `open` is the true state of this repo's comments and is what a caller shows a
|
|
2519
|
+
* person — a number that is sometimes a subset of the truth would be worse
|
|
2520
|
+
* than the silence it replaced. `announced` is how many of those were still
|
|
2521
|
+
* under the cap, and it is the one that decides whether to speak at all: zero
|
|
2522
|
+
* means this reader has already been told about every one of them as often as
|
|
2523
|
+
* the cap allows.
|
|
2524
|
+
*/
|
|
2525
|
+
export declare const AnnounceItemCommentsResponseSchema: v.ObjectSchema<{
|
|
2526
|
+
/** Open, unmuted comments about the items these bundles deliver to this reader. */
|
|
2527
|
+
readonly open: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
|
|
2528
|
+
/** How many of those were under the cap and have now been counted as announced. */
|
|
2529
|
+
readonly announced: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
|
|
2530
|
+
}, undefined>;
|
|
2531
|
+
export type AnnounceItemCommentsResponse = v.InferOutput<typeof AnnounceItemCommentsResponseSchema>;
|
|
2532
|
+
/**
|
|
2533
|
+
* How many comments one agent session may leave on one subject, not counting its
|
|
2534
|
+
* whole-subject comment. Anchored comments and replies share it.
|
|
2535
|
+
*/
|
|
2536
|
+
export declare const MAX_AGENT_COMMENTS_PER_SUBJECT = 50;
|
|
2537
|
+
/** The longest an agent comment's text may be, in characters. */
|
|
2538
|
+
export declare const MAX_AGENT_COMMENT_BODY_CHARS = 4000;
|
|
2539
|
+
/**
|
|
2540
|
+
* Why an agent comment was refused, as the `code` on the error body. A caller
|
|
2541
|
+
* branches on these; the message beside one is for a person.
|
|
2542
|
+
*/
|
|
2543
|
+
export declare const AGENT_COMMENT_ERROR_CODES: readonly ["agent_session_required", "agent_comment_limit_reached", "agent_comment_text_only", "agent_comment_target_missing", "agent_comment_passage_not_found", "agent_comment_passage_ambiguous", "item_comment_limit_reached"];
|
|
2544
|
+
export declare const AgentCommentErrorCodeSchema: v.PicklistSchema<readonly ["agent_session_required", "agent_comment_limit_reached", "agent_comment_text_only", "agent_comment_target_missing", "agent_comment_passage_not_found", "agent_comment_passage_ambiguous", "item_comment_limit_reached"], undefined>;
|
|
2545
|
+
export type AgentCommentErrorCode = v.InferOutput<typeof AgentCommentErrorCodeSchema>;
|
|
2546
|
+
/**
|
|
2547
|
+
* Leave a comment, or reply to one, as an agent (`POST /api/v1/context/comments`).
|
|
2548
|
+
*
|
|
2549
|
+
* **`target` names what the comment is about, one way.** `artifact` is the id
|
|
2550
|
+
* a bundle read gave for a guide or document, and `item` is its older name for
|
|
2551
|
+
* the same thing, accepted until every client sends `artifact`. `session` is an
|
|
2552
|
+
* agent session id of the caller's own (the key a search hit and the session digest hand out), and
|
|
2553
|
+
* `reply` is the id of a comment to answer. A reply joins that comment's thread
|
|
2554
|
+
* and the subject it is about.
|
|
2555
|
+
*
|
|
2556
|
+
* **Who the agent is comes from `agent`, and `sessionId` is the harness's own
|
|
2557
|
+
* id as the CLI read it.** A request without one is refused with
|
|
2558
|
+
* `agent_session_required`, and the CLI and tool offer no way to type one. The
|
|
2559
|
+
* server cannot check it against the harness, so it is a claim by the holder of
|
|
2560
|
+
* the token: the comment is always written under that token's account, and the
|
|
2561
|
+
* handle shown for it names a session only as far as the claim is true.
|
|
2562
|
+
*
|
|
2563
|
+
* **Text only.** There is no replacement-text field, and a request that carries
|
|
2564
|
+
* one is refused with `agent_comment_text_only` rather than having it dropped.
|
|
2565
|
+
*/
|
|
2566
|
+
export declare const AgentCommentRequestSchema: v.ObjectSchema<{
|
|
2567
|
+
readonly target: v.VariantSchema<"kind", [v.ObjectSchema<{
|
|
2568
|
+
readonly kind: v.LiteralSchema<"artifact", undefined>;
|
|
2569
|
+
readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 128, undefined>]>;
|
|
2570
|
+
}, undefined>, v.ObjectSchema<{
|
|
2571
|
+
readonly kind: v.LiteralSchema<"session", undefined>;
|
|
2572
|
+
readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 128, undefined>]>;
|
|
2573
|
+
}, undefined>, v.ObjectSchema<{
|
|
2574
|
+
readonly kind: v.LiteralSchema<"reply", undefined>;
|
|
2575
|
+
readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 128, undefined>]>;
|
|
2576
|
+
}, undefined>], undefined>;
|
|
2577
|
+
readonly body: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 4000, undefined>]>;
|
|
2578
|
+
/**
|
|
2579
|
+
* The passage an item comment is about, as the exact text of one or more whole
|
|
2580
|
+
* lines of the item (a paragraph, a heading, a list). None means the item as a
|
|
2581
|
+
* whole. The server finds the lines; a passage that is not in the item as it is
|
|
2582
|
+
* now is refused with `agent_comment_passage_not_found`.
|
|
2583
|
+
*/
|
|
2584
|
+
readonly passage: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 8000, undefined>]>, undefined>;
|
|
2585
|
+
readonly agent: v.ObjectSchema<{
|
|
2586
|
+
readonly sessionId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 128, undefined>]>;
|
|
2587
|
+
readonly harness: v.PicklistSchema<["claude_code", "codex", "antigravity", "opencode"], undefined>;
|
|
2588
|
+
/** The agent's own statement of its model, when it knows it. */
|
|
2589
|
+
readonly model: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 100, undefined>]>, undefined>;
|
|
2590
|
+
readonly cliVersion: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 64, undefined>]>, undefined>;
|
|
2591
|
+
}, undefined>;
|
|
2592
|
+
}, undefined>;
|
|
2593
|
+
export type AgentCommentRequest = v.InferOutput<typeof AgentCommentRequestSchema>;
|
|
2594
|
+
/**
|
|
2595
|
+
* The comment a create settled on. `created` is false when this agent session
|
|
2596
|
+
* already had a whole-subject comment on the subject: that comment comes back
|
|
2597
|
+
* unchanged and nothing was written.
|
|
2598
|
+
*/
|
|
2599
|
+
export declare const AgentCommentResponseSchema: v.ObjectSchema<{
|
|
2600
|
+
readonly created: v.BooleanSchema<undefined>;
|
|
2601
|
+
readonly comment: v.ObjectSchema<{
|
|
2602
|
+
readonly id: v.StringSchema<undefined>;
|
|
2603
|
+
readonly threadId: v.StringSchema<undefined>;
|
|
2604
|
+
readonly subject: v.ObjectSchema<{
|
|
2605
|
+
readonly kind: v.PicklistSchema<["artifact", "session"], undefined>;
|
|
2606
|
+
readonly id: v.StringSchema<undefined>;
|
|
2607
|
+
}, undefined>;
|
|
2608
|
+
readonly body: v.StringSchema<undefined>;
|
|
2609
|
+
readonly createdAt: v.StringSchema<undefined>;
|
|
2610
|
+
}, undefined>;
|
|
2611
|
+
}, undefined>;
|
|
2612
|
+
export type AgentCommentResponse = v.InferOutput<typeof AgentCommentResponseSchema>;
|
|
2613
|
+
/**
|
|
2614
|
+
* One comment on the on-demand read, with the item it is about named on the comment.
|
|
2615
|
+
*
|
|
2616
|
+
* The item is named here rather than the comments riding an item, because this
|
|
2617
|
+
* read answers "what has been left for me" rather than "what is in this
|
|
2618
|
+
* bundle": there is no item payload to hang them off, and an agent that has to
|
|
2619
|
+
* ask for every item to find out whether one carries a comment is the round trip
|
|
2620
|
+
* the announcement exists to avoid.
|
|
2621
|
+
*/
|
|
2622
|
+
export declare const ItemCommentWithSubjectSchema: v.ObjectSchema<{
|
|
2623
|
+
/** The item the comment is about, as the wire names it. */
|
|
2624
|
+
readonly itemName: v.StringSchema<undefined>;
|
|
2625
|
+
/** The item's declared repo-relative path, or null when it has none. */
|
|
2626
|
+
readonly itemPath: v.NullableSchema<v.StringSchema<undefined>, undefined>;
|
|
2627
|
+
readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
2628
|
+
readonly state: v.OptionalSchema<v.PicklistSchema<["open", "resolved"], undefined>, undefined>;
|
|
2629
|
+
/** Current source location of an anchored passage, or its lost quote. */
|
|
2630
|
+
readonly passage: v.OptionalSchema<v.ObjectSchema<{
|
|
2631
|
+
readonly quote: v.StringSchema<undefined>;
|
|
2632
|
+
readonly status: v.PicklistSchema<["located", "changed", "orphaned"], undefined>;
|
|
2633
|
+
readonly lines: v.NullableSchema<v.ObjectSchema<{
|
|
2634
|
+
readonly start: v.NumberSchema<undefined>;
|
|
2635
|
+
readonly end: v.NumberSchema<undefined>;
|
|
2636
|
+
}, undefined>, undefined>;
|
|
2637
|
+
}, undefined>, undefined>;
|
|
2638
|
+
/** The comment's text, already wrapped in the response's untrusted markers. */
|
|
2639
|
+
readonly body: v.StringSchema<undefined>;
|
|
2640
|
+
/**
|
|
2641
|
+
* A suggested edit: the replacement for the passage at `passage.lines`,
|
|
2642
|
+
* already wrapped in the response's untrusted markers like `body`. An
|
|
2643
|
+
* insertion is the passage plus its new lines and an empty replacement is a
|
|
2644
|
+
* deletion, so every edit is one replace. Absent on an ordinary comment.
|
|
2645
|
+
*/
|
|
2646
|
+
readonly suggestion: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
|
|
2647
|
+
/**
|
|
2648
|
+
* What a comment Mossbear wrote is: a finding about the item, never an edit.
|
|
2649
|
+
* Present only on a Mossbear comment. The comment's `body` begins with the
|
|
2650
|
+
* claim (what goes wrong); this carries what the claim rests on.
|
|
2651
|
+
*/
|
|
2652
|
+
readonly finding: v.OptionalSchema<v.ObjectSchema<{
|
|
2653
|
+
readonly tier: v.PicklistSchema<["observed", "usage", "practice"], undefined>;
|
|
2654
|
+
/** How the finding is known, in one line: "Seen in 3 sessions (2026-09-15 – 2026-10-03)". */
|
|
2655
|
+
readonly tierLine: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 300, undefined>]>;
|
|
2656
|
+
/** What the drafter did not read, fixed per tier. */
|
|
2657
|
+
readonly blindSpot: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 300, undefined>]>;
|
|
2658
|
+
/** What should change in later sessions if the finding is fixed, wrapped in the untrusted markers. */
|
|
2659
|
+
readonly prediction: v.NullableSchema<v.StringSchema<undefined>, undefined>;
|
|
2660
|
+
}, undefined>, undefined>;
|
|
2661
|
+
/**
|
|
2662
|
+
* Whether the person approved a comment Mossbear drafted. Present on every
|
|
2663
|
+
* Mossbear comment and absent on a person's or an agent's, which are
|
|
2664
|
+
* requests as written. `false` is a draft nobody has read yet: a reader shows
|
|
2665
|
+
* it to the user and acts only on their go-ahead. Only a client that reports
|
|
2666
|
+
* a version able to mark drafts is ever listed one, so an older reader that
|
|
2667
|
+
* strips this field never receives a draft it would print as a request.
|
|
2668
|
+
*/
|
|
2669
|
+
readonly approved: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
|
|
2670
|
+
/** The author's display name as the workspace shows it, or null. Never an email. */
|
|
2671
|
+
readonly authorName: v.NullableSchema<v.StringSchema<undefined>, undefined>;
|
|
2672
|
+
/** ISO timestamp, machine format. */
|
|
2673
|
+
readonly createdAt: v.StringSchema<undefined>;
|
|
2674
|
+
/** The item's content version the comment was written against. */
|
|
2675
|
+
readonly itemVersion: v.NumberSchema<undefined>;
|
|
2676
|
+
/** True when the item's current version is greater than `itemVersion`. */
|
|
2677
|
+
readonly itemChangedSince: v.BooleanSchema<undefined>;
|
|
2678
|
+
/**
|
|
2679
|
+
* How many agent reads were handed this comment **before** this one — so a
|
|
2680
|
+
* comment reaching an agent for the first time reports `0`.
|
|
3143
2681
|
*
|
|
3144
|
-
*
|
|
3145
|
-
*
|
|
3146
|
-
*
|
|
3147
|
-
*
|
|
3148
|
-
*
|
|
3149
|
-
*
|
|
2682
|
+
* It is the stored count as it read at the moment the response was built;
|
|
2683
|
+
* the serve this response *is* has not been counted yet. Excluded rather
|
|
2684
|
+
* than included because the count is recorded best-effort: a response that
|
|
2685
|
+
* claimed to include itself would be wrong whenever that record failed, and
|
|
2686
|
+
* a number that is sometimes off by one is worse than one that is
|
|
2687
|
+
* consistently the prior total.
|
|
3150
2688
|
*
|
|
3151
|
-
*
|
|
3152
|
-
*
|
|
2689
|
+
* So `deliveredCount > 0` means an earlier read was handed this comment, and
|
|
2690
|
+
* `0` means this read is the first. Neither says a model took it in — only
|
|
2691
|
+
* that the server handed it over.
|
|
3153
2692
|
*/
|
|
3154
|
-
readonly
|
|
2693
|
+
readonly deliveredCount: v.NumberSchema<undefined>;
|
|
2694
|
+
/**
|
|
2695
|
+
* This comment's thread root — its own id for every delivered root. Resolution
|
|
2696
|
+
* replies remain on the dashboard thread and are not delivered to agents.
|
|
2697
|
+
* It is on the wire from the first response
|
|
2698
|
+
* because the wire contract is consumed by installed CLI versions: reshaping
|
|
2699
|
+
* a flat `comments` array into threads-of-comments later would be a breaking
|
|
2700
|
+
* change, while a field today's readers ignore costs them nothing.
|
|
2701
|
+
*/
|
|
2702
|
+
readonly threadId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
2703
|
+
/**
|
|
2704
|
+
* Always `null` for a delivered root. Present so an older reader meeting a
|
|
2705
|
+
* future response that carries real replies degrades to
|
|
2706
|
+
* "a flat list of comments" rather than failing to parse.
|
|
2707
|
+
*/
|
|
2708
|
+
readonly replyToId: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>;
|
|
3155
2709
|
}, undefined>;
|
|
3156
|
-
export
|
|
3157
|
-
|
|
3158
|
-
|
|
2710
|
+
export type ItemCommentWithSubject = v.InferOutput<typeof ItemCommentWithSubjectSchema>;
|
|
2711
|
+
/**
|
|
2712
|
+
* Every open comment waiting for this reader across the bundles they named.
|
|
2713
|
+
*
|
|
2714
|
+
* **This read is a delivery and is counted as one**, exactly as comments riding
|
|
2715
|
+
* an item are: a body reached an agent. What it is *not* is an announcement —
|
|
2716
|
+
* nothing here touches the per-repo announcement count, so asking to read your
|
|
2717
|
+
* comments never spends the interruptions the hook is allowed.
|
|
2718
|
+
*
|
|
2719
|
+
* **Never capped.** The announcement cap governs whether a hook speaks; a
|
|
2720
|
+
* reader who asked is owed every open comment, and hiding one here would retire a
|
|
2721
|
+
* person's request without anybody deciding to.
|
|
2722
|
+
*/
|
|
2723
|
+
export declare const ItemCommentsResponseSchema: v.ObjectSchema<{
|
|
2724
|
+
readonly comments: v.ArraySchema<v.ObjectSchema<{
|
|
2725
|
+
/** The item the comment is about, as the wire names it. */
|
|
2726
|
+
readonly itemName: v.StringSchema<undefined>;
|
|
2727
|
+
/** The item's declared repo-relative path, or null when it has none. */
|
|
2728
|
+
readonly itemPath: v.NullableSchema<v.StringSchema<undefined>, undefined>;
|
|
2729
|
+
readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
2730
|
+
readonly state: v.OptionalSchema<v.PicklistSchema<["open", "resolved"], undefined>, undefined>;
|
|
2731
|
+
/** Current source location of an anchored passage, or its lost quote. */
|
|
2732
|
+
readonly passage: v.OptionalSchema<v.ObjectSchema<{
|
|
2733
|
+
readonly quote: v.StringSchema<undefined>;
|
|
2734
|
+
readonly status: v.PicklistSchema<["located", "changed", "orphaned"], undefined>;
|
|
2735
|
+
readonly lines: v.NullableSchema<v.ObjectSchema<{
|
|
2736
|
+
readonly start: v.NumberSchema<undefined>;
|
|
2737
|
+
readonly end: v.NumberSchema<undefined>;
|
|
2738
|
+
}, undefined>, undefined>;
|
|
2739
|
+
}, undefined>, undefined>;
|
|
2740
|
+
/** The comment's text, already wrapped in the response's untrusted markers. */
|
|
2741
|
+
readonly body: v.StringSchema<undefined>;
|
|
3159
2742
|
/**
|
|
3160
|
-
*
|
|
3161
|
-
*
|
|
3162
|
-
*
|
|
3163
|
-
*
|
|
2743
|
+
* A suggested edit: the replacement for the passage at `passage.lines`,
|
|
2744
|
+
* already wrapped in the response's untrusted markers like `body`. An
|
|
2745
|
+
* insertion is the passage plus its new lines and an empty replacement is a
|
|
2746
|
+
* deletion, so every edit is one replace. Absent on an ordinary comment.
|
|
3164
2747
|
*/
|
|
3165
|
-
readonly
|
|
2748
|
+
readonly suggestion: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
|
|
3166
2749
|
/**
|
|
3167
|
-
*
|
|
3168
|
-
*
|
|
3169
|
-
*
|
|
2750
|
+
* What a comment Mossbear wrote is: a finding about the item, never an edit.
|
|
2751
|
+
* Present only on a Mossbear comment. The comment's `body` begins with the
|
|
2752
|
+
* claim (what goes wrong); this carries what the claim rests on.
|
|
3170
2753
|
*/
|
|
3171
|
-
readonly
|
|
3172
|
-
|
|
2754
|
+
readonly finding: v.OptionalSchema<v.ObjectSchema<{
|
|
2755
|
+
readonly tier: v.PicklistSchema<["observed", "usage", "practice"], undefined>;
|
|
2756
|
+
/** How the finding is known, in one line: "Seen in 3 sessions (2026-09-15 – 2026-10-03)". */
|
|
2757
|
+
readonly tierLine: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 300, undefined>]>;
|
|
2758
|
+
/** What the drafter did not read, fixed per tier. */
|
|
2759
|
+
readonly blindSpot: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 300, undefined>]>;
|
|
2760
|
+
/** What should change in later sessions if the finding is fixed, wrapped in the untrusted markers. */
|
|
2761
|
+
readonly prediction: v.NullableSchema<v.StringSchema<undefined>, undefined>;
|
|
2762
|
+
}, undefined>, undefined>;
|
|
3173
2763
|
/**
|
|
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.
|
|
2764
|
+
* Whether the person approved a comment Mossbear drafted. Present on every
|
|
2765
|
+
* Mossbear comment and absent on a person's or an agent's, which are
|
|
2766
|
+
* requests as written. `false` is a draft nobody has read yet: a reader shows
|
|
2767
|
+
* it to the user and acts only on their go-ahead. Only a client that reports
|
|
2768
|
+
* a version able to mark drafts is ever listed one, so an older reader that
|
|
2769
|
+
* strips this field never receives a draft it would print as a request.
|
|
3186
2770
|
*/
|
|
3187
|
-
readonly
|
|
3188
|
-
|
|
3189
|
-
readonly
|
|
3190
|
-
|
|
3191
|
-
readonly
|
|
2771
|
+
readonly approved: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
|
|
2772
|
+
/** The author's display name as the workspace shows it, or null. Never an email. */
|
|
2773
|
+
readonly authorName: v.NullableSchema<v.StringSchema<undefined>, undefined>;
|
|
2774
|
+
/** ISO timestamp, machine format. */
|
|
2775
|
+
readonly createdAt: v.StringSchema<undefined>;
|
|
2776
|
+
/** The item's content version the comment was written against. */
|
|
2777
|
+
readonly itemVersion: v.NumberSchema<undefined>;
|
|
2778
|
+
/** True when the item's current version is greater than `itemVersion`. */
|
|
2779
|
+
readonly itemChangedSince: v.BooleanSchema<undefined>;
|
|
3192
2780
|
/**
|
|
3193
|
-
*
|
|
3194
|
-
*
|
|
2781
|
+
* How many agent reads were handed this comment **before** this one — so a
|
|
2782
|
+
* comment reaching an agent for the first time reports `0`.
|
|
3195
2783
|
*
|
|
3196
|
-
*
|
|
3197
|
-
*
|
|
2784
|
+
* It is the stored count as it read at the moment the response was built;
|
|
2785
|
+
* the serve this response *is* has not been counted yet. Excluded rather
|
|
2786
|
+
* than included because the count is recorded best-effort: a response that
|
|
2787
|
+
* claimed to include itself would be wrong whenever that record failed, and
|
|
2788
|
+
* a number that is sometimes off by one is worse than one that is
|
|
2789
|
+
* consistently the prior total.
|
|
3198
2790
|
*
|
|
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.
|
|
2791
|
+
* So `deliveredCount > 0` means an earlier read was handed this comment, and
|
|
2792
|
+
* `0` means this read is the first. Neither says a model took it in — only
|
|
2793
|
+
* that the server handed it over.
|
|
3204
2794
|
*/
|
|
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>;
|
|
2795
|
+
readonly deliveredCount: v.NumberSchema<undefined>;
|
|
3209
2796
|
/**
|
|
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.
|
|
2797
|
+
* This comment's thread root — its own id for every delivered root. Resolution
|
|
2798
|
+
* replies remain on the dashboard thread and are not delivered to agents.
|
|
2799
|
+
* It is on the wire from the first response
|
|
2800
|
+
* because the wire contract is consumed by installed CLI versions: reshaping
|
|
2801
|
+
* a flat `comments` array into threads-of-comments later would be a breaking
|
|
2802
|
+
* change, while a field today's readers ignore costs them nothing.
|
|
3224
2803
|
*/
|
|
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>;
|
|
2804
|
+
readonly threadId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
3233
2805
|
/**
|
|
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.
|
|
2806
|
+
* Always `null` for a delivered root. Present so an older reader meeting a
|
|
2807
|
+
* future response that carries real replies degrades to
|
|
2808
|
+
* "a flat list of comments" rather than failing to parse.
|
|
3243
2809
|
*/
|
|
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>;
|
|
2810
|
+
readonly replyToId: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>;
|
|
2811
|
+
}, undefined>, undefined>;
|
|
2812
|
+
readonly cursor: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
|
|
3547
2813
|
/**
|
|
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.
|
|
2814
|
+
* The markers every `body` above is wrapped in, plus a statement of what
|
|
2815
|
+
* they mean. Present exactly when at least one comment came back.
|
|
3565
2816
|
*/
|
|
3566
|
-
readonly
|
|
3567
|
-
|
|
2817
|
+
readonly untrusted: v.OptionalSchema<v.NullableSchema<v.ObjectSchema<{
|
|
2818
|
+
readonly token: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
2819
|
+
readonly startMarker: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
2820
|
+
readonly endMarker: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
2821
|
+
readonly note: v.StringSchema<undefined>;
|
|
2822
|
+
}, undefined>, undefined>, undefined>;
|
|
2823
|
+
}, undefined>;
|
|
2824
|
+
export type ItemCommentsResponse = v.InferOutput<typeof ItemCommentsResponseSchema>;
|
|
2825
|
+
/**
|
|
2826
|
+
* The evidence behind one Mossbear finding an agent was handed
|
|
2827
|
+
* (`GET /api/v1/context/comments/evidence`).
|
|
2828
|
+
*
|
|
2829
|
+
* `list_comments` carries the claim and a one-line tier; this is the finding
|
|
2830
|
+
* in full: the claim, the change it predicts in future sessions, what the
|
|
2831
|
+
* drafter did not read, and the evidence for its tier. Readable only through a
|
|
2832
|
+
* comment the comment read itself would deliver to this reader, so another
|
|
2833
|
+
* person's finding, one drafted from another repo, or a draft listed only to a
|
|
2834
|
+
* newer client has no evidence here either. A draft the reader was listed
|
|
2835
|
+
* does: an agent can say why it was raised before the person approves it.
|
|
2836
|
+
*
|
|
2837
|
+
* Citations (observed and usage findings) are reduced to what the reader may
|
|
2838
|
+
* see: their own sessions, with a date and a short excerpt of the grader's
|
|
2839
|
+
* reasoning or of their own redacted correction turn. A `navigation` citation
|
|
2840
|
+
* has an empty excerpt: it is dated evidence that a session loaded the skill,
|
|
2841
|
+
* and nothing more. `citationsWithheld` counts any that were dropped, so a
|
|
2842
|
+
* short list is never mistaken for the whole of it.
|
|
2843
|
+
*/
|
|
2844
|
+
export declare const CommentEvidenceCitationSchema: v.ObjectSchema<{
|
|
3568
2845
|
/**
|
|
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.
|
|
2846
|
+
* `navigation` is a skill load counted when a finding was drafted from how
|
|
2847
|
+
* the skill's files were read: evidence of how a skill was used, not of a
|
|
2848
|
+
* failure. `action` is a recorded step of a workflow repeated across
|
|
2849
|
+
* sessions. A server sends it only to a client that names a version new
|
|
2850
|
+
* enough to parse it.
|
|
3580
2851
|
*/
|
|
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<{
|
|
2852
|
+
readonly kind: v.PicklistSchema<["verdict", "turn", "navigation", "action"], undefined>;
|
|
2853
|
+
readonly sessionId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
2854
|
+
/** ISO, when the verdict was graded, the turn was said, the skill loaded, or the action was recorded. */
|
|
2855
|
+
readonly at: v.StringSchema<undefined>;
|
|
2856
|
+
/** Wrapped in the response's untrusted markers. */
|
|
2857
|
+
readonly excerpt: v.StringSchema<undefined>;
|
|
2858
|
+
}, undefined>;
|
|
2859
|
+
export type CommentEvidenceCitation = v.InferOutput<typeof CommentEvidenceCitationSchema>;
|
|
2860
|
+
/** What a usage finding adds to its citations: the counts for one reference file. */
|
|
2861
|
+
export declare const CommentEvidenceUsageSchema: v.ObjectSchema<{
|
|
2862
|
+
/** The reference's skill-relative path, wrapped in the response's untrusted markers. */
|
|
2863
|
+
readonly path: v.StringSchema<undefined>;
|
|
2864
|
+
/** Eligible loads of the skill. */
|
|
2865
|
+
readonly loads: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>]>;
|
|
2866
|
+
/** Distinct sessions those loads span. */
|
|
2867
|
+
readonly sessions: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>]>;
|
|
2868
|
+
/** Loads followed by a successful read of the reference. */
|
|
2869
|
+
readonly loadsWithRead: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>]>;
|
|
2870
|
+
}, undefined>;
|
|
2871
|
+
/**
|
|
2872
|
+
* What a practice finding adds: the rubric check it answers and the rubric's
|
|
2873
|
+
* version, the practice lines it weighs with their sources, the facts measured
|
|
2874
|
+
* from the file, and the answer to each item of evidence the check asks for.
|
|
2875
|
+
* `answers[].answer` is model-written, so it travels wrapped in the response's
|
|
2876
|
+
* untrusted markers.
|
|
2877
|
+
*/
|
|
2878
|
+
export declare const CommentEvidencePracticeSchema: v.ObjectSchema<{
|
|
2879
|
+
readonly check: v.ObjectSchema<{
|
|
3784
2880
|
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
2881
|
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
|
-
}>]>;
|
|
2882
|
+
}, undefined>;
|
|
2883
|
+
readonly rubricVersion: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>]>;
|
|
2884
|
+
readonly practices: v.OptionalSchema<v.ArraySchema<v.ObjectSchema<{
|
|
2885
|
+
readonly text: v.StringSchema<undefined>;
|
|
2886
|
+
readonly source: v.ObjectSchema<{
|
|
2887
|
+
readonly title: v.StringSchema<undefined>;
|
|
2888
|
+
readonly url: v.StringSchema<undefined>;
|
|
2889
|
+
}, undefined>;
|
|
2890
|
+
}, undefined>, undefined>, readonly []>;
|
|
2891
|
+
readonly facts: v.OptionalSchema<v.ArraySchema<v.StringSchema<undefined>, undefined>, readonly []>;
|
|
2892
|
+
readonly answers: v.OptionalSchema<v.ArraySchema<v.ObjectSchema<{
|
|
2893
|
+
readonly item: v.StringSchema<undefined>;
|
|
2894
|
+
readonly answer: v.StringSchema<undefined>;
|
|
2895
|
+
}, undefined>, undefined>, readonly []>;
|
|
2896
|
+
}, undefined>;
|
|
2897
|
+
/**
|
|
2898
|
+
* A comment the person (or Mossbear) left on one of the sessions a finding
|
|
2899
|
+
* cites — the person's own account of what the agent should have known, set
|
|
2900
|
+
* beside the grader's excerpt (`guide-findings-plan.md` → Your note on a
|
|
2901
|
+
* session).
|
|
2902
|
+
*
|
|
2903
|
+
* **Reachable only here.** A comment about a session is never listed by
|
|
2904
|
+
* `list_comments` or announced at session start: it is context for a finding,
|
|
2905
|
+
* found by following the finding's citation, not a request.
|
|
2906
|
+
*/
|
|
2907
|
+
export declare const CommentEvidenceSessionCommentSchema: v.ObjectSchema<{
|
|
2908
|
+
readonly sessionId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
2909
|
+
/** Only the person's own notes are sent today; `mossbear` is reserved. */
|
|
2910
|
+
readonly authorKind: v.PicklistSchema<["person", "mossbear"], undefined>;
|
|
2911
|
+
/** ISO, when the comment was written. */
|
|
2912
|
+
readonly at: v.StringSchema<undefined>;
|
|
2913
|
+
/** Wrapped in the response's untrusted markers. */
|
|
2914
|
+
readonly body: v.StringSchema<undefined>;
|
|
2915
|
+
}, undefined>;
|
|
2916
|
+
export type CommentEvidenceSessionComment = v.InferOutput<typeof CommentEvidenceSessionCommentSchema>;
|
|
2917
|
+
export declare const CommentEvidenceResponseSchema: v.ObjectSchema<{
|
|
2918
|
+
/** The comment's full id, even when the request named a prefix. */
|
|
2919
|
+
readonly commentId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
2920
|
+
readonly itemName: v.StringSchema<undefined>;
|
|
2921
|
+
readonly itemPath: v.NullableSchema<v.StringSchema<undefined>, undefined>;
|
|
2922
|
+
readonly tier: v.PicklistSchema<["observed", "usage", "practice"], undefined>;
|
|
2923
|
+
/** One line saying how the finding is known; server-written, outside the markers. */
|
|
2924
|
+
readonly tierLine: v.StringSchema<undefined>;
|
|
2925
|
+
/** What the drafter did not read; server-written, outside the markers. */
|
|
2926
|
+
readonly blindSpot: v.StringSchema<undefined>;
|
|
2927
|
+
/** What goes wrong, wrapped in the response's untrusted markers. */
|
|
2928
|
+
readonly claim: v.StringSchema<undefined>;
|
|
2929
|
+
/** What future sessions should show if the finding is fixed, wrapped; null if none. */
|
|
2930
|
+
readonly prediction: v.NullableSchema<v.StringSchema<undefined>, undefined>;
|
|
2931
|
+
/** A usage finding's counts; null on every other tier. */
|
|
2932
|
+
readonly usage: v.NullableSchema<v.ObjectSchema<{
|
|
2933
|
+
/** The reference's skill-relative path, wrapped in the response's untrusted markers. */
|
|
2934
|
+
readonly path: v.StringSchema<undefined>;
|
|
2935
|
+
/** Eligible loads of the skill. */
|
|
2936
|
+
readonly loads: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>]>;
|
|
2937
|
+
/** Distinct sessions those loads span. */
|
|
2938
|
+
readonly sessions: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>]>;
|
|
2939
|
+
/** Loads followed by a successful read of the reference. */
|
|
2940
|
+
readonly loadsWithRead: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>]>;
|
|
2941
|
+
}, undefined>, undefined>;
|
|
2942
|
+
/** A practice finding's rubric check; null on every other tier. */
|
|
2943
|
+
readonly practice: v.NullableSchema<v.ObjectSchema<{
|
|
2944
|
+
readonly check: v.ObjectSchema<{
|
|
2945
|
+
readonly id: v.StringSchema<undefined>;
|
|
2946
|
+
readonly name: v.StringSchema<undefined>;
|
|
2947
|
+
}, undefined>;
|
|
2948
|
+
readonly rubricVersion: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>]>;
|
|
2949
|
+
readonly practices: v.OptionalSchema<v.ArraySchema<v.ObjectSchema<{
|
|
2950
|
+
readonly text: v.StringSchema<undefined>;
|
|
2951
|
+
readonly source: v.ObjectSchema<{
|
|
2952
|
+
readonly title: v.StringSchema<undefined>;
|
|
2953
|
+
readonly url: v.StringSchema<undefined>;
|
|
2954
|
+
}, undefined>;
|
|
2955
|
+
}, undefined>, undefined>, readonly []>;
|
|
2956
|
+
readonly facts: v.OptionalSchema<v.ArraySchema<v.StringSchema<undefined>, undefined>, readonly []>;
|
|
2957
|
+
readonly answers: v.OptionalSchema<v.ArraySchema<v.ObjectSchema<{
|
|
2958
|
+
readonly item: v.StringSchema<undefined>;
|
|
2959
|
+
readonly answer: v.StringSchema<undefined>;
|
|
2960
|
+
}, undefined>, undefined>, readonly []>;
|
|
2961
|
+
}, undefined>, undefined>;
|
|
2962
|
+
readonly citations: v.ArraySchema<v.ObjectSchema<{
|
|
2963
|
+
/**
|
|
2964
|
+
* `navigation` is a skill load counted when a finding was drafted from how
|
|
2965
|
+
* the skill's files were read: evidence of how a skill was used, not of a
|
|
2966
|
+
* failure. `action` is a recorded step of a workflow repeated across
|
|
2967
|
+
* sessions. A server sends it only to a client that names a version new
|
|
2968
|
+
* enough to parse it.
|
|
2969
|
+
*/
|
|
2970
|
+
readonly kind: v.PicklistSchema<["verdict", "turn", "navigation", "action"], undefined>;
|
|
2971
|
+
readonly sessionId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
2972
|
+
/** ISO, when the verdict was graded, the turn was said, the skill loaded, or the action was recorded. */
|
|
2973
|
+
readonly at: v.StringSchema<undefined>;
|
|
2974
|
+
/** Wrapped in the response's untrusted markers. */
|
|
2975
|
+
readonly excerpt: v.StringSchema<undefined>;
|
|
2976
|
+
}, undefined>, undefined>;
|
|
2977
|
+
readonly citationsWithheld: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>]>;
|
|
2978
|
+
/**
|
|
2979
|
+
* Comments on the cited sessions, newest first, wrapped in the untrusted
|
|
2980
|
+
* markers. Defaulted so a response from a server that predates the field
|
|
2981
|
+
* still parses.
|
|
2982
|
+
*/
|
|
2983
|
+
readonly sessionComments: v.OptionalSchema<v.ArraySchema<v.ObjectSchema<{
|
|
2984
|
+
readonly sessionId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
2985
|
+
/** Only the person's own notes are sent today; `mossbear` is reserved. */
|
|
2986
|
+
readonly authorKind: v.PicklistSchema<["person", "mossbear"], undefined>;
|
|
2987
|
+
/** ISO, when the comment was written. */
|
|
2988
|
+
readonly at: v.StringSchema<undefined>;
|
|
2989
|
+
/** Wrapped in the response's untrusted markers. */
|
|
2990
|
+
readonly body: v.StringSchema<undefined>;
|
|
2991
|
+
}, undefined>, undefined>, readonly []>;
|
|
2992
|
+
/**
|
|
2993
|
+
* Comments on the cited sessions that were left out to keep the response
|
|
2994
|
+
* bounded (the newest few per session are sent), so a short list is never
|
|
2995
|
+
* mistaken for the whole of it. Zero when none were.
|
|
2996
|
+
*/
|
|
2997
|
+
readonly sessionCommentsWithheld: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>]>, 0>;
|
|
2998
|
+
readonly untrusted: v.ObjectSchema<{
|
|
2999
|
+
readonly token: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
3000
|
+
readonly startMarker: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
3001
|
+
readonly endMarker: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
3002
|
+
readonly note: v.StringSchema<undefined>;
|
|
3003
|
+
}, undefined>;
|
|
4536
3004
|
}, undefined>;
|
|
3005
|
+
export type CommentEvidenceResponse = v.InferOutput<typeof CommentEvidenceResponseSchema>;
|
|
4537
3006
|
export declare const CaptureIdSchema: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 8, "id must be at least 8 characters">, v.MaxLengthAction<string, 128, undefined>, v.RegexAction<string, "id must contain only letters, digits, underscore, dot or hyphen">]>;
|
|
4538
3007
|
export declare const InboxCaptureRequestSchema: v.ObjectSchema<{
|
|
4539
3008
|
/**
|
|
@@ -4625,24 +3094,7 @@ export declare const ArtifactVersionDetailSchema: v.ObjectSchema<{
|
|
|
4625
3094
|
readonly createdAt: v.StringSchema<undefined>;
|
|
4626
3095
|
}, undefined>;
|
|
4627
3096
|
/** 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<{
|
|
3097
|
+
export declare const BundleArtifactVersionsResponseSchema: v.ObjectSchema<{
|
|
4646
3098
|
readonly versions: v.ArraySchema<v.ObjectSchema<{
|
|
4647
3099
|
readonly id: v.StringSchema<undefined>;
|
|
4648
3100
|
readonly version: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>;
|
|
@@ -4653,17 +3105,6 @@ export declare const ContextItemVersionsResponseSchema: v.ObjectSchema<{
|
|
|
4653
3105
|
}, undefined>, undefined>;
|
|
4654
3106
|
readonly nextCursor: v.NullableSchema<v.NumberSchema<undefined>, undefined>;
|
|
4655
3107
|
}, 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
3108
|
/** Default and max page size for the version-history list endpoint. */
|
|
4668
3109
|
export declare const DEFAULT_VERSIONS_LIMIT = 50;
|
|
4669
3110
|
export declare const MAX_VERSIONS_LIMIT = 200;
|
|
@@ -8123,27 +6564,18 @@ export declare const SEARCH_COMMENT_AUTHOR_KINDS: readonly ["person", "agent", "
|
|
|
8123
6564
|
export declare const SearchCommentAuthorKindSchema: v.PicklistSchema<readonly ["person", "agent", "mossbear"], undefined>;
|
|
8124
6565
|
export type SearchCommentAuthorKind = v.InferOutput<typeof SearchCommentAuthorKindSchema>;
|
|
8125
6566
|
/**
|
|
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.
|
|
6567
|
+
* What a comment is attached to. `artifact` is a guide or a document; `session`
|
|
6568
|
+
* is a run the caller made. Session comments are the caller's own and never reach
|
|
6569
|
+
* a workspace-mate.
|
|
8129
6570
|
*/
|
|
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
6571
|
/**
|
|
8134
6572
|
* The subject kinds a client names in a search: `artifact`, never its older
|
|
8135
6573
|
* name `item`.
|
|
8136
6574
|
*/
|
|
8137
6575
|
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>;
|
|
6576
|
+
export declare const SearchCommentSubjectKindFilterSchema: v.PicklistSchema<readonly ["artifact", "session"], undefined>;
|
|
8146
6577
|
export type SearchCommentSubjectKindFilter = v.InferOutput<typeof SearchCommentSubjectKindFilterSchema>;
|
|
6578
|
+
export type SearchCommentSubjectKindName = (typeof SEARCH_COMMENT_SUBJECT_KIND_NAMES)[number];
|
|
8147
6579
|
/**
|
|
8148
6580
|
* What a user turn was, as the session classifier labels it. The same
|
|
8149
6581
|
* vocabulary the classifier writes; a `turns` search may keep only some.
|
|
@@ -8198,7 +6630,7 @@ export declare const SearchRequestObjectSchema: v.ObjectSchema<{
|
|
|
8198
6630
|
* Restrict the `comments` corpus to comments on these kinds of subject. Does
|
|
8199
6631
|
* not touch other corpora.
|
|
8200
6632
|
*/
|
|
8201
|
-
readonly subjectKinds: v.OptionalSchema<v.SchemaWithPipe<readonly [v.ArraySchema<v.PicklistSchema<readonly ["
|
|
6633
|
+
readonly subjectKinds: v.OptionalSchema<v.SchemaWithPipe<readonly [v.ArraySchema<v.PicklistSchema<readonly ["artifact", "session"], undefined>, undefined>, v.MinLengthAction<("artifact" | "session")[], 1, undefined>]>, undefined>;
|
|
8202
6634
|
/**
|
|
8203
6635
|
* Restrict the `turns` corpus to turns the classifier gave one of these
|
|
8204
6636
|
* labels. A turn with no label never matches. Does not touch other corpora.
|
|
@@ -8268,7 +6700,7 @@ export declare const SearchRequestSchema: v.SchemaWithPipe<readonly [v.ObjectSch
|
|
|
8268
6700
|
* Restrict the `comments` corpus to comments on these kinds of subject. Does
|
|
8269
6701
|
* not touch other corpora.
|
|
8270
6702
|
*/
|
|
8271
|
-
readonly subjectKinds: v.OptionalSchema<v.SchemaWithPipe<readonly [v.ArraySchema<v.PicklistSchema<readonly ["
|
|
6703
|
+
readonly subjectKinds: v.OptionalSchema<v.SchemaWithPipe<readonly [v.ArraySchema<v.PicklistSchema<readonly ["artifact", "session"], undefined>, undefined>, v.MinLengthAction<("artifact" | "session")[], 1, undefined>]>, undefined>;
|
|
8272
6704
|
/**
|
|
8273
6705
|
* Restrict the `turns` corpus to turns the classifier gave one of these
|
|
8274
6706
|
* labels. A turn with no label never matches. Does not touch other corpora.
|
|
@@ -8303,7 +6735,7 @@ export declare const SearchRequestSchema: v.SchemaWithPipe<readonly [v.ObjectSch
|
|
|
8303
6735
|
[x: string]: string;
|
|
8304
6736
|
} | undefined;
|
|
8305
6737
|
authorKinds?: ("agent" | "person" | "mossbear")[] | undefined;
|
|
8306
|
-
subjectKinds?: ("
|
|
6738
|
+
subjectKinds?: ("artifact" | "session")[] | undefined;
|
|
8307
6739
|
steeringLabels?: ("correction" | "steering" | "new request" | "acknowledgement" | "insufficient evidence")[] | undefined;
|
|
8308
6740
|
headSha?: string | undefined;
|
|
8309
6741
|
branch?: string | undefined;
|
|
@@ -8320,7 +6752,7 @@ export declare const SearchRequestSchema: v.SchemaWithPipe<readonly [v.ObjectSch
|
|
|
8320
6752
|
[x: string]: string;
|
|
8321
6753
|
} | undefined;
|
|
8322
6754
|
authorKinds?: ("agent" | "person" | "mossbear")[] | undefined;
|
|
8323
|
-
subjectKinds?: ("
|
|
6755
|
+
subjectKinds?: ("artifact" | "session")[] | undefined;
|
|
8324
6756
|
steeringLabels?: ("correction" | "steering" | "new request" | "acknowledgement" | "insufficient evidence")[] | undefined;
|
|
8325
6757
|
headSha?: string | undefined;
|
|
8326
6758
|
branch?: string | undefined;
|
|
@@ -8337,7 +6769,7 @@ export declare const SearchRequestSchema: v.SchemaWithPipe<readonly [v.ObjectSch
|
|
|
8337
6769
|
[x: string]: string;
|
|
8338
6770
|
} | undefined;
|
|
8339
6771
|
authorKinds?: ("agent" | "person" | "mossbear")[] | undefined;
|
|
8340
|
-
subjectKinds?: ("
|
|
6772
|
+
subjectKinds?: ("artifact" | "session")[] | undefined;
|
|
8341
6773
|
steeringLabels?: ("correction" | "steering" | "new request" | "acknowledgement" | "insufficient evidence")[] | undefined;
|
|
8342
6774
|
headSha?: string | undefined;
|
|
8343
6775
|
branch?: string | undefined;
|
|
@@ -8354,7 +6786,7 @@ export declare const SearchRequestSchema: v.SchemaWithPipe<readonly [v.ObjectSch
|
|
|
8354
6786
|
[x: string]: string;
|
|
8355
6787
|
} | undefined;
|
|
8356
6788
|
authorKinds?: ("agent" | "person" | "mossbear")[] | undefined;
|
|
8357
|
-
subjectKinds?: ("
|
|
6789
|
+
subjectKinds?: ("artifact" | "session")[] | undefined;
|
|
8358
6790
|
steeringLabels?: ("correction" | "steering" | "new request" | "acknowledgement" | "insufficient evidence")[] | undefined;
|
|
8359
6791
|
headSha?: string | undefined;
|
|
8360
6792
|
branch?: string | undefined;
|
|
@@ -8371,7 +6803,7 @@ export declare const SearchRequestSchema: v.SchemaWithPipe<readonly [v.ObjectSch
|
|
|
8371
6803
|
[x: string]: string;
|
|
8372
6804
|
} | undefined;
|
|
8373
6805
|
authorKinds?: ("agent" | "person" | "mossbear")[] | undefined;
|
|
8374
|
-
subjectKinds?: ("
|
|
6806
|
+
subjectKinds?: ("artifact" | "session")[] | undefined;
|
|
8375
6807
|
steeringLabels?: ("correction" | "steering" | "new request" | "acknowledgement" | "insufficient evidence")[] | undefined;
|
|
8376
6808
|
headSha?: string | undefined;
|
|
8377
6809
|
branch?: string | undefined;
|
|
@@ -8388,7 +6820,7 @@ export declare const SearchRequestSchema: v.SchemaWithPipe<readonly [v.ObjectSch
|
|
|
8388
6820
|
[x: string]: string;
|
|
8389
6821
|
} | undefined;
|
|
8390
6822
|
authorKinds?: ("agent" | "person" | "mossbear")[] | undefined;
|
|
8391
|
-
subjectKinds?: ("
|
|
6823
|
+
subjectKinds?: ("artifact" | "session")[] | undefined;
|
|
8392
6824
|
steeringLabels?: ("correction" | "steering" | "new request" | "acknowledgement" | "insufficient evidence")[] | undefined;
|
|
8393
6825
|
headSha?: string | undefined;
|
|
8394
6826
|
branch?: string | undefined;
|
|
@@ -8482,8 +6914,8 @@ export type SearchContentHit = v.InferOutput<typeof SearchContentHitSchema>;
|
|
|
8482
6914
|
* A comment on a guide or document that matched. `body` and `itemName` and
|
|
8483
6915
|
* `workspaceName` are wrapped in `untrusted`'s markers.
|
|
8484
6916
|
*/
|
|
8485
|
-
export declare const
|
|
8486
|
-
readonly subjectKind: v.LiteralSchema<"
|
|
6917
|
+
export declare const SearchArtifactCommentHitSchema: v.ObjectSchema<{
|
|
6918
|
+
readonly subjectKind: v.LiteralSchema<"artifact", undefined>;
|
|
8487
6919
|
readonly itemId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
8488
6920
|
/**
|
|
8489
6921
|
* The guide the item belongs to, or null for a standalone document. A comment
|
|
@@ -8533,44 +6965,6 @@ export declare const SearchSessionCommentHitSchema: v.ObjectSchema<{
|
|
|
8533
6965
|
readonly url: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
|
|
8534
6966
|
readonly excerpt: v.StringSchema<undefined>;
|
|
8535
6967
|
}, 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
6968
|
export declare const SearchCommentHitSchema: v.VariantSchema<"subjectKind", [v.ObjectSchema<{
|
|
8575
6969
|
readonly subjectKind: v.LiteralSchema<"artifact", undefined>;
|
|
8576
6970
|
readonly itemId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
@@ -8604,39 +6998,6 @@ export declare const SearchCommentHitSchema: v.VariantSchema<"subjectKind", [v.O
|
|
|
8604
6998
|
readonly createdAt: v.StringSchema<undefined>;
|
|
8605
6999
|
readonly url: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
|
|
8606
7000
|
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
7001
|
}, undefined>, v.ObjectSchema<{
|
|
8641
7002
|
readonly subjectKind: v.LiteralSchema<"session", undefined>;
|
|
8642
7003
|
readonly sessionId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
@@ -8649,7 +7010,7 @@ export declare const SearchCommentHitSchema: v.VariantSchema<"subjectKind", [v.O
|
|
|
8649
7010
|
readonly url: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
|
|
8650
7011
|
readonly excerpt: v.StringSchema<undefined>;
|
|
8651
7012
|
}, undefined>], undefined>;
|
|
8652
|
-
export type
|
|
7013
|
+
export type SearchArtifactCommentHit = v.InferOutput<typeof SearchArtifactCommentHitSchema>;
|
|
8653
7014
|
export type SearchSessionCommentHit = v.InferOutput<typeof SearchSessionCommentHitSchema>;
|
|
8654
7015
|
export type SearchCommentHit = v.InferOutput<typeof SearchCommentHitSchema>;
|
|
8655
7016
|
/**
|
|
@@ -8796,65 +7157,32 @@ export declare const SearchContentReportSchema: v.VariantSchema<"status", [v.Obj
|
|
|
8796
7157
|
/** Wrapped in `untrusted`'s markers. */
|
|
8797
7158
|
readonly workspaceName: v.StringSchema<undefined>;
|
|
8798
7159
|
/**
|
|
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).
|
|
7160
|
+
* Slugs of the bundles that hold the item and that the caller may read — the
|
|
7161
|
+
* argument `pull_bundle` takes to read the whole document. Never more than
|
|
7162
|
+
* a scoped caller's allowlist reaches.
|
|
8842
7163
|
*/
|
|
8843
|
-
readonly
|
|
7164
|
+
readonly bundles: v.ArraySchema<v.StringSchema<undefined>, undefined>;
|
|
7165
|
+
readonly updatedAt: v.StringSchema<undefined>;
|
|
8844
7166
|
/**
|
|
8845
|
-
*
|
|
8846
|
-
*
|
|
7167
|
+
* Where the item opens on the dashboard. Added by the CLI, which knows the
|
|
7168
|
+
* dashboard's address; the server does not send it.
|
|
8847
7169
|
*/
|
|
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
7170
|
readonly url: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
|
|
7171
|
+
/** A window around the match, wrapped in `untrusted`'s markers. */
|
|
8855
7172
|
readonly excerpt: v.StringSchema<undefined>;
|
|
8856
|
-
}, undefined>,
|
|
8857
|
-
|
|
7173
|
+
}, undefined>, undefined>;
|
|
7174
|
+
}, undefined>, v.ObjectSchema<{
|
|
7175
|
+
readonly status: v.LiteralSchema<"skipped", undefined>;
|
|
7176
|
+
readonly reason: v.PicklistSchema<["excluded-by-caller", "timed-out", "not-granted", "not-yet-searchable"], undefined>;
|
|
7177
|
+
}, undefined>], undefined>;
|
|
7178
|
+
export declare const SearchCommentsReportSchema: v.VariantSchema<"status", [v.ObjectSchema<{
|
|
7179
|
+
readonly status: v.LiteralSchema<"searched", undefined>;
|
|
7180
|
+
/** Every match in scope, counted past the returned page. */
|
|
7181
|
+
readonly total: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
|
|
7182
|
+
readonly narrowedBy: v.NullableSchema<v.PicklistSchema<["narrowed-by-bundle-allowlist"], undefined>, undefined>;
|
|
7183
|
+
/** Newest first, at most the request's limit. */
|
|
7184
|
+
readonly hits: v.ArraySchema<v.VariantSchema<"subjectKind", [v.ObjectSchema<{
|
|
7185
|
+
readonly subjectKind: v.LiteralSchema<"artifact", undefined>;
|
|
8858
7186
|
readonly itemId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
8859
7187
|
/**
|
|
8860
7188
|
* The guide the item belongs to, or null for a standalone document. A comment
|
|
@@ -9128,39 +7456,6 @@ export declare const SearchResponseSchema: v.ObjectSchema<{
|
|
|
9128
7456
|
readonly createdAt: v.StringSchema<undefined>;
|
|
9129
7457
|
readonly url: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
|
|
9130
7458
|
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
7459
|
}, undefined>, v.ObjectSchema<{
|
|
9165
7460
|
readonly subjectKind: v.LiteralSchema<"session", undefined>;
|
|
9166
7461
|
readonly sessionId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
@@ -9351,371 +7646,93 @@ export declare function parseWorkspaceListResponse(data: unknown): {
|
|
|
9351
7646
|
workspaces: {
|
|
9352
7647
|
id: string;
|
|
9353
7648
|
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;
|
|
7649
|
+
slug: string;
|
|
7650
|
+
role: string;
|
|
7651
|
+
isDefault: boolean;
|
|
7652
|
+
}[];
|
|
7653
|
+
};
|
|
7654
|
+
export declare function parseCreateScopedTokenRequest(data: unknown): {
|
|
7655
|
+
label: string;
|
|
7656
|
+
grants: {
|
|
7657
|
+
bundleId: string;
|
|
7658
|
+
access: "read" | "write";
|
|
9549
7659
|
}[];
|
|
9550
|
-
untrusted?: {
|
|
9551
|
-
token: string;
|
|
9552
|
-
startMarker: string;
|
|
9553
|
-
endMarker: string;
|
|
9554
|
-
note: string;
|
|
9555
|
-
} | null | undefined;
|
|
9556
7660
|
};
|
|
9557
|
-
export declare function
|
|
7661
|
+
export declare function parseRevokeScopedTokenRequest(data: unknown): {
|
|
7662
|
+
id: string;
|
|
7663
|
+
};
|
|
7664
|
+
export declare function parseCreateBundleRequest(data: unknown): {
|
|
7665
|
+
slug: string;
|
|
9558
7666
|
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
7667
|
};
|
|
9572
|
-
export declare function
|
|
9573
|
-
|
|
9574
|
-
type: string;
|
|
7668
|
+
export declare function parseCreateBundleResponse(data: unknown): {
|
|
7669
|
+
bundle: {
|
|
9575
7670
|
id: string;
|
|
9576
|
-
|
|
7671
|
+
slug: string;
|
|
9577
7672
|
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;
|
|
7673
|
+
createdAt: string;
|
|
7674
|
+
home?: string | undefined;
|
|
9627
7675
|
};
|
|
7676
|
+
};
|
|
7677
|
+
export declare function parseAttachBundleMemberRequest(data: unknown): {
|
|
7678
|
+
artifactId: string;
|
|
7679
|
+
};
|
|
7680
|
+
export declare function parseAttachBundleMemberResponse(data: unknown): {
|
|
7681
|
+
attached: boolean;
|
|
7682
|
+
};
|
|
7683
|
+
export declare function parseDetachBundleMemberResponse(data: unknown): {
|
|
7684
|
+
detached: boolean;
|
|
7685
|
+
};
|
|
7686
|
+
export declare function parseSubscribeBundleRequest(data: unknown): {
|
|
7687
|
+
bundleId: string;
|
|
7688
|
+
deliver?: "global" | "repo" | null | undefined;
|
|
7689
|
+
muted?: string[] | undefined;
|
|
7690
|
+
};
|
|
7691
|
+
export declare function parseSubscribeBundleResponse(data: unknown): {
|
|
7692
|
+
bundleId: string;
|
|
9628
7693
|
created: boolean;
|
|
7694
|
+
deliver?: "global" | "repo" | undefined;
|
|
7695
|
+
muted?: string[] | undefined;
|
|
9629
7696
|
};
|
|
9630
|
-
export declare function
|
|
9631
|
-
|
|
9632
|
-
|
|
9633
|
-
|
|
9634
|
-
|
|
9635
|
-
|
|
9636
|
-
|
|
9637
|
-
|
|
9638
|
-
|
|
9639
|
-
|
|
9640
|
-
|
|
9641
|
-
|
|
7697
|
+
export declare function parseResolveSubscriptionsRequest(data: unknown): {
|
|
7698
|
+
repoBundleIds: string[];
|
|
7699
|
+
};
|
|
7700
|
+
export declare function parseResolveSubscriptionsResponse(data: unknown): {
|
|
7701
|
+
bundles: {
|
|
7702
|
+
id: string;
|
|
7703
|
+
slug: string;
|
|
7704
|
+
name: string;
|
|
7705
|
+
scopes: ("repo" | "user")[];
|
|
7706
|
+
deliver?: "global" | "repo" | undefined;
|
|
7707
|
+
home?: string | undefined;
|
|
7708
|
+
muted?: string[] | undefined;
|
|
7709
|
+
}[];
|
|
7710
|
+
unresolved: {
|
|
7711
|
+
id: string;
|
|
7712
|
+
}[];
|
|
7713
|
+
account?: {
|
|
7714
|
+
deliverGlobalSkills: boolean;
|
|
9642
7715
|
} | undefined;
|
|
9643
|
-
|
|
7716
|
+
limitedToken?: boolean | undefined;
|
|
9644
7717
|
};
|
|
9645
|
-
export declare function
|
|
9646
|
-
|
|
9647
|
-
|
|
7718
|
+
export declare function parseUpdateBundleRequest(data: unknown): {
|
|
7719
|
+
name?: string | undefined;
|
|
7720
|
+
home?: string | null | undefined;
|
|
7721
|
+
};
|
|
7722
|
+
export declare function parseUpdateBundleResponse(data: unknown): {
|
|
7723
|
+
bundle: {
|
|
9648
7724
|
id: string;
|
|
9649
|
-
|
|
7725
|
+
slug: string;
|
|
9650
7726
|
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;
|
|
7727
|
+
createdAt: string;
|
|
7728
|
+
home?: string | undefined;
|
|
9700
7729
|
};
|
|
9701
|
-
updated: boolean;
|
|
9702
7730
|
};
|
|
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;
|
|
7731
|
+
export declare function parseDeleteBundleResponse(data: unknown): {
|
|
7732
|
+
deleted: boolean;
|
|
9716
7733
|
};
|
|
9717
|
-
export declare function
|
|
9718
|
-
|
|
7734
|
+
export declare function parseContextItemsResponse(data: unknown): {
|
|
7735
|
+
items: {
|
|
9719
7736
|
type: string;
|
|
9720
7737
|
id: string;
|
|
9721
7738
|
artifactId?: string | null | undefined;
|
|
@@ -9769,11 +7786,16 @@ export declare function parseContextItemResponse(data: unknown): {
|
|
|
9769
7786
|
branch?: string | undefined;
|
|
9770
7787
|
} | null | undefined;
|
|
9771
7788
|
removed?: true | undefined;
|
|
9772
|
-
};
|
|
7789
|
+
}[];
|
|
7790
|
+
untrusted?: {
|
|
7791
|
+
token: string;
|
|
7792
|
+
startMarker: string;
|
|
7793
|
+
endMarker: string;
|
|
7794
|
+
note: string;
|
|
7795
|
+
} | null | undefined;
|
|
9773
7796
|
};
|
|
9774
|
-
export declare function
|
|
9775
|
-
|
|
9776
|
-
item: {
|
|
7797
|
+
export declare function parseBundleArtifactsResponse(data: unknown): {
|
|
7798
|
+
artifacts: {
|
|
9777
7799
|
type: string;
|
|
9778
7800
|
id: string;
|
|
9779
7801
|
artifactId?: string | null | undefined;
|
|
@@ -9827,7 +7849,13 @@ export declare function parseArchiveContextItemResponse(data: unknown): {
|
|
|
9827
7849
|
branch?: string | undefined;
|
|
9828
7850
|
} | null | undefined;
|
|
9829
7851
|
removed?: true | undefined;
|
|
9830
|
-
};
|
|
7852
|
+
}[];
|
|
7853
|
+
untrusted?: {
|
|
7854
|
+
token: string;
|
|
7855
|
+
startMarker: string;
|
|
7856
|
+
endMarker: string;
|
|
7857
|
+
note: string;
|
|
7858
|
+
} | null | undefined;
|
|
9831
7859
|
};
|
|
9832
7860
|
export declare function parseInboxCaptureRequest(data: unknown): {
|
|
9833
7861
|
id?: string | undefined;
|
|
@@ -9865,7 +7893,7 @@ export declare function parseInboxListResponse(data: unknown): {
|
|
|
9865
7893
|
updatedAt: string;
|
|
9866
7894
|
}[];
|
|
9867
7895
|
};
|
|
9868
|
-
export declare function
|
|
7896
|
+
export declare function parseBundleArtifactVersionsResponse(data: unknown): {
|
|
9869
7897
|
versions: {
|
|
9870
7898
|
id: string;
|
|
9871
7899
|
version: number;
|
|
@@ -9878,19 +7906,6 @@ export declare function parseContextItemVersionsResponse(data: unknown): {
|
|
|
9878
7906
|
}[];
|
|
9879
7907
|
nextCursor: number | null;
|
|
9880
7908
|
};
|
|
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
7909
|
export declare function parseInboxArchiveRequest(data: unknown): {
|
|
9895
7910
|
ids: string[];
|
|
9896
7911
|
};
|
|
@@ -10149,7 +8164,7 @@ export declare function parseAgentCommentResponse(data: unknown): {
|
|
|
10149
8164
|
id: string;
|
|
10150
8165
|
threadId: string;
|
|
10151
8166
|
subject: {
|
|
10152
|
-
kind: "
|
|
8167
|
+
kind: "artifact" | "session";
|
|
10153
8168
|
id: string;
|
|
10154
8169
|
};
|
|
10155
8170
|
body: string;
|
|
@@ -10386,23 +8401,6 @@ export declare function parseSearchResponse(data: unknown): {
|
|
|
10386
8401
|
total: number;
|
|
10387
8402
|
narrowedBy: "narrowed-by-bundle-allowlist" | null;
|
|
10388
8403
|
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
8404
|
subjectKind: "artifact";
|
|
10407
8405
|
itemId: string;
|
|
10408
8406
|
guideId: string | null;
|