@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/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
- export declare const AttachBundleMemberRequestSchema: v.ObjectSchema<{
928
- readonly itemId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
929
- }, undefined>;
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
- * How many bundles one comments read may name.
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 AgentCommentResponseSchema: v.ObjectSchema<{
2203
- readonly created: v.BooleanSchema<undefined>;
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
- * A suggested edit: the replacement for the passage at `passage.lines`,
2347
- * already wrapped in the response's untrusted markers like `body`. An
2348
- * insertion is the passage plus its new lines and an empty replacement is a
2349
- * deletion, so every edit is one replace. Absent on an ordinary comment.
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 suggestion: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
2082
+ readonly artifactId: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
2352
2083
  /**
2353
- * What a comment Mossbear wrote is: a finding about the item, never an edit.
2354
- * Present only on a Mossbear comment. The comment's `body` begins with the
2355
- * claim (what goes wrong); this carries what the claim rests on.
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 finding: v.OptionalSchema<v.ObjectSchema<{
2358
- readonly tier: v.PicklistSchema<["observed", "usage", "practice"], undefined>;
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
- * Whether the person approved a comment Mossbear drafted. Present on every
2368
- * Mossbear comment and absent on a person's or an agent's, which are
2369
- * requests as written. `false` is a draft nobody has read yet: a reader shows
2370
- * it to the user and acts only on their go-ahead. Only a client that reports
2371
- * a version able to mark drafts is ever listed one, so an older reader that
2372
- * strips this field never receives a draft it would print as a request.
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 approved: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
2375
- /** The author's display name as the workspace shows it, or null. Never an email. */
2376
- readonly authorName: v.NullableSchema<v.StringSchema<undefined>, undefined>;
2377
- /** ISO timestamp, machine format. */
2378
- readonly createdAt: v.StringSchema<undefined>;
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
- * How many agent reads were handed this comment **before** this one — so a
2385
- * comment reaching an agent for the first time reports `0`.
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
- * It is the stored count as it read at the moment the response was built;
2388
- * the serve this response *is* has not been counted yet. Excluded rather
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
- * So `deliveredCount > 0` means an earlier read was handed this comment, and
2395
- * `0` means this read is the first. Neither says a model took it in — only
2396
- * that the server handed it over.
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 deliveredCount: v.NumberSchema<undefined>;
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
- * This comment's thread root — its own id for every delivered root. Resolution
2401
- * replies remain on the dashboard thread and are not delivered to agents.
2402
- * It is on the wire from the first response
2403
- * because the wire contract is consumed by installed CLI versions: reshaping
2404
- * a flat `comments` array into threads-of-comments later would be a breaking
2405
- * change, while a field today's readers ignore costs them nothing.
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 threadId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
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
- * Always `null` for a delivered root. Present so an older reader meeting a
2410
- * future response that carries real replies degrades to
2411
- * "a flat list of comments" rather than failing to parse.
2412
- */
2413
- readonly replyToId: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>;
2414
- }, undefined>, undefined>;
2415
- readonly cursor: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
2416
- /**
2417
- * The markers every `body` above is wrapped in, plus a statement of what
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 created: v.BooleanSchema<undefined>;
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
- export declare const UpdateContextItemRequestSchema: v.ObjectSchema<{
3070
- readonly itemId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
3071
- readonly name: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 200, undefined>]>, undefined>;
3072
- readonly content: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.CheckAction<string, "content must be at most 524288 bytes">]>, undefined>;
3073
- readonly expectedVersion: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>, undefined>;
3074
- /**
3075
- * The committed `project.id` of the checkout this write comes from — same
3076
- * meaning and same two uses as on `PushContextRequestSchema`: a bundle that
3077
- * claims a home accepts writes only from that repo, and a request declaring
3078
- * nothing is not it; and when this update sets `path`, it is stored as the
3079
- * repo that path is placed in. Parsed as on `PushContextRequestSchema`.
3080
- */
3081
- readonly projectId: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>]>, undefined>;
3082
- /**
3083
- * Move the document: its new placement, or `null` to take the placement away
3084
- * so it lands in the bundle folder again.
3085
- *
3086
- * **Three states, the same shape `sourceItemIds` takes.** Omitted leaves the
3087
- * stored path and its home alone — every name or body edit. A path replaces
3088
- * both: the path, and the home as `projectId` above declares it, since a path
3089
- * is relative to the repo that declared it. `null` clears both.
3090
- *
3091
- * The same schema as the create side and the read side, for the reason
3092
- * `PushContextRequestSchema` gives, and the same refusals in the routes —
3093
- * agent guidance, Mossbear's state directory, git's.
3094
- *
3095
- * **Documents only.** A guide's path is its discovery path, which import
3096
- * reconciles on; moving it here would fork it from the file it came from, so
3097
- * the routes refuse it on a guide by name. A git-published artifact cannot
3098
- * drop its path either, because the published-source group is only legal
3099
- * beside one.
3100
- */
3101
- 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>;
3102
- 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>;
3103
- /**
3104
- * The revision this update's bytes were read from — same meaning as on
3105
- * `PushContextRequestSchema` above, and the field that makes a republication
3106
- * advance an artifact's provenance rather than leave it pointing at the
3107
- * commit it was first published from.
3108
- *
3109
- * **Omitted leaves the stored group alone; it never clears it.** An update
3110
- * that says nothing about provenance is a name or body edit, not a claim that
3111
- * the artifact stopped being git-owned — and an absent key that silently
3112
- * un-owned a row would hand a subscriber write access by omission, which is
3113
- * the failure the whole ownership model exists to prevent. Ownership is given
3114
- * up by promotion, not by a missing field.
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
- * Tombstone this artifact: the commit that published it has since deleted the
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
- * **A verb, not a column state**, the same shape the dashboard's own removal
3138
- * takes (`~/zero/mutators.ts` → `guideFiles.update`'s `removed`). There is no
3139
- * writable field here that a removal and an ordinary edit could disagree
3140
- * about, and `literal(true)` is what keeps `removed: false` from reading as a
3141
- * request to bring something back — un-removing is republishing, which is an
3142
- * ordinary content write.
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
- * **`gitSource` is required alongside it and the route enforces that.** A
3145
- * tombstone's whole claim is *which revision removed the file*: without one
3146
- * the row would say an artifact stopped being delivered and be unable to say
3147
- * why, which is the silent withdrawal this field exists to replace. That also
3148
- * keeps the only writer of a removal here the publication path — this is not
3149
- * a general delete verb for the context layer.
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
- * **Never sent with `content`.** A removal has no bytes; a body carrying both
3152
- * is two answers to one question and the route refuses it rather than picking.
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 removed: v.OptionalSchema<v.LiteralSchema<true, undefined>, undefined>;
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 declare const UpdateContextItemResponseSchema: v.ObjectSchema<{
3157
- readonly item: v.SchemaWithPipe<readonly [v.ObjectSchema<{
3158
- readonly id: v.StringSchema<undefined>;
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
- * The id every artifact route addresses: the body file's id for a guide
3161
- * (null only for a guide with no body yet), the item's own id otherwise.
3162
- * Optional so a client tolerates a server that predates it, and one that
3163
- * stops sending it (the item id is the artifact id).
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 artifactId: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
2748
+ readonly suggestion: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
3166
2749
  /**
3167
- * Leaving the wire: a reader tells a guide from content by `role` and the
3168
- * guide fields, not by this. Optional so a client parses a server that no
3169
- * longer sends it.
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 type: v.OptionalSchema<v.PicklistSchema<string[], undefined>, undefined>;
3172
- readonly name: v.StringSchema<undefined>;
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
- * The stored `(role, format)` pair, as two bare nullable strings.
3175
- *
3176
- * **Both are deliberately unenumerated.** A client switches on one value it
3177
- * cares about — `role === 'criteria'` is how a rubric is told from ordinary
3178
- * prose, which `type` cannot say because a rubric serializes as a `document` —
3179
- * and a server that adds a fourth role or a fifth format must not break a
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 role: v.NullableSchema<v.StringSchema<undefined>, undefined>;
3188
- readonly format: v.NullableSchema<v.StringSchema<undefined>, undefined>;
3189
- readonly content: v.NullableSchema<v.StringSchema<undefined>, undefined>;
3190
- readonly origin: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
3191
- readonly version: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
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
- * The guide a **derived** item belongs to — its evaluation criteria, or a
3194
- * skill's member files (`subscription-delivery-target-plan.md` → slice 4).
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
- * Absent on everything else, including a guide itself: a guide member is
3197
- * addressed by the guide's own id, so `id` already answers this for it.
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
- * It exists because derived items have no bundle membership and no id of their
3200
- * guide's — they are `guide_files` rows attached by `guide_id` — so a rule
3201
- * expressed over guide ids (a subscriber's mute) cannot reach them from the
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 guideId: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
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
- * The repo a **document's** declared `path` is placed in — its home — as the
3211
- * `project.id` of the checkout that last set the path. Documents only.
3212
- *
3213
- * Deliberately not `projectId` above: a reader takes a mismatch there as "this
3214
- * item belongs to another repo, do not materialize it", so a home echoed on it
3215
- * would stop every other subscriber receiving the document at all. A home says
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 pathProjectId: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
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
- * Open comments a person left about this item, newest first.
3235
- *
3236
- * Optional, and absent rather than empty when there are none — the same rule
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 comments: v.OptionalSchema<v.SchemaWithPipe<readonly [v.ArraySchema<v.ObjectSchema<{
3245
- readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
3246
- readonly state: v.OptionalSchema<v.PicklistSchema<["open", "resolved"], undefined>, undefined>;
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
- * Move the document: its new placement, or `null` to take the placement away
3549
- * so it lands in the bundle folder again.
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 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>;
3567
- 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>;
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
- * The revision this update's bytes were read from — same meaning as on
3570
- * `PushContextRequestSchema` above, and the field that makes a republication
3571
- * advance an artifact's provenance rather than leave it pointing at the
3572
- * commit it was first published from.
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 gitSource: v.OptionalSchema<v.ObjectSchema<{
3582
- /**
3583
- * The committed `project.id` of the source repository — the same id space as
3584
- * an item's delivery-scoping `projectId` below, but a different fact: that one
3585
- * says which repo an item is materialized into and is stamped onto
3586
- * Mossbear-owned rows too, this one says who may edit it.
3587
- */
3588
- 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">]>;
3589
- readonly commitSha: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "commitSha must be 40 or 64 lowercase hex characters">]>;
3590
- /**
3591
- * The branch the publishing commit was on. **The one optional member**:
3592
- * publication is not restricted by branch, so this is recorded so a subscriber
3593
- * can see what they got, and a detached HEAD has none to record.
3594
- */
3595
- readonly branch: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 255, undefined>]>, undefined>;
3596
- }, undefined>, undefined>;
3597
- /**
3598
- * Tombstone this artifact: the commit that published it has since deleted the
3599
- * file, so the revision stops being delivered while the row and its version
3600
- * history stay where they are.
3601
- *
3602
- * **A verb, not a column state**, the same shape the dashboard's own removal
3603
- * takes (`~/zero/mutators.ts` → `guideFiles.update`'s `removed`). There is no
3604
- * writable field here that a removal and an ordinary edit could disagree
3605
- * about, and `literal(true)` is what keeps `removed: false` from reading as a
3606
- * request to bring something back — un-removing is republishing, which is an
3607
- * ordinary content write.
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
- * The stored `(role, format)` pair, as two bare nullable strings.
3801
- *
3802
- * **Both are deliberately unenumerated.** A client switches on one value it
3803
- * cares about — `role === 'criteria'` is how a rubric is told from ordinary
3804
- * prose, which `type` cannot say because a rubric serializes as a `document` —
3805
- * and a server that adds a fourth role or a fifth format must not break a
3806
- * client that has never heard of it. Narrowing them here would make every such
3807
- * addition a breaking wire change for no reader's benefit.
3808
- *
3809
- * Null on exactly the rows that carry no content: a tombstone, and an alias.
3810
- * A `guide` item has no pair at all — it is a different table — and reports
3811
- * both as null.
3812
- */
3813
- readonly role: v.NullableSchema<v.StringSchema<undefined>, undefined>;
3814
- readonly format: v.NullableSchema<v.StringSchema<undefined>, undefined>;
3815
- readonly content: v.NullableSchema<v.StringSchema<undefined>, undefined>;
3816
- readonly origin: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
3817
- readonly version: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
3818
- /**
3819
- * The guide a **derived** item belongs to — its evaluation criteria, or a
3820
- * skill's member files (`subscription-delivery-target-plan.md` → slice 4).
3821
- *
3822
- * Absent on everything else, including a guide itself: a guide member is
3823
- * addressed by the guide's own id, so `id` already answers this for it.
3824
- *
3825
- * It exists because derived items have no bundle membership and no id of their
3826
- * guide's — they are `guide_files` rows attached by `guide_id` — so a rule
3827
- * expressed over guide ids (a subscriber's mute) cannot reach them from the
3828
- * item alone. Muting a skill and still delivering its `scripts/` would leave a
3829
- * broken half-skill on disk, which is worse than not muting at all.
3830
- */
3831
- readonly guideId: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
3832
- readonly root: v.OptionalSchema<v.NullableSchema<v.PicklistSchema<["project", "global"], undefined>, undefined>, undefined>;
3833
- 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>;
3834
- readonly projectId: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
3835
- /**
3836
- * The repo a **document's** declared `path` is placed in — its home — as the
3837
- * `project.id` of the checkout that last set the path. Documents only.
3838
- *
3839
- * Deliberately not `projectId` above: a reader takes a mismatch there as "this
3840
- * item belongs to another repo, do not materialize it", so a home echoed on it
3841
- * would stop every other subscriber receiving the document at all. A home says
3842
- * only *where* the path is literal. Only the repo whose `project.id` matches
3843
- * writes the document at `path`; every other repo mirrors it under the
3844
- * bundle folder (`bundleMirrorPath` in `@mossbear/projections`).
3845
- *
3846
- * Absent and null read the same — **no home**, so no repo takes the path
3847
- * literally for a new placement. A server predating the field says the same,
3848
- * which is the safe direction: the file lands inside the bundle folder
3849
- * instead of at a repo path it may not belong in.
3850
- */
3851
- readonly pathProjectId: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
3852
- readonly aliases: v.OptionalSchema<v.SchemaWithPipe<readonly [v.ArraySchema<v.ObjectSchema<{
3853
- readonly root: v.PicklistSchema<["project", "global"], undefined>;
3854
- 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">]>;
3855
- }, undefined>, undefined>, v.MaxLengthAction<{
3856
- root: "project" | "global";
3857
- path: string;
3858
- }[], 8, undefined>]>, undefined>;
3859
- /**
3860
- * Open comments a person left about this item, newest first.
3861
- *
3862
- * Optional, and absent rather than empty when there are none — the same rule
3863
- * `aliases` and `projectId` follow above, and for the same reason: an older
3864
- * reader against a newer server ignores the key, and a newer reader against
3865
- * an older server reads "no comments" instead of failing.
3866
- *
3867
- * **Absence is not a verdict.** No comments here means none were served on this
3868
- * item in this response — not that nobody has anything to say about it.
3869
- */
3870
- readonly comments: v.OptionalSchema<v.SchemaWithPipe<readonly [v.ArraySchema<v.ObjectSchema<{
3871
- readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
3872
- readonly state: v.OptionalSchema<v.PicklistSchema<["open", "resolved"], undefined>, undefined>;
3873
- /** Current source location of an anchored passage, or its lost quote. */
3874
- readonly passage: v.OptionalSchema<v.ObjectSchema<{
3875
- readonly quote: v.StringSchema<undefined>;
3876
- readonly status: v.PicklistSchema<["located", "changed", "orphaned"], undefined>;
3877
- readonly lines: v.NullableSchema<v.ObjectSchema<{
3878
- readonly start: v.NumberSchema<undefined>;
3879
- readonly end: v.NumberSchema<undefined>;
3880
- }, undefined>, undefined>;
3881
- }, undefined>, undefined>;
3882
- /** The comment's text, already wrapped in the response's untrusted markers. */
3883
- readonly body: v.StringSchema<undefined>;
3884
- /**
3885
- * A suggested edit: the replacement for the passage at `passage.lines`,
3886
- * already wrapped in the response's untrusted markers like `body`. An
3887
- * insertion is the passage plus its new lines and an empty replacement is a
3888
- * deletion, so every edit is one replace. Absent on an ordinary comment.
3889
- */
3890
- readonly suggestion: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
3891
- /**
3892
- * What a comment Mossbear wrote is: a finding about the item, never an edit.
3893
- * Present only on a Mossbear comment. The comment's `body` begins with the
3894
- * claim (what goes wrong); this carries what the claim rests on.
3895
- */
3896
- readonly finding: v.OptionalSchema<v.ObjectSchema<{
3897
- readonly tier: v.PicklistSchema<["observed", "usage", "practice"], undefined>;
3898
- /** How the finding is known, in one line: "Seen in 3 sessions (2026-09-15 – 2026-10-03)". */
3899
- readonly tierLine: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 300, undefined>]>;
3900
- /** What the drafter did not read, fixed per tier. */
3901
- readonly blindSpot: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 300, undefined>]>;
3902
- /** What should change in later sessions if the finding is fixed, wrapped in the untrusted markers. */
3903
- readonly prediction: v.NullableSchema<v.StringSchema<undefined>, undefined>;
3904
- }, undefined>, undefined>;
3905
- /**
3906
- * Whether the person approved a comment Mossbear drafted. Present on every
3907
- * Mossbear comment and absent on a person's or an agent's, which are
3908
- * requests as written. `false` is a draft nobody has read yet: a reader shows
3909
- * it to the user and acts only on their go-ahead. Only a client that reports
3910
- * a version able to mark drafts is ever listed one, so an older reader that
3911
- * strips this field never receives a draft it would print as a request.
3912
- */
3913
- readonly approved: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
3914
- /** The author's display name as the workspace shows it, or null. Never an email. */
3915
- readonly authorName: v.NullableSchema<v.StringSchema<undefined>, undefined>;
3916
- /** ISO timestamp, machine format. */
3917
- readonly createdAt: v.StringSchema<undefined>;
3918
- /** The item's content version the comment was written against. */
3919
- readonly itemVersion: v.NumberSchema<undefined>;
3920
- /** True when the item's current version is greater than `itemVersion`. */
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 ContextItemVersionSchema: v.ObjectSchema<{
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. `item` is a guide or a document; `session` is a
8127
- * run the caller made. Session comments are the caller's own and never reach a
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 type SearchCommentSubjectKindName = (typeof SEARCH_COMMENT_SUBJECT_KIND_NAMES)[number];
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 ["item", "session", "artifact"], undefined>, undefined>, v.MinLengthAction<("item" | "artifact" | "session")[], 1, undefined>]>, undefined>;
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 ["item", "session", "artifact"], undefined>, undefined>, v.MinLengthAction<("item" | "artifact" | "session")[], 1, undefined>]>, undefined>;
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?: ("item" | "artifact" | "session")[] | undefined;
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?: ("item" | "artifact" | "session")[] | undefined;
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?: ("item" | "artifact" | "session")[] | undefined;
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?: ("item" | "artifact" | "session")[] | undefined;
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?: ("item" | "artifact" | "session")[] | undefined;
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?: ("item" | "artifact" | "session")[] | undefined;
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 SearchItemCommentHitSchema: v.ObjectSchema<{
8486
- readonly subjectKind: v.LiteralSchema<"item", undefined>;
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 SearchItemCommentHit = v.InferOutput<typeof SearchItemCommentHitSchema>;
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 matchedIn: v.PicklistSchema<["body", "suggestion"], undefined>;
7164
+ readonly bundles: v.ArraySchema<v.StringSchema<undefined>, undefined>;
7165
+ readonly updatedAt: v.StringSchema<undefined>;
8844
7166
  /**
8845
- * A Mossbear suggestion's draft state: whether its owner has handed it to
8846
- * their agents. Absent on a person's or an agent's comment and on a reply.
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>, v.ObjectSchema<{
8857
- readonly subjectKind: v.LiteralSchema<"item", undefined>;
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 parsePushContextRequest(data: unknown): {
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 parsePushContextResponse(data: unknown): {
9573
- item: {
9574
- type: string;
7668
+ export declare function parseCreateBundleResponse(data: unknown): {
7669
+ bundle: {
9575
7670
  id: string;
9576
- artifactId?: string | null | undefined;
7671
+ slug: string;
9577
7672
  name: string;
9578
- role: string | null;
9579
- format: string | null;
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 parseUpdateContextItemRequest(data: unknown): {
9631
- itemId: string;
9632
- name?: string | undefined;
9633
- content?: string | undefined;
9634
- expectedVersion?: number | undefined;
9635
- projectId?: string | undefined;
9636
- path?: string | null | undefined;
9637
- sourceItemIds?: string[] | undefined;
9638
- gitSource?: {
9639
- projectId: string;
9640
- commitSha: string;
9641
- branch?: string | undefined;
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
- removed?: true | undefined;
7716
+ limitedToken?: boolean | undefined;
9644
7717
  };
9645
- export declare function parseUpdateContextItemResponse(data: unknown): {
9646
- item: {
9647
- type: string;
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
- artifactId?: string | null | undefined;
7725
+ slug: string;
9650
7726
  name: string;
9651
- role: string | null;
9652
- format: string | null;
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 parseUpdateContextItemBody(data: unknown): {
9704
- content?: string | undefined;
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 parseContextItemResponse(data: unknown): {
9718
- item: {
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 parseArchiveContextItemResponse(data: unknown): {
9775
- archived: boolean;
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 parseContextItemVersionsResponse(data: unknown): {
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: "item" | "artifact" | "session";
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;