@mossbear/protocol 0.1.0-alpha.88 → 0.1.0-alpha.90

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/schemas.d.ts CHANGED
@@ -60,6 +60,13 @@ export declare const GuideFileFormatSchema: v.PicklistSchema<["agents-md", "agen
60
60
  export { MAX_RAW_GUIDE_CONTENT_BYTES };
61
61
  /** Max member files a single skill-md payload may carry. */
62
62
  export declare const MAX_SKILL_MEMBER_FILES = 64;
63
+ export declare const PATH_ISSUE_MESSAGES: {
64
+ readonly backslash: "path must use forward slashes";
65
+ readonly absolute: "path must be relative";
66
+ readonly control: "path must not contain control characters";
67
+ readonly segments: "path must not contain empty, \".\" or \"..\" segments";
68
+ readonly skillMd: "path must not shadow the skill’s own SKILL.md";
69
+ };
63
70
  export declare const SafeRelativePosixPathSchema: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 512, undefined>, v.CheckAction<string, "path must use forward slashes">, v.CheckAction<string, "path must be relative">, v.CheckAction<string, "path must not contain control characters">, v.CheckAction<string, "path must not contain empty, \".\" or \"..\" segments">]>;
64
71
  export declare const SkillMemberPathSchema: v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 512, undefined>, v.CheckAction<string, "path must use forward slashes">, v.CheckAction<string, "path must be relative">, v.CheckAction<string, "path must not contain control characters">, v.CheckAction<string, "path must not contain empty, \".\" or \"..\" segments">]>, v.CheckAction<string, "path must not shadow the skill’s own SKILL.md">]>;
65
72
  export declare const RawSkillMemberFileSchema: v.ObjectSchema<{
@@ -924,9 +931,23 @@ export declare const ListScopedTokensResponseSchema: v.ObjectSchema<{
924
931
  export declare const RevokeScopedTokenRequestSchema: v.ObjectSchema<{
925
932
  readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
926
933
  }, undefined>;
927
- export declare const AttachBundleMemberRequestSchema: v.ObjectSchema<{
928
- readonly itemId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
929
- }, undefined>;
934
+ /**
935
+ * The member to attach, by its artifact id. `itemId` is the name a CLI from before
936
+ * release step 2 sends; both are read, and the parsed value is always `artifactId`.
937
+ * Drop `itemId` once no such CLI is left to send it.
938
+ */
939
+ export declare const AttachBundleMemberRequestSchema: v.SchemaWithPipe<readonly [v.ObjectSchema<{
940
+ readonly artifactId: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>;
941
+ readonly itemId: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>;
942
+ }, undefined>, v.CheckAction<{
943
+ artifactId?: string | undefined;
944
+ itemId?: string | undefined;
945
+ }, "A member needs an artifactId.">, v.TransformAction<{
946
+ artifactId?: string | undefined;
947
+ itemId?: string | undefined;
948
+ }, {
949
+ artifactId: string;
950
+ }>]>;
930
951
  export declare const AttachBundleMemberResponseSchema: v.ObjectSchema<{
931
952
  readonly attached: v.BooleanSchema<undefined>;
932
953
  }, undefined>;
@@ -984,7 +1005,6 @@ export declare const ContextItemTypeSchema: v.PicklistSchema<string[], undefined
984
1005
  * the release that moved the CLI's own vocabulary onto `content`.
985
1006
  */
986
1007
  export declare const ContextItemTypeFilterSchema: v.PicklistSchema<string[], undefined>;
987
- export declare const PushContentTypeSchema: v.PicklistSchema<("content" | "asset")[], undefined>;
988
1008
  export declare const InboxContentTypeSchema: v.PicklistSchema<("content" | "asset")[], undefined>;
989
1009
  export { MAX_CONTEXT_CONTENT_BYTES };
990
1010
  /**
@@ -2054,727 +2074,96 @@ export declare const ContextItemsResponseSchema: v.ObjectSchema<{
2054
2074
  }, undefined>, undefined>, undefined>;
2055
2075
  }, undefined>;
2056
2076
  /**
2057
- * 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.
2077
+ * The bundle pull under its artifact name: the same members and comments as
2078
+ * {@link ContextItemsResponseSchema}, under `artifacts`.
2201
2079
  */
2202
- export declare const AgentCommentResponseSchema: v.ObjectSchema<{
2203
- readonly created: v.BooleanSchema<undefined>;
2204
- readonly comment: v.ObjectSchema<{
2080
+ export declare const BundleArtifactsResponseSchema: v.ObjectSchema<{
2081
+ readonly artifacts: v.ArraySchema<v.SchemaWithPipe<readonly [v.ObjectSchema<{
2205
2082
  readonly id: v.StringSchema<undefined>;
2206
- readonly threadId: v.StringSchema<undefined>;
2207
- readonly subject: v.ObjectSchema<{
2208
- readonly kind: v.PicklistSchema<["artifact", "item", "session"], undefined>;
2209
- readonly id: v.StringSchema<undefined>;
2210
- }, undefined>;
2211
- readonly body: v.StringSchema<undefined>;
2212
- readonly createdAt: v.StringSchema<undefined>;
2213
- }, undefined>;
2214
- }, undefined>;
2215
- export type AgentCommentResponse = v.InferOutput<typeof AgentCommentResponseSchema>;
2216
- /**
2217
- * One comment on the on-demand read, with the item it is about named on the comment.
2218
- *
2219
- * The item is named here rather than the comments riding an item, because this
2220
- * read answers "what has been left for me" rather than "what is in this
2221
- * bundle": there is no item payload to hang them off, and an agent that has to
2222
- * ask for every item to find out whether one carries a comment is the round trip
2223
- * the announcement exists to avoid.
2224
- */
2225
- export declare const ItemCommentWithSubjectSchema: v.ObjectSchema<{
2226
- /** The item the comment is about, as the wire names it. */
2227
- readonly itemName: v.StringSchema<undefined>;
2228
- /** The item's declared repo-relative path, or null when it has none. */
2229
- readonly itemPath: v.NullableSchema<v.StringSchema<undefined>, undefined>;
2230
- readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
2231
- readonly state: v.OptionalSchema<v.PicklistSchema<["open", "resolved"], undefined>, undefined>;
2232
- /** Current source location of an anchored passage, or its lost quote. */
2233
- readonly passage: v.OptionalSchema<v.ObjectSchema<{
2234
- readonly quote: v.StringSchema<undefined>;
2235
- readonly status: v.PicklistSchema<["located", "changed", "orphaned"], undefined>;
2236
- readonly lines: v.NullableSchema<v.ObjectSchema<{
2237
- readonly start: v.NumberSchema<undefined>;
2238
- readonly end: v.NumberSchema<undefined>;
2239
- }, undefined>, undefined>;
2240
- }, undefined>, undefined>;
2241
- /** The comment's text, already wrapped in the response's untrusted markers. */
2242
- readonly body: v.StringSchema<undefined>;
2243
- /**
2244
- * A suggested edit: the replacement for the passage at `passage.lines`,
2245
- * already wrapped in the response's untrusted markers like `body`. An
2246
- * insertion is the passage plus its new lines and an empty replacement is a
2247
- * deletion, so every edit is one replace. Absent on an ordinary comment.
2248
- */
2249
- readonly suggestion: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
2250
- /**
2251
- * What a comment Mossbear wrote is: a finding about the item, never an edit.
2252
- * Present only on a Mossbear comment. The comment's `body` begins with the
2253
- * claim (what goes wrong); this carries what the claim rests on.
2254
- */
2255
- readonly finding: v.OptionalSchema<v.ObjectSchema<{
2256
- readonly tier: v.PicklistSchema<["observed", "usage", "practice"], undefined>;
2257
- /** How the finding is known, in one line: "Seen in 3 sessions (2026-09-15 – 2026-10-03)". */
2258
- readonly tierLine: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 300, undefined>]>;
2259
- /** What the drafter did not read, fixed per tier. */
2260
- readonly blindSpot: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 300, undefined>]>;
2261
- /** What should change in later sessions if the finding is fixed, wrapped in the untrusted markers. */
2262
- readonly prediction: v.NullableSchema<v.StringSchema<undefined>, undefined>;
2263
- }, undefined>, undefined>;
2264
- /**
2265
- * Whether the person approved a comment Mossbear drafted. Present on every
2266
- * Mossbear comment and absent on a person's or an agent's, which are
2267
- * requests as written. `false` is a draft nobody has read yet: a reader shows
2268
- * it to the user and acts only on their go-ahead. Only a client that reports
2269
- * a version able to mark drafts is ever listed one, so an older reader that
2270
- * strips this field never receives a draft it would print as a request.
2271
- */
2272
- readonly approved: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
2273
- /** The author's display name as the workspace shows it, or null. Never an email. */
2274
- readonly authorName: v.NullableSchema<v.StringSchema<undefined>, undefined>;
2275
- /** ISO timestamp, machine format. */
2276
- readonly createdAt: v.StringSchema<undefined>;
2277
- /** The item's content version the comment was written against. */
2278
- readonly itemVersion: v.NumberSchema<undefined>;
2279
- /** True when the item's current version is greater than `itemVersion`. */
2280
- readonly itemChangedSince: v.BooleanSchema<undefined>;
2281
- /**
2282
- * How many agent reads were handed this comment **before** this one — so a
2283
- * comment reaching an agent for the first time reports `0`.
2284
- *
2285
- * It is the stored count as it read at the moment the response was built;
2286
- * the serve this response *is* has not been counted yet. Excluded rather
2287
- * than included because the count is recorded best-effort: a response that
2288
- * claimed to include itself would be wrong whenever that record failed, and
2289
- * a number that is sometimes off by one is worse than one that is
2290
- * consistently the prior total.
2291
- *
2292
- * So `deliveredCount > 0` means an earlier read was handed this comment, and
2293
- * `0` means this read is the first. Neither says a model took it in — only
2294
- * that the server handed it over.
2295
- */
2296
- readonly deliveredCount: v.NumberSchema<undefined>;
2297
- /**
2298
- * This comment's thread root — its own id for every delivered root. Resolution
2299
- * replies remain on the dashboard thread and are not delivered to agents.
2300
- * It is on the wire from the first response
2301
- * because the wire contract is consumed by installed CLI versions: reshaping
2302
- * a flat `comments` array into threads-of-comments later would be a breaking
2303
- * change, while a field today's readers ignore costs them nothing.
2304
- */
2305
- readonly threadId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
2306
- /**
2307
- * Always `null` for a delivered root. Present so an older reader meeting a
2308
- * future response that carries real replies degrades to
2309
- * "a flat list of comments" rather than failing to parse.
2310
- */
2311
- readonly replyToId: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>;
2312
- }, undefined>;
2313
- export type ItemCommentWithSubject = v.InferOutput<typeof ItemCommentWithSubjectSchema>;
2314
- /**
2315
- * Every open comment waiting for this reader across the bundles they named.
2316
- *
2317
- * **This read is a delivery and is counted as one**, exactly as comments riding
2318
- * an item are: a body reached an agent. What it is *not* is an announcement —
2319
- * nothing here touches the per-repo announcement count, so asking to read your
2320
- * comments never spends the interruptions the hook is allowed.
2321
- *
2322
- * **Never capped.** The announcement cap governs whether a hook speaks; a
2323
- * reader who asked is owed every open comment, and hiding one here would retire a
2324
- * person's request without anybody deciding to.
2325
- */
2326
- export declare const ItemCommentsResponseSchema: v.ObjectSchema<{
2327
- readonly comments: v.ArraySchema<v.ObjectSchema<{
2328
- /** The item the comment is about, as the wire names it. */
2329
- readonly itemName: v.StringSchema<undefined>;
2330
- /** The item's declared repo-relative path, or null when it has none. */
2331
- readonly itemPath: v.NullableSchema<v.StringSchema<undefined>, undefined>;
2332
- readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
2333
- readonly state: v.OptionalSchema<v.PicklistSchema<["open", "resolved"], undefined>, undefined>;
2334
- /** Current source location of an anchored passage, or its lost quote. */
2335
- readonly passage: v.OptionalSchema<v.ObjectSchema<{
2336
- readonly quote: v.StringSchema<undefined>;
2337
- readonly status: v.PicklistSchema<["located", "changed", "orphaned"], undefined>;
2338
- readonly lines: v.NullableSchema<v.ObjectSchema<{
2339
- readonly start: v.NumberSchema<undefined>;
2340
- readonly end: v.NumberSchema<undefined>;
2341
- }, undefined>, undefined>;
2342
- }, undefined>, undefined>;
2343
- /** The comment's text, already wrapped in the response's untrusted markers. */
2344
- readonly body: v.StringSchema<undefined>;
2345
2083
  /**
2346
- * 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.
2084
+ * The id every artifact route addresses: the body file's id for a guide
2085
+ * (null only for a guide with no body yet), the item's own id otherwise.
2086
+ * Optional so a client tolerates a server that predates it, and one that
2087
+ * stops sending it (the item id is the artifact id).
2350
2088
  */
2351
- readonly suggestion: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
2089
+ readonly artifactId: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
2352
2090
  /**
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.
2091
+ * Leaving the wire: a reader tells a guide from content by `role` and the
2092
+ * guide fields, not by this. Optional so a client parses a server that no
2093
+ * longer sends it.
2356
2094
  */
2357
- readonly 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>;
2095
+ readonly type: v.OptionalSchema<v.PicklistSchema<string[], undefined>, undefined>;
2096
+ readonly name: v.StringSchema<undefined>;
2366
2097
  /**
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.
2098
+ * The stored `(role, format)` pair, as two bare nullable strings.
2099
+ *
2100
+ * **Both are deliberately unenumerated.** A client switches on one value it
2101
+ * cares about — `role === 'criteria'` is how a rubric is told from ordinary
2102
+ * prose, which `type` cannot say because a rubric serializes as a `document` —
2103
+ * and a server that adds a fourth role or a fifth format must not break a
2104
+ * client that has never heard of it. Narrowing them here would make every such
2105
+ * addition a breaking wire change for no reader's benefit.
2106
+ *
2107
+ * Null on exactly the rows that carry no content: a tombstone, and an alias.
2108
+ * A `guide` item has no pair at all — it is a different table — and reports
2109
+ * both as null.
2373
2110
  */
2374
- readonly 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>;
2111
+ readonly role: v.NullableSchema<v.StringSchema<undefined>, undefined>;
2112
+ readonly format: v.NullableSchema<v.StringSchema<undefined>, undefined>;
2113
+ readonly content: v.NullableSchema<v.StringSchema<undefined>, undefined>;
2114
+ readonly origin: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
2115
+ readonly version: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
2383
2116
  /**
2384
- * How many agent reads were handed this comment **before** this one — so a
2385
- * comment reaching an agent for the first time reports `0`.
2117
+ * The guide a **derived** item belongs to — its evaluation criteria, or a
2118
+ * skill's member files (`subscription-delivery-target-plan.md` → slice 4).
2386
2119
  *
2387
- * 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.
2120
+ * Absent on everything else, including a guide itself: a guide member is
2121
+ * addressed by the guide's own id, so `id` already answers this for it.
2393
2122
  *
2394
- * 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.
2123
+ * It exists because derived items have no bundle membership and no id of their
2124
+ * guide's — they are `guide_files` rows attached by `guide_id` — so a rule
2125
+ * expressed over guide ids (a subscriber's mute) cannot reach them from the
2126
+ * item alone. Muting a skill and still delivering its `scripts/` would leave a
2127
+ * broken half-skill on disk, which is worse than not muting at all.
2397
2128
  */
2398
- readonly deliveredCount: v.NumberSchema<undefined>;
2129
+ readonly guideId: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
2130
+ readonly root: v.OptionalSchema<v.NullableSchema<v.PicklistSchema<["project", "global"], undefined>, undefined>, undefined>;
2131
+ readonly path: v.OptionalSchema<v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 512, undefined>, v.CheckAction<string, "path must use forward slashes">, v.CheckAction<string, "path must be relative">, v.CheckAction<string, "path must not contain control characters">, v.CheckAction<string, "path must not contain empty, \".\" or \"..\" segments">]>, undefined>, undefined>;
2132
+ readonly projectId: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
2399
2133
  /**
2400
- * 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.
2134
+ * The repo a **document's** declared `path` is placed in — its home — as the
2135
+ * `project.id` of the checkout that last set the path. Documents only.
2136
+ *
2137
+ * Deliberately not `projectId` above: a reader takes a mismatch there as "this
2138
+ * item belongs to another repo, do not materialize it", so a home echoed on it
2139
+ * would stop every other subscriber receiving the document at all. A home says
2140
+ * only *where* the path is literal. Only the repo whose `project.id` matches
2141
+ * writes the document at `path`; every other repo mirrors it under the
2142
+ * bundle folder (`bundleMirrorPath` in `@mossbear/projections`).
2143
+ *
2144
+ * Absent and null read the same — **no home**, so no repo takes the path
2145
+ * literally for a new placement. A server predating the field says the same,
2146
+ * which is the safe direction: the file lands inside the bundle folder
2147
+ * instead of at a repo path it may not belong in.
2406
2148
  */
2407
- readonly threadId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
2149
+ readonly pathProjectId: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
2150
+ readonly aliases: v.OptionalSchema<v.SchemaWithPipe<readonly [v.ArraySchema<v.ObjectSchema<{
2151
+ readonly root: v.PicklistSchema<["project", "global"], undefined>;
2152
+ readonly path: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 512, undefined>, v.CheckAction<string, "path must use forward slashes">, v.CheckAction<string, "path must be relative">, v.CheckAction<string, "path must not contain control characters">, v.CheckAction<string, "path must not contain empty, \".\" or \"..\" segments">]>;
2153
+ }, undefined>, undefined>, v.MaxLengthAction<{
2154
+ root: "project" | "global";
2155
+ path: string;
2156
+ }[], 8, undefined>]>, undefined>;
2408
2157
  /**
2409
- * 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.
2158
+ * Open comments a person left about this item, newest first.
2159
+ *
2160
+ * Optional, and absent rather than empty when there are none — the same rule
2161
+ * `aliases` and `projectId` follow above, and for the same reason: an older
2162
+ * reader against a newer server ignores the key, and a newer reader against
2163
+ * an older server reads "no comments" instead of failing.
2164
+ *
2165
+ * **Absence is not a verdict.** No comments here means none were served on this
2166
+ * item in this response — not that nobody has anything to say about it.
2778
2167
  */
2779
2168
  readonly comments: v.OptionalSchema<v.SchemaWithPipe<readonly [v.ArraySchema<v.ObjectSchema<{
2780
2169
  readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
@@ -3063,1477 +2452,564 @@ export declare const PushContextResponseSchema: v.ObjectSchema<{
3063
2452
  branch?: string | undefined;
3064
2453
  } | null | undefined;
3065
2454
  removed?: true | undefined;
3066
- }>]>;
3067
- readonly created: v.BooleanSchema<undefined>;
2455
+ }>]>, undefined>;
2456
+ readonly untrusted: v.OptionalSchema<v.NullableSchema<v.ObjectSchema<{
2457
+ readonly token: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
2458
+ readonly startMarker: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
2459
+ readonly endMarker: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
2460
+ readonly note: v.StringSchema<undefined>;
2461
+ }, undefined>, undefined>, undefined>;
3068
2462
  }, undefined>;
3069
- 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>;
2463
+ /**
2464
+ * How many bundles one comments read may name.
2465
+ *
2466
+ * A repo's delivery set is the union of its committed subscriptions and the
2467
+ * reader's account ones, so this bounds a request, not a product limit: a
2468
+ * reader subscribing to more bundles than this asks in two calls rather than
2469
+ * losing the tail silently.
2470
+ */
2471
+ export declare const MAX_COMMENT_BUNDLE_IDS = 100;
2472
+ /**
2473
+ * How many times one subscriber is told, in one repo, that a given comment is
2474
+ * waiting before the hook falls silent about it.
2475
+ *
2476
+ * **A cap on the interruption, never on the comment.** After it is reached the
2477
+ * comment is still open, still on the item page, and still returned in full by
2478
+ * the on-demand read — it simply stops being announced in front of the first
2479
+ * turn of every session. So silence here means "nothing new to interrupt you
2480
+ * about", never "nobody left anything".
2481
+ *
2482
+ * Three rather than one, for the reason the announcement exists: the first
2483
+ * session in a repo is often doing unrelated work, so a one-shot announcement
2484
+ * would routinely spend itself on the session least likely to act. Three is a
2485
+ * judgement, named so replacing it is one edit — the same discipline the live
2486
+ * session window is held to.
2487
+ */
2488
+ export declare const MAX_COMMENT_ANNOUNCEMENTS_PER_REPO = 3;
2489
+ /**
2490
+ * Ask which comments are waiting for this reader in this repo, and be counted as
2491
+ * told.
2492
+ *
2493
+ * **A write, because being told is a fact the server has to keep.** The count
2494
+ * cannot be `item_comments.delivered_count` — that is one global number across
2495
+ * every subscriber and every repo, so one reader's fill of a comment would
2496
+ * silence it for everyone — and it cannot live in the checkout, because the
2497
+ * disposable environments this exists for rebuild the clone every session and
2498
+ * a counter there resets with it, announcing every unresolved comment as new
2499
+ * forever.
2500
+ */
2501
+ export declare const AnnounceItemCommentsRequestSchema: v.ObjectSchema<{
2502
+ /**
2503
+ * The repo, as its committed config declares it. Required: it is the scope
2504
+ * the count is kept under, and a request with nothing to key on could only
2505
+ * be answered by an uncapped announcement — which is the repeating broadcast
2506
+ * this route exists to end.
2507
+ */
2508
+ readonly projectId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 128, undefined>, v.RegexAction<string, "projectId must contain only letters, digits, underscore, dot or hyphen">]>;
3132
2509
  /**
3133
- * 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.
2510
+ * The bundles this repo receives — the union the caller already resolved.
3136
2511
  *
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.
2512
+ * Sent rather than derived, because only half of it is the server's to know:
2513
+ * a repo-scoped subscription lives in the committed config and travels by
2514
+ * `git clone`. Declaring a bundle grants nothing: every one of them is still
2515
+ * filtered by the caller's own workspace membership.
2516
+ */
2517
+ readonly bundleIds: v.SchemaWithPipe<readonly [v.ArraySchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>, v.MaxLengthAction<string[], 100, undefined>]>;
2518
+ }, undefined>;
2519
+ export type AnnounceItemCommentsRequest = v.InferOutput<typeof AnnounceItemCommentsRequestSchema>;
2520
+ /**
2521
+ * What an announcement answers: how many comments are waiting, and how many of
2522
+ * them this call was counted as announcing.
2523
+ *
2524
+ * **Two numbers because they answer two questions and a reader needs both.**
2525
+ * `open` is the true state of this repo's comments and is what a caller shows a
2526
+ * person — a number that is sometimes a subset of the truth would be worse
2527
+ * than the silence it replaced. `announced` is how many of those were still
2528
+ * under the cap, and it is the one that decides whether to speak at all: zero
2529
+ * means this reader has already been told about every one of them as often as
2530
+ * the cap allows.
2531
+ */
2532
+ export declare const AnnounceItemCommentsResponseSchema: v.ObjectSchema<{
2533
+ /** Open, unmuted comments about the items these bundles deliver to this reader. */
2534
+ readonly open: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
2535
+ /** How many of those were under the cap and have now been counted as announced. */
2536
+ readonly announced: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
2537
+ }, undefined>;
2538
+ export type AnnounceItemCommentsResponse = v.InferOutput<typeof AnnounceItemCommentsResponseSchema>;
2539
+ /**
2540
+ * How many comments one agent session may leave on one subject, not counting its
2541
+ * whole-subject comment. Anchored comments and replies share it.
2542
+ */
2543
+ export declare const MAX_AGENT_COMMENTS_PER_SUBJECT = 50;
2544
+ /** The longest an agent comment's text may be, in characters. */
2545
+ export declare const MAX_AGENT_COMMENT_BODY_CHARS = 4000;
2546
+ /**
2547
+ * Why an agent comment was refused, as the `code` on the error body. A caller
2548
+ * branches on these; the message beside one is for a person.
2549
+ */
2550
+ export declare const AGENT_COMMENT_ERROR_CODES: readonly ["agent_session_required", "agent_comment_limit_reached", "agent_comment_text_only", "agent_comment_target_missing", "agent_comment_passage_not_found", "agent_comment_passage_ambiguous", "item_comment_limit_reached"];
2551
+ export declare const AgentCommentErrorCodeSchema: v.PicklistSchema<readonly ["agent_session_required", "agent_comment_limit_reached", "agent_comment_text_only", "agent_comment_target_missing", "agent_comment_passage_not_found", "agent_comment_passage_ambiguous", "item_comment_limit_reached"], undefined>;
2552
+ export type AgentCommentErrorCode = v.InferOutput<typeof AgentCommentErrorCodeSchema>;
2553
+ /**
2554
+ * Leave a comment, or reply to one, as an agent (`POST /api/v1/context/comments`).
2555
+ *
2556
+ * **`target` names what the comment is about, one way.** `artifact` is the id
2557
+ * a bundle read gave for a guide or document, and `item` is its older name for
2558
+ * the same thing, accepted until every client sends `artifact`. `session` is an
2559
+ * agent session id of the caller's own (the key a search hit and the session digest hand out), and
2560
+ * `reply` is the id of a comment to answer. A reply joins that comment's thread
2561
+ * and the subject it is about.
2562
+ *
2563
+ * **Who the agent is comes from `agent`, and `sessionId` is the harness's own
2564
+ * id as the CLI read it.** A request without one is refused with
2565
+ * `agent_session_required`, and the CLI and tool offer no way to type one. The
2566
+ * server cannot check it against the harness, so it is a claim by the holder of
2567
+ * the token: the comment is always written under that token's account, and the
2568
+ * handle shown for it names a session only as far as the claim is true.
2569
+ *
2570
+ * **Text only.** There is no replacement-text field, and a request that carries
2571
+ * one is refused with `agent_comment_text_only` rather than having it dropped.
2572
+ */
2573
+ export declare const AgentCommentRequestSchema: v.ObjectSchema<{
2574
+ readonly target: v.VariantSchema<"kind", [v.ObjectSchema<{
2575
+ readonly kind: v.LiteralSchema<"artifact", undefined>;
2576
+ readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 128, undefined>]>;
2577
+ }, undefined>, v.ObjectSchema<{
2578
+ readonly kind: v.LiteralSchema<"session", undefined>;
2579
+ readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 128, undefined>]>;
2580
+ }, undefined>, v.ObjectSchema<{
2581
+ readonly kind: v.LiteralSchema<"reply", undefined>;
2582
+ readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 128, undefined>]>;
2583
+ }, undefined>], undefined>;
2584
+ readonly body: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 4000, undefined>]>;
2585
+ /**
2586
+ * The passage an item comment is about, as the exact text of one or more whole
2587
+ * lines of the item (a paragraph, a heading, a list). None means the item as a
2588
+ * whole. The server finds the lines; a passage that is not in the item as it is
2589
+ * now is refused with `agent_comment_passage_not_found`.
2590
+ */
2591
+ readonly passage: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 8000, undefined>]>, undefined>;
2592
+ readonly agent: v.ObjectSchema<{
2593
+ readonly sessionId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 128, undefined>]>;
2594
+ readonly harness: v.PicklistSchema<["claude_code", "codex", "antigravity", "opencode"], undefined>;
2595
+ /** The agent's own statement of its model, when it knows it. */
2596
+ readonly model: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 100, undefined>]>, undefined>;
2597
+ readonly cliVersion: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 64, undefined>]>, undefined>;
2598
+ }, undefined>;
2599
+ }, undefined>;
2600
+ export type AgentCommentRequest = v.InferOutput<typeof AgentCommentRequestSchema>;
2601
+ /**
2602
+ * The comment a create settled on. `created` is false when this agent session
2603
+ * already had a whole-subject comment on the subject: that comment comes back
2604
+ * unchanged and nothing was written.
2605
+ */
2606
+ export declare const AgentCommentResponseSchema: v.ObjectSchema<{
2607
+ readonly created: v.BooleanSchema<undefined>;
2608
+ readonly comment: v.ObjectSchema<{
2609
+ readonly id: v.StringSchema<undefined>;
2610
+ readonly threadId: v.StringSchema<undefined>;
2611
+ readonly subject: v.ObjectSchema<{
2612
+ readonly kind: v.PicklistSchema<["artifact", "session"], undefined>;
2613
+ readonly id: v.StringSchema<undefined>;
2614
+ }, undefined>;
2615
+ readonly body: v.StringSchema<undefined>;
2616
+ readonly createdAt: v.StringSchema<undefined>;
2617
+ }, undefined>;
2618
+ }, undefined>;
2619
+ export type AgentCommentResponse = v.InferOutput<typeof AgentCommentResponseSchema>;
2620
+ /**
2621
+ * One comment on the on-demand read, with the item it is about named on the comment.
2622
+ *
2623
+ * The item is named here rather than the comments riding an item, because this
2624
+ * read answers "what has been left for me" rather than "what is in this
2625
+ * bundle": there is no item payload to hang them off, and an agent that has to
2626
+ * ask for every item to find out whether one carries a comment is the round trip
2627
+ * the announcement exists to avoid.
2628
+ */
2629
+ export declare const ItemCommentWithSubjectSchema: v.ObjectSchema<{
2630
+ /** The item the comment is about, as the wire names it. */
2631
+ readonly itemName: v.StringSchema<undefined>;
2632
+ /** The item's declared repo-relative path, or null when it has none. */
2633
+ readonly itemPath: v.NullableSchema<v.StringSchema<undefined>, undefined>;
2634
+ readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
2635
+ readonly state: v.OptionalSchema<v.PicklistSchema<["open", "resolved"], undefined>, undefined>;
2636
+ /** Current source location of an anchored passage, or its lost quote. */
2637
+ readonly passage: v.OptionalSchema<v.ObjectSchema<{
2638
+ readonly quote: v.StringSchema<undefined>;
2639
+ readonly status: v.PicklistSchema<["located", "changed", "orphaned"], undefined>;
2640
+ readonly lines: v.NullableSchema<v.ObjectSchema<{
2641
+ readonly start: v.NumberSchema<undefined>;
2642
+ readonly end: v.NumberSchema<undefined>;
2643
+ }, undefined>, undefined>;
2644
+ }, undefined>, undefined>;
2645
+ /** The comment's text, already wrapped in the response's untrusted markers. */
2646
+ readonly body: v.StringSchema<undefined>;
2647
+ /**
2648
+ * A suggested edit: the replacement for the passage at `passage.lines`,
2649
+ * already wrapped in the response's untrusted markers like `body`. An
2650
+ * insertion is the passage plus its new lines and an empty replacement is a
2651
+ * deletion, so every edit is one replace. Absent on an ordinary comment.
2652
+ */
2653
+ readonly suggestion: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
2654
+ /**
2655
+ * What a comment Mossbear wrote is: a finding about the item, never an edit.
2656
+ * Present only on a Mossbear comment. The comment's `body` begins with the
2657
+ * claim (what goes wrong); this carries what the claim rests on.
2658
+ */
2659
+ readonly finding: v.OptionalSchema<v.ObjectSchema<{
2660
+ readonly tier: v.PicklistSchema<["observed", "usage", "practice"], undefined>;
2661
+ /** How the finding is known, in one line: "Seen in 3 sessions (2026-09-15 – 2026-10-03)". */
2662
+ readonly tierLine: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 300, undefined>]>;
2663
+ /** What the drafter did not read, fixed per tier. */
2664
+ readonly blindSpot: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 300, undefined>]>;
2665
+ /** What should change in later sessions if the finding is fixed, wrapped in the untrusted markers. */
2666
+ readonly prediction: v.NullableSchema<v.StringSchema<undefined>, undefined>;
2667
+ }, undefined>, undefined>;
2668
+ /**
2669
+ * Whether the person approved a comment Mossbear drafted. Present on every
2670
+ * Mossbear comment and absent on a person's or an agent's, which are
2671
+ * requests as written. `false` is a draft nobody has read yet: a reader shows
2672
+ * it to the user and acts only on their go-ahead. Only a client that reports
2673
+ * a version able to mark drafts is ever listed one, so an older reader that
2674
+ * strips this field never receives a draft it would print as a request.
2675
+ */
2676
+ readonly approved: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
2677
+ /** The author's display name as the workspace shows it, or null. Never an email. */
2678
+ readonly authorName: v.NullableSchema<v.StringSchema<undefined>, undefined>;
2679
+ /** ISO timestamp, machine format. */
2680
+ readonly createdAt: v.StringSchema<undefined>;
2681
+ /** The item's content version the comment was written against. */
2682
+ readonly itemVersion: v.NumberSchema<undefined>;
2683
+ /** True when the item's current version is greater than `itemVersion`. */
2684
+ readonly itemChangedSince: v.BooleanSchema<undefined>;
2685
+ /**
2686
+ * How many agent reads were handed this comment **before** this one — so a
2687
+ * comment reaching an agent for the first time reports `0`.
3143
2688
  *
3144
- * **`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.
2689
+ * It is the stored count as it read at the moment the response was built;
2690
+ * the serve this response *is* has not been counted yet. Excluded rather
2691
+ * than included because the count is recorded best-effort: a response that
2692
+ * claimed to include itself would be wrong whenever that record failed, and
2693
+ * a number that is sometimes off by one is worse than one that is
2694
+ * consistently the prior total.
3150
2695
  *
3151
- * **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.
2696
+ * So `deliveredCount > 0` means an earlier read was handed this comment, and
2697
+ * `0` means this read is the first. Neither says a model took it in — only
2698
+ * that the server handed it over.
3153
2699
  */
3154
- readonly removed: v.OptionalSchema<v.LiteralSchema<true, undefined>, undefined>;
2700
+ readonly deliveredCount: v.NumberSchema<undefined>;
2701
+ /**
2702
+ * This comment's thread root — its own id for every delivered root. Resolution
2703
+ * replies remain on the dashboard thread and are not delivered to agents.
2704
+ * It is on the wire from the first response
2705
+ * because the wire contract is consumed by installed CLI versions: reshaping
2706
+ * a flat `comments` array into threads-of-comments later would be a breaking
2707
+ * change, while a field today's readers ignore costs them nothing.
2708
+ */
2709
+ readonly threadId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
2710
+ /**
2711
+ * Always `null` for a delivered root. Present so an older reader meeting a
2712
+ * future response that carries real replies degrades to
2713
+ * "a flat list of comments" rather than failing to parse.
2714
+ */
2715
+ readonly replyToId: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>;
3155
2716
  }, undefined>;
3156
- export declare const UpdateContextItemResponseSchema: v.ObjectSchema<{
3157
- readonly item: v.SchemaWithPipe<readonly [v.ObjectSchema<{
3158
- readonly id: v.StringSchema<undefined>;
2717
+ export type ItemCommentWithSubject = v.InferOutput<typeof ItemCommentWithSubjectSchema>;
2718
+ /**
2719
+ * Every open comment waiting for this reader across the bundles they named.
2720
+ *
2721
+ * **This read is a delivery and is counted as one**, exactly as comments riding
2722
+ * an item are: a body reached an agent. What it is *not* is an announcement —
2723
+ * nothing here touches the per-repo announcement count, so asking to read your
2724
+ * comments never spends the interruptions the hook is allowed.
2725
+ *
2726
+ * **Never capped.** The announcement cap governs whether a hook speaks; a
2727
+ * reader who asked is owed every open comment, and hiding one here would retire a
2728
+ * person's request without anybody deciding to.
2729
+ */
2730
+ export declare const ItemCommentsResponseSchema: v.ObjectSchema<{
2731
+ readonly comments: v.ArraySchema<v.ObjectSchema<{
2732
+ /** The item the comment is about, as the wire names it. */
2733
+ readonly itemName: v.StringSchema<undefined>;
2734
+ /** The item's declared repo-relative path, or null when it has none. */
2735
+ readonly itemPath: v.NullableSchema<v.StringSchema<undefined>, undefined>;
2736
+ readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
2737
+ readonly state: v.OptionalSchema<v.PicklistSchema<["open", "resolved"], undefined>, undefined>;
2738
+ /** Current source location of an anchored passage, or its lost quote. */
2739
+ readonly passage: v.OptionalSchema<v.ObjectSchema<{
2740
+ readonly quote: v.StringSchema<undefined>;
2741
+ readonly status: v.PicklistSchema<["located", "changed", "orphaned"], undefined>;
2742
+ readonly lines: v.NullableSchema<v.ObjectSchema<{
2743
+ readonly start: v.NumberSchema<undefined>;
2744
+ readonly end: v.NumberSchema<undefined>;
2745
+ }, undefined>, undefined>;
2746
+ }, undefined>, undefined>;
2747
+ /** The comment's text, already wrapped in the response's untrusted markers. */
2748
+ readonly body: v.StringSchema<undefined>;
3159
2749
  /**
3160
- * 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).
2750
+ * A suggested edit: the replacement for the passage at `passage.lines`,
2751
+ * already wrapped in the response's untrusted markers like `body`. An
2752
+ * insertion is the passage plus its new lines and an empty replacement is a
2753
+ * deletion, so every edit is one replace. Absent on an ordinary comment.
3164
2754
  */
3165
- readonly artifactId: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
2755
+ readonly suggestion: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
3166
2756
  /**
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.
2757
+ * What a comment Mossbear wrote is: a finding about the item, never an edit.
2758
+ * Present only on a Mossbear comment. The comment's `body` begins with the
2759
+ * claim (what goes wrong); this carries what the claim rests on.
3170
2760
  */
3171
- readonly type: v.OptionalSchema<v.PicklistSchema<string[], undefined>, undefined>;
3172
- readonly name: v.StringSchema<undefined>;
2761
+ readonly finding: v.OptionalSchema<v.ObjectSchema<{
2762
+ readonly tier: v.PicklistSchema<["observed", "usage", "practice"], undefined>;
2763
+ /** How the finding is known, in one line: "Seen in 3 sessions (2026-09-15 – 2026-10-03)". */
2764
+ readonly tierLine: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 300, undefined>]>;
2765
+ /** What the drafter did not read, fixed per tier. */
2766
+ readonly blindSpot: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 300, undefined>]>;
2767
+ /** What should change in later sessions if the finding is fixed, wrapped in the untrusted markers. */
2768
+ readonly prediction: v.NullableSchema<v.StringSchema<undefined>, undefined>;
2769
+ }, undefined>, undefined>;
3173
2770
  /**
3174
- * 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.
2771
+ * Whether the person approved a comment Mossbear drafted. Present on every
2772
+ * Mossbear comment and absent on a person's or an agent's, which are
2773
+ * requests as written. `false` is a draft nobody has read yet: a reader shows
2774
+ * it to the user and acts only on their go-ahead. Only a client that reports
2775
+ * a version able to mark drafts is ever listed one, so an older reader that
2776
+ * strips this field never receives a draft it would print as a request.
3186
2777
  */
3187
- readonly 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>;
2778
+ readonly approved: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
2779
+ /** The author's display name as the workspace shows it, or null. Never an email. */
2780
+ readonly authorName: v.NullableSchema<v.StringSchema<undefined>, undefined>;
2781
+ /** ISO timestamp, machine format. */
2782
+ readonly createdAt: v.StringSchema<undefined>;
2783
+ /** The item's content version the comment was written against. */
2784
+ readonly itemVersion: v.NumberSchema<undefined>;
2785
+ /** True when the item's current version is greater than `itemVersion`. */
2786
+ readonly itemChangedSince: v.BooleanSchema<undefined>;
3192
2787
  /**
3193
- * The guide a **derived** item belongs to — its evaluation criteria, or a
3194
- * skill's member files (`subscription-delivery-target-plan.md` → slice 4).
2788
+ * How many agent reads were handed this comment **before** this one — so a
2789
+ * comment reaching an agent for the first time reports `0`.
3195
2790
  *
3196
- * 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.
2791
+ * It is the stored count as it read at the moment the response was built;
2792
+ * the serve this response *is* has not been counted yet. Excluded rather
2793
+ * than included because the count is recorded best-effort: a response that
2794
+ * claimed to include itself would be wrong whenever that record failed, and
2795
+ * a number that is sometimes off by one is worse than one that is
2796
+ * consistently the prior total.
3198
2797
  *
3199
- * 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.
2798
+ * So `deliveredCount > 0` means an earlier read was handed this comment, and
2799
+ * `0` means this read is the first. Neither says a model took it in — only
2800
+ * that the server handed it over.
3204
2801
  */
3205
- readonly 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>;
2802
+ readonly deliveredCount: v.NumberSchema<undefined>;
3209
2803
  /**
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.
2804
+ * This comment's thread root — its own id for every delivered root. Resolution
2805
+ * replies remain on the dashboard thread and are not delivered to agents.
2806
+ * It is on the wire from the first response
2807
+ * because the wire contract is consumed by installed CLI versions: reshaping
2808
+ * a flat `comments` array into threads-of-comments later would be a breaking
2809
+ * change, while a field today's readers ignore costs them nothing.
3224
2810
  */
3225
- readonly 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>;
2811
+ readonly threadId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
3233
2812
  /**
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.
2813
+ * Always `null` for a delivered root. Present so an older reader meeting a
2814
+ * future response that carries real replies degrades to
2815
+ * "a flat list of comments" rather than failing to parse.
3243
2816
  */
3244
- readonly 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>;
2817
+ readonly replyToId: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>;
2818
+ }, undefined>, undefined>;
2819
+ readonly cursor: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
3547
2820
  /**
3548
- * 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.
2821
+ * The markers every `body` above is wrapped in, plus a statement of what
2822
+ * they mean. Present exactly when at least one comment came back.
3565
2823
  */
3566
- readonly 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>;
2824
+ readonly untrusted: v.OptionalSchema<v.NullableSchema<v.ObjectSchema<{
2825
+ readonly token: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
2826
+ readonly startMarker: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
2827
+ readonly endMarker: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
2828
+ readonly note: v.StringSchema<undefined>;
2829
+ }, undefined>, undefined>, undefined>;
2830
+ }, undefined>;
2831
+ export type ItemCommentsResponse = v.InferOutput<typeof ItemCommentsResponseSchema>;
2832
+ /**
2833
+ * The evidence behind one Mossbear finding an agent was handed
2834
+ * (`GET /api/v1/context/comments/evidence`).
2835
+ *
2836
+ * `list_comments` carries the claim and a one-line tier; this is the finding
2837
+ * in full: the claim, the change it predicts in future sessions, what the
2838
+ * drafter did not read, and the evidence for its tier. Readable only through a
2839
+ * comment the comment read itself would deliver to this reader, so another
2840
+ * person's finding, one drafted from another repo, or a draft listed only to a
2841
+ * newer client has no evidence here either. A draft the reader was listed
2842
+ * does: an agent can say why it was raised before the person approves it.
2843
+ *
2844
+ * Citations (observed and usage findings) are reduced to what the reader may
2845
+ * see: their own sessions, with a date and a short excerpt of the grader's
2846
+ * reasoning or of their own redacted correction turn. A `navigation` citation
2847
+ * has an empty excerpt: it is dated evidence that a session loaded the skill,
2848
+ * and nothing more. `citationsWithheld` counts any that were dropped, so a
2849
+ * short list is never mistaken for the whole of it.
2850
+ */
2851
+ export declare const CommentEvidenceCitationSchema: v.ObjectSchema<{
3568
2852
  /**
3569
- * 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.
2853
+ * `navigation` is a skill load counted when a finding was drafted from how
2854
+ * the skill's files were read: evidence of how a skill was used, not of a
2855
+ * failure. `action` is a recorded step of a workflow repeated across
2856
+ * sessions. A server sends it only to a client that names a version new
2857
+ * enough to parse it.
3580
2858
  */
3581
- readonly 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<{
2859
+ readonly kind: v.PicklistSchema<["verdict", "turn", "navigation", "action"], undefined>;
2860
+ readonly sessionId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
2861
+ /** ISO, when the verdict was graded, the turn was said, the skill loaded, or the action was recorded. */
2862
+ readonly at: v.StringSchema<undefined>;
2863
+ /** Wrapped in the response's untrusted markers. */
2864
+ readonly excerpt: v.StringSchema<undefined>;
2865
+ }, undefined>;
2866
+ export type CommentEvidenceCitation = v.InferOutput<typeof CommentEvidenceCitationSchema>;
2867
+ /** What a usage finding adds to its citations: the counts for one reference file. */
2868
+ export declare const CommentEvidenceUsageSchema: v.ObjectSchema<{
2869
+ /** The reference's skill-relative path, wrapped in the response's untrusted markers. */
2870
+ readonly path: v.StringSchema<undefined>;
2871
+ /** Eligible loads of the skill. */
2872
+ readonly loads: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>]>;
2873
+ /** Distinct sessions those loads span. */
2874
+ readonly sessions: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>]>;
2875
+ /** Loads followed by a successful read of the reference. */
2876
+ readonly loadsWithRead: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>]>;
2877
+ }, undefined>;
2878
+ /**
2879
+ * What a practice finding adds: the rubric check it answers and the rubric's
2880
+ * version, the practice lines it weighs with their sources, the facts measured
2881
+ * from the file, and the answer to each item of evidence the check asks for.
2882
+ * `answers[].answer` is model-written, so it travels wrapped in the response's
2883
+ * untrusted markers.
2884
+ */
2885
+ export declare const CommentEvidencePracticeSchema: v.ObjectSchema<{
2886
+ readonly check: v.ObjectSchema<{
3784
2887
  readonly id: v.StringSchema<undefined>;
3785
- /**
3786
- * The id every artifact route addresses: the body file's id for a guide
3787
- * (null only for a guide with no body yet), the item's own id otherwise.
3788
- * Optional so a client tolerates a server that predates it, and one that
3789
- * stops sending it (the item id is the artifact id).
3790
- */
3791
- readonly artifactId: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
3792
- /**
3793
- * Leaving the wire: a reader tells a guide from content by `role` and the
3794
- * guide fields, not by this. Optional so a client parses a server that no
3795
- * longer sends it.
3796
- */
3797
- readonly type: v.OptionalSchema<v.PicklistSchema<string[], undefined>, undefined>;
3798
2888
  readonly name: v.StringSchema<undefined>;
3799
- /**
3800
- * 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
- }>]>;
2889
+ }, undefined>;
2890
+ readonly rubricVersion: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>]>;
2891
+ readonly practices: v.OptionalSchema<v.ArraySchema<v.ObjectSchema<{
2892
+ readonly text: v.StringSchema<undefined>;
2893
+ readonly source: v.ObjectSchema<{
2894
+ readonly title: v.StringSchema<undefined>;
2895
+ readonly url: v.StringSchema<undefined>;
2896
+ }, undefined>;
2897
+ }, undefined>, undefined>, readonly []>;
2898
+ readonly facts: v.OptionalSchema<v.ArraySchema<v.StringSchema<undefined>, undefined>, readonly []>;
2899
+ readonly answers: v.OptionalSchema<v.ArraySchema<v.ObjectSchema<{
2900
+ readonly item: v.StringSchema<undefined>;
2901
+ readonly answer: v.StringSchema<undefined>;
2902
+ }, undefined>, undefined>, readonly []>;
2903
+ }, undefined>;
2904
+ /**
2905
+ * A comment the person (or Mossbear) left on one of the sessions a finding
2906
+ * cites — the person's own account of what the agent should have known, set
2907
+ * beside the grader's excerpt (`guide-findings-plan.md` → Your note on a
2908
+ * session).
2909
+ *
2910
+ * **Reachable only here.** A comment about a session is never listed by
2911
+ * `list_comments` or announced at session start: it is context for a finding,
2912
+ * found by following the finding's citation, not a request.
2913
+ */
2914
+ export declare const CommentEvidenceSessionCommentSchema: v.ObjectSchema<{
2915
+ readonly sessionId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
2916
+ /** Only the person's own notes are sent today; `mossbear` is reserved. */
2917
+ readonly authorKind: v.PicklistSchema<["person", "mossbear"], undefined>;
2918
+ /** ISO, when the comment was written. */
2919
+ readonly at: v.StringSchema<undefined>;
2920
+ /** Wrapped in the response's untrusted markers. */
2921
+ readonly body: v.StringSchema<undefined>;
2922
+ }, undefined>;
2923
+ export type CommentEvidenceSessionComment = v.InferOutput<typeof CommentEvidenceSessionCommentSchema>;
2924
+ export declare const CommentEvidenceResponseSchema: v.ObjectSchema<{
2925
+ /** The comment's full id, even when the request named a prefix. */
2926
+ readonly commentId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
2927
+ readonly itemName: v.StringSchema<undefined>;
2928
+ readonly itemPath: v.NullableSchema<v.StringSchema<undefined>, undefined>;
2929
+ readonly tier: v.PicklistSchema<["observed", "usage", "practice"], undefined>;
2930
+ /** One line saying how the finding is known; server-written, outside the markers. */
2931
+ readonly tierLine: v.StringSchema<undefined>;
2932
+ /** What the drafter did not read; server-written, outside the markers. */
2933
+ readonly blindSpot: v.StringSchema<undefined>;
2934
+ /** What goes wrong, wrapped in the response's untrusted markers. */
2935
+ readonly claim: v.StringSchema<undefined>;
2936
+ /** What future sessions should show if the finding is fixed, wrapped; null if none. */
2937
+ readonly prediction: v.NullableSchema<v.StringSchema<undefined>, undefined>;
2938
+ /** A usage finding's counts; null on every other tier. */
2939
+ readonly usage: v.NullableSchema<v.ObjectSchema<{
2940
+ /** The reference's skill-relative path, wrapped in the response's untrusted markers. */
2941
+ readonly path: v.StringSchema<undefined>;
2942
+ /** Eligible loads of the skill. */
2943
+ readonly loads: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>]>;
2944
+ /** Distinct sessions those loads span. */
2945
+ readonly sessions: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>]>;
2946
+ /** Loads followed by a successful read of the reference. */
2947
+ readonly loadsWithRead: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>]>;
2948
+ }, undefined>, undefined>;
2949
+ /** A practice finding's rubric check; null on every other tier. */
2950
+ readonly practice: v.NullableSchema<v.ObjectSchema<{
2951
+ readonly check: v.ObjectSchema<{
2952
+ readonly id: v.StringSchema<undefined>;
2953
+ readonly name: v.StringSchema<undefined>;
2954
+ }, undefined>;
2955
+ readonly rubricVersion: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>]>;
2956
+ readonly practices: v.OptionalSchema<v.ArraySchema<v.ObjectSchema<{
2957
+ readonly text: v.StringSchema<undefined>;
2958
+ readonly source: v.ObjectSchema<{
2959
+ readonly title: v.StringSchema<undefined>;
2960
+ readonly url: v.StringSchema<undefined>;
2961
+ }, undefined>;
2962
+ }, undefined>, undefined>, readonly []>;
2963
+ readonly facts: v.OptionalSchema<v.ArraySchema<v.StringSchema<undefined>, undefined>, readonly []>;
2964
+ readonly answers: v.OptionalSchema<v.ArraySchema<v.ObjectSchema<{
2965
+ readonly item: v.StringSchema<undefined>;
2966
+ readonly answer: v.StringSchema<undefined>;
2967
+ }, undefined>, undefined>, readonly []>;
2968
+ }, undefined>, undefined>;
2969
+ readonly citations: v.ArraySchema<v.ObjectSchema<{
2970
+ /**
2971
+ * `navigation` is a skill load counted when a finding was drafted from how
2972
+ * the skill's files were read: evidence of how a skill was used, not of a
2973
+ * failure. `action` is a recorded step of a workflow repeated across
2974
+ * sessions. A server sends it only to a client that names a version new
2975
+ * enough to parse it.
2976
+ */
2977
+ readonly kind: v.PicklistSchema<["verdict", "turn", "navigation", "action"], undefined>;
2978
+ readonly sessionId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
2979
+ /** ISO, when the verdict was graded, the turn was said, the skill loaded, or the action was recorded. */
2980
+ readonly at: v.StringSchema<undefined>;
2981
+ /** Wrapped in the response's untrusted markers. */
2982
+ readonly excerpt: v.StringSchema<undefined>;
2983
+ }, undefined>, undefined>;
2984
+ readonly citationsWithheld: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>]>;
2985
+ /**
2986
+ * Comments on the cited sessions, newest first, wrapped in the untrusted
2987
+ * markers. Defaulted so a response from a server that predates the field
2988
+ * still parses.
2989
+ */
2990
+ readonly sessionComments: v.OptionalSchema<v.ArraySchema<v.ObjectSchema<{
2991
+ readonly sessionId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
2992
+ /** Only the person's own notes are sent today; `mossbear` is reserved. */
2993
+ readonly authorKind: v.PicklistSchema<["person", "mossbear"], undefined>;
2994
+ /** ISO, when the comment was written. */
2995
+ readonly at: v.StringSchema<undefined>;
2996
+ /** Wrapped in the response's untrusted markers. */
2997
+ readonly body: v.StringSchema<undefined>;
2998
+ }, undefined>, undefined>, readonly []>;
2999
+ /**
3000
+ * Comments on the cited sessions that were left out to keep the response
3001
+ * bounded (the newest few per session are sent), so a short list is never
3002
+ * mistaken for the whole of it. Zero when none were.
3003
+ */
3004
+ readonly sessionCommentsWithheld: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>]>, 0>;
3005
+ readonly untrusted: v.ObjectSchema<{
3006
+ readonly token: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
3007
+ readonly startMarker: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
3008
+ readonly endMarker: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
3009
+ readonly note: v.StringSchema<undefined>;
3010
+ }, undefined>;
4536
3011
  }, undefined>;
3012
+ export type CommentEvidenceResponse = v.InferOutput<typeof CommentEvidenceResponseSchema>;
4537
3013
  export declare const CaptureIdSchema: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 8, "id must be at least 8 characters">, v.MaxLengthAction<string, 128, undefined>, v.RegexAction<string, "id must contain only letters, digits, underscore, dot or hyphen">]>;
4538
3014
  export declare const InboxCaptureRequestSchema: v.ObjectSchema<{
4539
3015
  /**
@@ -4625,24 +3101,7 @@ export declare const ArtifactVersionDetailSchema: v.ObjectSchema<{
4625
3101
  readonly createdAt: v.StringSchema<undefined>;
4626
3102
  }, undefined>;
4627
3103
  /** The item routes' names for the version schemas, kept while those routes are served. */
4628
- export declare const 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<{
3104
+ export declare const BundleArtifactVersionsResponseSchema: v.ObjectSchema<{
4646
3105
  readonly versions: v.ArraySchema<v.ObjectSchema<{
4647
3106
  readonly id: v.StringSchema<undefined>;
4648
3107
  readonly version: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>;
@@ -4653,17 +3112,6 @@ export declare const ContextItemVersionsResponseSchema: v.ObjectSchema<{
4653
3112
  }, undefined>, undefined>;
4654
3113
  readonly nextCursor: v.NullableSchema<v.NumberSchema<undefined>, undefined>;
4655
3114
  }, undefined>;
4656
- export declare const ContextItemVersionResponseSchema: v.ObjectSchema<{
4657
- readonly version: v.ObjectSchema<{
4658
- readonly id: v.StringSchema<undefined>;
4659
- readonly version: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>;
4660
- readonly content: v.NullableSchema<v.StringSchema<undefined>, undefined>;
4661
- readonly contentHash: v.StringSchema<undefined>;
4662
- readonly authorType: v.StringSchema<undefined>;
4663
- readonly metadata: v.OptionalSchema<v.NullableSchema<v.RecordSchema<v.StringSchema<undefined>, v.UnknownSchema, undefined>, undefined>, undefined>;
4664
- readonly createdAt: v.StringSchema<undefined>;
4665
- }, undefined>;
4666
- }, undefined>;
4667
3115
  /** Default and max page size for the version-history list endpoint. */
4668
3116
  export declare const DEFAULT_VERSIONS_LIMIT = 50;
4669
3117
  export declare const MAX_VERSIONS_LIMIT = 200;
@@ -8123,27 +6571,18 @@ export declare const SEARCH_COMMENT_AUTHOR_KINDS: readonly ["person", "agent", "
8123
6571
  export declare const SearchCommentAuthorKindSchema: v.PicklistSchema<readonly ["person", "agent", "mossbear"], undefined>;
8124
6572
  export type SearchCommentAuthorKind = v.InferOutput<typeof SearchCommentAuthorKindSchema>;
8125
6573
  /**
8126
- * What a comment is attached to. `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.
6574
+ * What a comment is attached to. `artifact` is a guide or a document; `session`
6575
+ * is a run the caller made. Session comments are the caller's own and never reach
6576
+ * a workspace-mate.
8129
6577
  */
8130
- export declare const SEARCH_COMMENT_SUBJECT_KINDS: readonly ["item", "session"];
8131
- export declare const SearchCommentSubjectKindSchema: v.PicklistSchema<readonly ["item", "session"], undefined>;
8132
- export type SearchCommentSubjectKind = v.InferOutput<typeof SearchCommentSubjectKindSchema>;
8133
6578
  /**
8134
6579
  * The subject kinds a client names in a search: `artifact`, never its older
8135
6580
  * name `item`.
8136
6581
  */
8137
6582
  export declare const SEARCH_COMMENT_SUBJECT_KIND_NAMES: readonly ["artifact", "session"];
8138
- export 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>;
6583
+ export declare const SearchCommentSubjectKindFilterSchema: v.PicklistSchema<readonly ["artifact", "session"], undefined>;
8146
6584
  export type SearchCommentSubjectKindFilter = v.InferOutput<typeof SearchCommentSubjectKindFilterSchema>;
6585
+ export type SearchCommentSubjectKindName = (typeof SEARCH_COMMENT_SUBJECT_KIND_NAMES)[number];
8147
6586
  /**
8148
6587
  * What a user turn was, as the session classifier labels it. The same
8149
6588
  * vocabulary the classifier writes; a `turns` search may keep only some.
@@ -8198,7 +6637,7 @@ export declare const SearchRequestObjectSchema: v.ObjectSchema<{
8198
6637
  * Restrict the `comments` corpus to comments on these kinds of subject. Does
8199
6638
  * not touch other corpora.
8200
6639
  */
8201
- readonly subjectKinds: v.OptionalSchema<v.SchemaWithPipe<readonly [v.ArraySchema<v.PicklistSchema<readonly ["item", "session", "artifact"], undefined>, undefined>, v.MinLengthAction<("item" | "artifact" | "session")[], 1, undefined>]>, undefined>;
6640
+ readonly subjectKinds: v.OptionalSchema<v.SchemaWithPipe<readonly [v.ArraySchema<v.PicklistSchema<readonly ["artifact", "session"], undefined>, undefined>, v.MinLengthAction<("artifact" | "session")[], 1, undefined>]>, undefined>;
8202
6641
  /**
8203
6642
  * Restrict the `turns` corpus to turns the classifier gave one of these
8204
6643
  * labels. A turn with no label never matches. Does not touch other corpora.
@@ -8268,7 +6707,7 @@ export declare const SearchRequestSchema: v.SchemaWithPipe<readonly [v.ObjectSch
8268
6707
  * Restrict the `comments` corpus to comments on these kinds of subject. Does
8269
6708
  * not touch other corpora.
8270
6709
  */
8271
- readonly subjectKinds: v.OptionalSchema<v.SchemaWithPipe<readonly [v.ArraySchema<v.PicklistSchema<readonly ["item", "session", "artifact"], undefined>, undefined>, v.MinLengthAction<("item" | "artifact" | "session")[], 1, undefined>]>, undefined>;
6710
+ readonly subjectKinds: v.OptionalSchema<v.SchemaWithPipe<readonly [v.ArraySchema<v.PicklistSchema<readonly ["artifact", "session"], undefined>, undefined>, v.MinLengthAction<("artifact" | "session")[], 1, undefined>]>, undefined>;
8272
6711
  /**
8273
6712
  * Restrict the `turns` corpus to turns the classifier gave one of these
8274
6713
  * labels. A turn with no label never matches. Does not touch other corpora.
@@ -8303,7 +6742,7 @@ export declare const SearchRequestSchema: v.SchemaWithPipe<readonly [v.ObjectSch
8303
6742
  [x: string]: string;
8304
6743
  } | undefined;
8305
6744
  authorKinds?: ("agent" | "person" | "mossbear")[] | undefined;
8306
- subjectKinds?: ("item" | "artifact" | "session")[] | undefined;
6745
+ subjectKinds?: ("artifact" | "session")[] | undefined;
8307
6746
  steeringLabels?: ("correction" | "steering" | "new request" | "acknowledgement" | "insufficient evidence")[] | undefined;
8308
6747
  headSha?: string | undefined;
8309
6748
  branch?: string | undefined;
@@ -8320,7 +6759,7 @@ export declare const SearchRequestSchema: v.SchemaWithPipe<readonly [v.ObjectSch
8320
6759
  [x: string]: string;
8321
6760
  } | undefined;
8322
6761
  authorKinds?: ("agent" | "person" | "mossbear")[] | undefined;
8323
- subjectKinds?: ("item" | "artifact" | "session")[] | undefined;
6762
+ subjectKinds?: ("artifact" | "session")[] | undefined;
8324
6763
  steeringLabels?: ("correction" | "steering" | "new request" | "acknowledgement" | "insufficient evidence")[] | undefined;
8325
6764
  headSha?: string | undefined;
8326
6765
  branch?: string | undefined;
@@ -8337,7 +6776,7 @@ export declare const SearchRequestSchema: v.SchemaWithPipe<readonly [v.ObjectSch
8337
6776
  [x: string]: string;
8338
6777
  } | undefined;
8339
6778
  authorKinds?: ("agent" | "person" | "mossbear")[] | undefined;
8340
- subjectKinds?: ("item" | "artifact" | "session")[] | undefined;
6779
+ subjectKinds?: ("artifact" | "session")[] | undefined;
8341
6780
  steeringLabels?: ("correction" | "steering" | "new request" | "acknowledgement" | "insufficient evidence")[] | undefined;
8342
6781
  headSha?: string | undefined;
8343
6782
  branch?: string | undefined;
@@ -8354,7 +6793,7 @@ export declare const SearchRequestSchema: v.SchemaWithPipe<readonly [v.ObjectSch
8354
6793
  [x: string]: string;
8355
6794
  } | undefined;
8356
6795
  authorKinds?: ("agent" | "person" | "mossbear")[] | undefined;
8357
- subjectKinds?: ("item" | "artifact" | "session")[] | undefined;
6796
+ subjectKinds?: ("artifact" | "session")[] | undefined;
8358
6797
  steeringLabels?: ("correction" | "steering" | "new request" | "acknowledgement" | "insufficient evidence")[] | undefined;
8359
6798
  headSha?: string | undefined;
8360
6799
  branch?: string | undefined;
@@ -8371,7 +6810,7 @@ export declare const SearchRequestSchema: v.SchemaWithPipe<readonly [v.ObjectSch
8371
6810
  [x: string]: string;
8372
6811
  } | undefined;
8373
6812
  authorKinds?: ("agent" | "person" | "mossbear")[] | undefined;
8374
- subjectKinds?: ("item" | "artifact" | "session")[] | undefined;
6813
+ subjectKinds?: ("artifact" | "session")[] | undefined;
8375
6814
  steeringLabels?: ("correction" | "steering" | "new request" | "acknowledgement" | "insufficient evidence")[] | undefined;
8376
6815
  headSha?: string | undefined;
8377
6816
  branch?: string | undefined;
@@ -8388,7 +6827,7 @@ export declare const SearchRequestSchema: v.SchemaWithPipe<readonly [v.ObjectSch
8388
6827
  [x: string]: string;
8389
6828
  } | undefined;
8390
6829
  authorKinds?: ("agent" | "person" | "mossbear")[] | undefined;
8391
- subjectKinds?: ("item" | "artifact" | "session")[] | undefined;
6830
+ subjectKinds?: ("artifact" | "session")[] | undefined;
8392
6831
  steeringLabels?: ("correction" | "steering" | "new request" | "acknowledgement" | "insufficient evidence")[] | undefined;
8393
6832
  headSha?: string | undefined;
8394
6833
  branch?: string | undefined;
@@ -8482,8 +6921,8 @@ export type SearchContentHit = v.InferOutput<typeof SearchContentHitSchema>;
8482
6921
  * A comment on a guide or document that matched. `body` and `itemName` and
8483
6922
  * `workspaceName` are wrapped in `untrusted`'s markers.
8484
6923
  */
8485
- export declare const SearchItemCommentHitSchema: v.ObjectSchema<{
8486
- readonly subjectKind: v.LiteralSchema<"item", undefined>;
6924
+ export declare const SearchArtifactCommentHitSchema: v.ObjectSchema<{
6925
+ readonly subjectKind: v.LiteralSchema<"artifact", undefined>;
8487
6926
  readonly itemId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
8488
6927
  /**
8489
6928
  * The guide the item belongs to, or null for a standalone document. A comment
@@ -8533,44 +6972,6 @@ export declare const SearchSessionCommentHitSchema: v.ObjectSchema<{
8533
6972
  readonly url: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
8534
6973
  readonly excerpt: v.StringSchema<undefined>;
8535
6974
  }, undefined>;
8536
- /**
8537
- * The same hit under the new name for its subject (one-artifact Stage 3): a
8538
- * client reads either until every server sends `artifact`.
8539
- */
8540
- export declare const SearchArtifactCommentHitSchema: v.ObjectSchema<{
8541
- readonly subjectKind: v.LiteralSchema<"artifact", undefined>;
8542
- readonly itemId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
8543
- /**
8544
- * The guide the item belongs to, or null for a standalone document. A comment
8545
- * on a guide sits on its body file, so this is the id the dashboard's guide
8546
- * page takes; `itemId` is the one a document page takes.
8547
- */
8548
- readonly guideId: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>;
8549
- /** Wrapped in `untrusted`'s markers; null when the item has no name. */
8550
- readonly itemName: v.NullableSchema<v.StringSchema<undefined>, undefined>;
8551
- readonly workspaceId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
8552
- /** Wrapped in `untrusted`'s markers. */
8553
- readonly workspaceName: v.StringSchema<undefined>;
8554
- /** Whether the item has been edited since the comment was written. */
8555
- readonly itemChangedSince: v.BooleanSchema<undefined>;
8556
- /**
8557
- * Whether the match is in the comment's text or in the replacement it
8558
- * suggests (Mossbear's drafted edits).
8559
- */
8560
- readonly matchedIn: v.PicklistSchema<["body", "suggestion"], undefined>;
8561
- /**
8562
- * A Mossbear suggestion's draft state: whether its owner has handed it to
8563
- * their agents. Absent on a person's or an agent's comment and on a reply.
8564
- */
8565
- readonly approved: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
8566
- readonly commentId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
8567
- readonly threadId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
8568
- readonly authorKind: v.PicklistSchema<readonly ["person", "agent", "mossbear"], undefined>;
8569
- readonly resolved: v.BooleanSchema<undefined>;
8570
- readonly createdAt: v.StringSchema<undefined>;
8571
- readonly url: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
8572
- readonly excerpt: v.StringSchema<undefined>;
8573
- }, undefined>;
8574
6975
  export declare const SearchCommentHitSchema: v.VariantSchema<"subjectKind", [v.ObjectSchema<{
8575
6976
  readonly subjectKind: v.LiteralSchema<"artifact", undefined>;
8576
6977
  readonly itemId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
@@ -8604,39 +7005,6 @@ export declare const SearchCommentHitSchema: v.VariantSchema<"subjectKind", [v.O
8604
7005
  readonly createdAt: v.StringSchema<undefined>;
8605
7006
  readonly url: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
8606
7007
  readonly excerpt: v.StringSchema<undefined>;
8607
- }, undefined>, v.ObjectSchema<{
8608
- readonly subjectKind: v.LiteralSchema<"item", undefined>;
8609
- readonly itemId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
8610
- /**
8611
- * The guide the item belongs to, or null for a standalone document. A comment
8612
- * on a guide sits on its body file, so this is the id the dashboard's guide
8613
- * page takes; `itemId` is the one a document page takes.
8614
- */
8615
- readonly guideId: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>;
8616
- /** Wrapped in `untrusted`'s markers; null when the item has no name. */
8617
- readonly itemName: v.NullableSchema<v.StringSchema<undefined>, undefined>;
8618
- readonly workspaceId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
8619
- /** Wrapped in `untrusted`'s markers. */
8620
- readonly workspaceName: v.StringSchema<undefined>;
8621
- /** Whether the item has been edited since the comment was written. */
8622
- readonly itemChangedSince: v.BooleanSchema<undefined>;
8623
- /**
8624
- * Whether the match is in the comment's text or in the replacement it
8625
- * suggests (Mossbear's drafted edits).
8626
- */
8627
- readonly matchedIn: v.PicklistSchema<["body", "suggestion"], undefined>;
8628
- /**
8629
- * A Mossbear suggestion's draft state: whether its owner has handed it to
8630
- * their agents. Absent on a person's or an agent's comment and on a reply.
8631
- */
8632
- readonly approved: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
8633
- readonly commentId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
8634
- readonly threadId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
8635
- readonly authorKind: v.PicklistSchema<readonly ["person", "agent", "mossbear"], undefined>;
8636
- readonly resolved: v.BooleanSchema<undefined>;
8637
- readonly createdAt: v.StringSchema<undefined>;
8638
- readonly url: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
8639
- readonly excerpt: v.StringSchema<undefined>;
8640
7008
  }, undefined>, v.ObjectSchema<{
8641
7009
  readonly subjectKind: v.LiteralSchema<"session", undefined>;
8642
7010
  readonly sessionId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
@@ -8649,7 +7017,7 @@ export declare const SearchCommentHitSchema: v.VariantSchema<"subjectKind", [v.O
8649
7017
  readonly url: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
8650
7018
  readonly excerpt: v.StringSchema<undefined>;
8651
7019
  }, undefined>], undefined>;
8652
- export type SearchItemCommentHit = v.InferOutput<typeof SearchItemCommentHitSchema>;
7020
+ export type SearchArtifactCommentHit = v.InferOutput<typeof SearchArtifactCommentHitSchema>;
8653
7021
  export type SearchSessionCommentHit = v.InferOutput<typeof SearchSessionCommentHitSchema>;
8654
7022
  export type SearchCommentHit = v.InferOutput<typeof SearchCommentHitSchema>;
8655
7023
  /**
@@ -8796,65 +7164,32 @@ export declare const SearchContentReportSchema: v.VariantSchema<"status", [v.Obj
8796
7164
  /** Wrapped in `untrusted`'s markers. */
8797
7165
  readonly workspaceName: v.StringSchema<undefined>;
8798
7166
  /**
8799
- * Slugs of the bundles that hold the item and that the caller may read — the
8800
- * argument `pull_bundle` takes to read the whole document. Never more than
8801
- * a scoped caller's allowlist reaches.
8802
- */
8803
- readonly bundles: v.ArraySchema<v.StringSchema<undefined>, undefined>;
8804
- readonly updatedAt: v.StringSchema<undefined>;
8805
- /**
8806
- * Where the item opens on the dashboard. Added by the CLI, which knows the
8807
- * dashboard's address; the server does not send it.
8808
- */
8809
- readonly url: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
8810
- /** A window around the match, wrapped in `untrusted`'s markers. */
8811
- readonly excerpt: v.StringSchema<undefined>;
8812
- }, undefined>, undefined>;
8813
- }, undefined>, v.ObjectSchema<{
8814
- readonly status: v.LiteralSchema<"skipped", undefined>;
8815
- readonly reason: v.PicklistSchema<["excluded-by-caller", "timed-out", "not-granted", "not-yet-searchable"], undefined>;
8816
- }, undefined>], undefined>;
8817
- export declare const SearchCommentsReportSchema: v.VariantSchema<"status", [v.ObjectSchema<{
8818
- readonly status: v.LiteralSchema<"searched", undefined>;
8819
- /** Every match in scope, counted past the returned page. */
8820
- readonly total: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
8821
- readonly narrowedBy: v.NullableSchema<v.PicklistSchema<["narrowed-by-bundle-allowlist"], undefined>, undefined>;
8822
- /** Newest first, at most the request's limit. */
8823
- readonly hits: v.ArraySchema<v.VariantSchema<"subjectKind", [v.ObjectSchema<{
8824
- readonly subjectKind: v.LiteralSchema<"artifact", undefined>;
8825
- readonly itemId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
8826
- /**
8827
- * The guide the item belongs to, or null for a standalone document. A comment
8828
- * on a guide sits on its body file, so this is the id the dashboard's guide
8829
- * page takes; `itemId` is the one a document page takes.
8830
- */
8831
- readonly guideId: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>;
8832
- /** Wrapped in `untrusted`'s markers; null when the item has no name. */
8833
- readonly itemName: v.NullableSchema<v.StringSchema<undefined>, undefined>;
8834
- readonly workspaceId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
8835
- /** Wrapped in `untrusted`'s markers. */
8836
- readonly workspaceName: v.StringSchema<undefined>;
8837
- /** Whether the item has been edited since the comment was written. */
8838
- readonly itemChangedSince: v.BooleanSchema<undefined>;
8839
- /**
8840
- * Whether the match is in the comment's text or in the replacement it
8841
- * suggests (Mossbear's drafted edits).
7167
+ * Slugs of the bundles that hold the item and that the caller may read — the
7168
+ * argument `pull_bundle` takes to read the whole document. Never more than
7169
+ * a scoped caller's allowlist reaches.
8842
7170
  */
8843
- readonly matchedIn: v.PicklistSchema<["body", "suggestion"], undefined>;
7171
+ readonly bundles: v.ArraySchema<v.StringSchema<undefined>, undefined>;
7172
+ readonly updatedAt: v.StringSchema<undefined>;
8844
7173
  /**
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.
7174
+ * Where the item opens on the dashboard. Added by the CLI, which knows the
7175
+ * dashboard's address; the server does not send it.
8847
7176
  */
8848
- readonly approved: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
8849
- readonly commentId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
8850
- readonly threadId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
8851
- readonly authorKind: v.PicklistSchema<readonly ["person", "agent", "mossbear"], undefined>;
8852
- readonly resolved: v.BooleanSchema<undefined>;
8853
- readonly createdAt: v.StringSchema<undefined>;
8854
7177
  readonly url: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
7178
+ /** A window around the match, wrapped in `untrusted`'s markers. */
8855
7179
  readonly excerpt: v.StringSchema<undefined>;
8856
- }, undefined>, v.ObjectSchema<{
8857
- readonly subjectKind: v.LiteralSchema<"item", undefined>;
7180
+ }, undefined>, undefined>;
7181
+ }, undefined>, v.ObjectSchema<{
7182
+ readonly status: v.LiteralSchema<"skipped", undefined>;
7183
+ readonly reason: v.PicklistSchema<["excluded-by-caller", "timed-out", "not-granted", "not-yet-searchable"], undefined>;
7184
+ }, undefined>], undefined>;
7185
+ export declare const SearchCommentsReportSchema: v.VariantSchema<"status", [v.ObjectSchema<{
7186
+ readonly status: v.LiteralSchema<"searched", undefined>;
7187
+ /** Every match in scope, counted past the returned page. */
7188
+ readonly total: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
7189
+ readonly narrowedBy: v.NullableSchema<v.PicklistSchema<["narrowed-by-bundle-allowlist"], undefined>, undefined>;
7190
+ /** Newest first, at most the request's limit. */
7191
+ readonly hits: v.ArraySchema<v.VariantSchema<"subjectKind", [v.ObjectSchema<{
7192
+ readonly subjectKind: v.LiteralSchema<"artifact", undefined>;
8858
7193
  readonly itemId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
8859
7194
  /**
8860
7195
  * The guide the item belongs to, or null for a standalone document. A comment
@@ -9128,39 +7463,6 @@ export declare const SearchResponseSchema: v.ObjectSchema<{
9128
7463
  readonly createdAt: v.StringSchema<undefined>;
9129
7464
  readonly url: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
9130
7465
  readonly excerpt: v.StringSchema<undefined>;
9131
- }, undefined>, v.ObjectSchema<{
9132
- readonly subjectKind: v.LiteralSchema<"item", undefined>;
9133
- readonly itemId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
9134
- /**
9135
- * The guide the item belongs to, or null for a standalone document. A comment
9136
- * on a guide sits on its body file, so this is the id the dashboard's guide
9137
- * page takes; `itemId` is the one a document page takes.
9138
- */
9139
- readonly guideId: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>;
9140
- /** Wrapped in `untrusted`'s markers; null when the item has no name. */
9141
- readonly itemName: v.NullableSchema<v.StringSchema<undefined>, undefined>;
9142
- readonly workspaceId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
9143
- /** Wrapped in `untrusted`'s markers. */
9144
- readonly workspaceName: v.StringSchema<undefined>;
9145
- /** Whether the item has been edited since the comment was written. */
9146
- readonly itemChangedSince: v.BooleanSchema<undefined>;
9147
- /**
9148
- * Whether the match is in the comment's text or in the replacement it
9149
- * suggests (Mossbear's drafted edits).
9150
- */
9151
- readonly matchedIn: v.PicklistSchema<["body", "suggestion"], undefined>;
9152
- /**
9153
- * A Mossbear suggestion's draft state: whether its owner has handed it to
9154
- * their agents. Absent on a person's or an agent's comment and on a reply.
9155
- */
9156
- readonly approved: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
9157
- readonly commentId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
9158
- readonly threadId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
9159
- readonly authorKind: v.PicklistSchema<readonly ["person", "agent", "mossbear"], undefined>;
9160
- readonly resolved: v.BooleanSchema<undefined>;
9161
- readonly createdAt: v.StringSchema<undefined>;
9162
- readonly url: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
9163
- readonly excerpt: v.StringSchema<undefined>;
9164
7466
  }, undefined>, v.ObjectSchema<{
9165
7467
  readonly subjectKind: v.LiteralSchema<"session", undefined>;
9166
7468
  readonly sessionId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
@@ -9351,371 +7653,93 @@ export declare function parseWorkspaceListResponse(data: unknown): {
9351
7653
  workspaces: {
9352
7654
  id: string;
9353
7655
  name: string;
9354
- slug: string;
9355
- role: string;
9356
- isDefault: boolean;
9357
- }[];
9358
- };
9359
- export declare function parseCreateScopedTokenRequest(data: unknown): {
9360
- label: string;
9361
- grants: {
9362
- bundleId: string;
9363
- access: "read" | "write";
9364
- }[];
9365
- };
9366
- export declare function parseRevokeScopedTokenRequest(data: unknown): {
9367
- id: string;
9368
- };
9369
- export declare function parseCreateBundleRequest(data: unknown): {
9370
- slug: string;
9371
- name: string;
9372
- };
9373
- export declare function parseCreateBundleResponse(data: unknown): {
9374
- bundle: {
9375
- id: string;
9376
- slug: string;
9377
- name: string;
9378
- createdAt: string;
9379
- home?: string | undefined;
9380
- };
9381
- };
9382
- export declare function parseAttachBundleMemberRequest(data: unknown): {
9383
- itemId: string;
9384
- };
9385
- export declare function parseAttachBundleMemberResponse(data: unknown): {
9386
- attached: boolean;
9387
- };
9388
- export declare function parseDetachBundleMemberResponse(data: unknown): {
9389
- detached: boolean;
9390
- };
9391
- export declare function parseSubscribeBundleRequest(data: unknown): {
9392
- bundleId: string;
9393
- deliver?: "global" | "repo" | null | undefined;
9394
- muted?: string[] | undefined;
9395
- };
9396
- export declare function parseSubscribeBundleResponse(data: unknown): {
9397
- bundleId: string;
9398
- created: boolean;
9399
- deliver?: "global" | "repo" | undefined;
9400
- muted?: string[] | undefined;
9401
- };
9402
- export declare function parseResolveSubscriptionsRequest(data: unknown): {
9403
- repoBundleIds: string[];
9404
- };
9405
- export declare function parseResolveSubscriptionsResponse(data: unknown): {
9406
- bundles: {
9407
- id: string;
9408
- slug: string;
9409
- name: string;
9410
- scopes: ("repo" | "user")[];
9411
- deliver?: "global" | "repo" | undefined;
9412
- home?: string | undefined;
9413
- muted?: string[] | undefined;
9414
- }[];
9415
- unresolved: {
9416
- id: string;
9417
- }[];
9418
- account?: {
9419
- deliverGlobalSkills: boolean;
9420
- } | undefined;
9421
- limitedToken?: boolean | undefined;
9422
- };
9423
- export declare function parseUpdateBundleRequest(data: unknown): {
9424
- name?: string | undefined;
9425
- home?: string | null | undefined;
9426
- };
9427
- export declare function parseUpdateBundleResponse(data: unknown): {
9428
- bundle: {
9429
- id: string;
9430
- slug: string;
9431
- name: string;
9432
- createdAt: string;
9433
- home?: string | undefined;
9434
- };
9435
- };
9436
- export declare function parseDeleteBundleResponse(data: unknown): {
9437
- deleted: boolean;
9438
- };
9439
- export declare function parseContextItem(data: unknown): {
9440
- type: string;
9441
- id: string;
9442
- artifactId?: string | null | undefined;
9443
- name: string;
9444
- role: string | null;
9445
- format: string | null;
9446
- content: string | null;
9447
- origin?: string | null | undefined;
9448
- version?: number | undefined;
9449
- guideId?: string | null | undefined;
9450
- root?: "project" | "global" | null | undefined;
9451
- path?: string | null | undefined;
9452
- projectId?: string | null | undefined;
9453
- pathProjectId?: string | null | undefined;
9454
- aliases?: {
9455
- root: "project" | "global";
9456
- path: string;
9457
- }[] | undefined;
9458
- comments?: {
9459
- id: string;
9460
- state?: "open" | "resolved" | undefined;
9461
- passage?: {
9462
- quote: string;
9463
- status: "located" | "changed" | "orphaned";
9464
- lines: {
9465
- start: number;
9466
- end: number;
9467
- } | null;
9468
- } | undefined;
9469
- body: string;
9470
- suggestion?: string | undefined;
9471
- finding?: {
9472
- tier: "observed" | "usage" | "practice";
9473
- tierLine: string;
9474
- blindSpot: string;
9475
- prediction: string | null;
9476
- } | undefined;
9477
- approved?: boolean | undefined;
9478
- authorName: string | null;
9479
- createdAt: string;
9480
- itemVersion: number;
9481
- itemChangedSince: boolean;
9482
- deliveredCount: number;
9483
- threadId: string;
9484
- replyToId: string | null;
9485
- }[] | undefined;
9486
- updatedAt: string;
9487
- gitSource?: {
9488
- projectId: string;
9489
- commitSha: string;
9490
- branch?: string | undefined;
9491
- } | null | undefined;
9492
- removed?: true | undefined;
9493
- };
9494
- export declare function parseContextItemsResponse(data: unknown): {
9495
- items: {
9496
- type: string;
9497
- id: string;
9498
- artifactId?: string | null | undefined;
9499
- name: string;
9500
- role: string | null;
9501
- format: string | null;
9502
- content: string | null;
9503
- origin?: string | null | undefined;
9504
- version?: number | undefined;
9505
- guideId?: string | null | undefined;
9506
- root?: "project" | "global" | null | undefined;
9507
- path?: string | null | undefined;
9508
- projectId?: string | null | undefined;
9509
- pathProjectId?: string | null | undefined;
9510
- aliases?: {
9511
- root: "project" | "global";
9512
- path: string;
9513
- }[] | undefined;
9514
- comments?: {
9515
- id: string;
9516
- state?: "open" | "resolved" | undefined;
9517
- passage?: {
9518
- quote: string;
9519
- status: "located" | "changed" | "orphaned";
9520
- lines: {
9521
- start: number;
9522
- end: number;
9523
- } | null;
9524
- } | undefined;
9525
- body: string;
9526
- suggestion?: string | undefined;
9527
- finding?: {
9528
- tier: "observed" | "usage" | "practice";
9529
- tierLine: string;
9530
- blindSpot: string;
9531
- prediction: string | null;
9532
- } | undefined;
9533
- approved?: boolean | undefined;
9534
- authorName: string | null;
9535
- createdAt: string;
9536
- itemVersion: number;
9537
- itemChangedSince: boolean;
9538
- deliveredCount: number;
9539
- threadId: string;
9540
- replyToId: string | null;
9541
- }[] | undefined;
9542
- updatedAt: string;
9543
- gitSource?: {
9544
- projectId: string;
9545
- commitSha: string;
9546
- branch?: string | undefined;
9547
- } | null | undefined;
9548
- removed?: true | undefined;
7656
+ slug: string;
7657
+ role: string;
7658
+ isDefault: boolean;
7659
+ }[];
7660
+ };
7661
+ export declare function parseCreateScopedTokenRequest(data: unknown): {
7662
+ label: string;
7663
+ grants: {
7664
+ bundleId: string;
7665
+ access: "read" | "write";
9549
7666
  }[];
9550
- untrusted?: {
9551
- token: string;
9552
- startMarker: string;
9553
- endMarker: string;
9554
- note: string;
9555
- } | null | undefined;
9556
7667
  };
9557
- export declare function parsePushContextRequest(data: unknown): {
7668
+ export declare function parseRevokeScopedTokenRequest(data: unknown): {
7669
+ id: string;
7670
+ };
7671
+ export declare function parseCreateBundleRequest(data: unknown): {
7672
+ slug: string;
9558
7673
  name: string;
9559
- contentType: "content" | "asset";
9560
- content: string;
9561
- itemId?: string | undefined;
9562
- origin?: string | null | undefined;
9563
- sourceItemIds?: string[] | undefined;
9564
- path?: string | null | undefined;
9565
- projectId?: string | undefined;
9566
- gitSource?: {
9567
- projectId: string;
9568
- commitSha: string;
9569
- branch?: string | undefined;
9570
- } | undefined;
9571
7674
  };
9572
- export declare function parsePushContextResponse(data: unknown): {
9573
- item: {
9574
- type: string;
7675
+ export declare function parseCreateBundleResponse(data: unknown): {
7676
+ bundle: {
9575
7677
  id: string;
9576
- artifactId?: string | null | undefined;
7678
+ slug: string;
9577
7679
  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;
7680
+ createdAt: string;
7681
+ home?: string | undefined;
9627
7682
  };
7683
+ };
7684
+ export declare function parseAttachBundleMemberRequest(data: unknown): {
7685
+ artifactId: string;
7686
+ };
7687
+ export declare function parseAttachBundleMemberResponse(data: unknown): {
7688
+ attached: boolean;
7689
+ };
7690
+ export declare function parseDetachBundleMemberResponse(data: unknown): {
7691
+ detached: boolean;
7692
+ };
7693
+ export declare function parseSubscribeBundleRequest(data: unknown): {
7694
+ bundleId: string;
7695
+ deliver?: "global" | "repo" | null | undefined;
7696
+ muted?: string[] | undefined;
7697
+ };
7698
+ export declare function parseSubscribeBundleResponse(data: unknown): {
7699
+ bundleId: string;
9628
7700
  created: boolean;
7701
+ deliver?: "global" | "repo" | undefined;
7702
+ muted?: string[] | undefined;
9629
7703
  };
9630
- export declare function 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;
7704
+ export declare function parseResolveSubscriptionsRequest(data: unknown): {
7705
+ repoBundleIds: string[];
7706
+ };
7707
+ export declare function parseResolveSubscriptionsResponse(data: unknown): {
7708
+ bundles: {
7709
+ id: string;
7710
+ slug: string;
7711
+ name: string;
7712
+ scopes: ("repo" | "user")[];
7713
+ deliver?: "global" | "repo" | undefined;
7714
+ home?: string | undefined;
7715
+ muted?: string[] | undefined;
7716
+ }[];
7717
+ unresolved: {
7718
+ id: string;
7719
+ }[];
7720
+ account?: {
7721
+ deliverGlobalSkills: boolean;
9642
7722
  } | undefined;
9643
- removed?: true | undefined;
7723
+ limitedToken?: boolean | undefined;
9644
7724
  };
9645
- export declare function parseUpdateContextItemResponse(data: unknown): {
9646
- item: {
9647
- type: string;
7725
+ export declare function parseUpdateBundleRequest(data: unknown): {
7726
+ name?: string | undefined;
7727
+ home?: string | null | undefined;
7728
+ };
7729
+ export declare function parseUpdateBundleResponse(data: unknown): {
7730
+ bundle: {
9648
7731
  id: string;
9649
- artifactId?: string | null | undefined;
7732
+ slug: string;
9650
7733
  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;
7734
+ createdAt: string;
7735
+ home?: string | undefined;
9700
7736
  };
9701
- updated: boolean;
9702
7737
  };
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;
7738
+ export declare function parseDeleteBundleResponse(data: unknown): {
7739
+ deleted: boolean;
9716
7740
  };
9717
- export declare function parseContextItemResponse(data: unknown): {
9718
- item: {
7741
+ export declare function parseContextItemsResponse(data: unknown): {
7742
+ items: {
9719
7743
  type: string;
9720
7744
  id: string;
9721
7745
  artifactId?: string | null | undefined;
@@ -9769,11 +7793,16 @@ export declare function parseContextItemResponse(data: unknown): {
9769
7793
  branch?: string | undefined;
9770
7794
  } | null | undefined;
9771
7795
  removed?: true | undefined;
9772
- };
7796
+ }[];
7797
+ untrusted?: {
7798
+ token: string;
7799
+ startMarker: string;
7800
+ endMarker: string;
7801
+ note: string;
7802
+ } | null | undefined;
9773
7803
  };
9774
- export declare function parseArchiveContextItemResponse(data: unknown): {
9775
- archived: boolean;
9776
- item: {
7804
+ export declare function parseBundleArtifactsResponse(data: unknown): {
7805
+ artifacts: {
9777
7806
  type: string;
9778
7807
  id: string;
9779
7808
  artifactId?: string | null | undefined;
@@ -9827,7 +7856,13 @@ export declare function parseArchiveContextItemResponse(data: unknown): {
9827
7856
  branch?: string | undefined;
9828
7857
  } | null | undefined;
9829
7858
  removed?: true | undefined;
9830
- };
7859
+ }[];
7860
+ untrusted?: {
7861
+ token: string;
7862
+ startMarker: string;
7863
+ endMarker: string;
7864
+ note: string;
7865
+ } | null | undefined;
9831
7866
  };
9832
7867
  export declare function parseInboxCaptureRequest(data: unknown): {
9833
7868
  id?: string | undefined;
@@ -9865,7 +7900,7 @@ export declare function parseInboxListResponse(data: unknown): {
9865
7900
  updatedAt: string;
9866
7901
  }[];
9867
7902
  };
9868
- export declare function parseContextItemVersionsResponse(data: unknown): {
7903
+ export declare function parseBundleArtifactVersionsResponse(data: unknown): {
9869
7904
  versions: {
9870
7905
  id: string;
9871
7906
  version: number;
@@ -9878,19 +7913,6 @@ export declare function parseContextItemVersionsResponse(data: unknown): {
9878
7913
  }[];
9879
7914
  nextCursor: number | null;
9880
7915
  };
9881
- export declare function parseContextItemVersionResponse(data: unknown): {
9882
- version: {
9883
- id: string;
9884
- version: number;
9885
- content: string | null;
9886
- contentHash: string;
9887
- authorType: string;
9888
- metadata?: {
9889
- [x: string]: unknown;
9890
- } | null | undefined;
9891
- createdAt: string;
9892
- };
9893
- };
9894
7916
  export declare function parseInboxArchiveRequest(data: unknown): {
9895
7917
  ids: string[];
9896
7918
  };
@@ -10149,7 +8171,7 @@ export declare function parseAgentCommentResponse(data: unknown): {
10149
8171
  id: string;
10150
8172
  threadId: string;
10151
8173
  subject: {
10152
- kind: "item" | "artifact" | "session";
8174
+ kind: "artifact" | "session";
10153
8175
  id: string;
10154
8176
  };
10155
8177
  body: string;
@@ -10386,23 +8408,6 @@ export declare function parseSearchResponse(data: unknown): {
10386
8408
  total: number;
10387
8409
  narrowedBy: "narrowed-by-bundle-allowlist" | null;
10388
8410
  hits: ({
10389
- subjectKind: "item";
10390
- itemId: string;
10391
- guideId: string | null;
10392
- itemName: string | null;
10393
- workspaceId: string;
10394
- workspaceName: string;
10395
- itemChangedSince: boolean;
10396
- matchedIn: "suggestion" | "body";
10397
- approved?: boolean | undefined;
10398
- commentId: string;
10399
- threadId: string;
10400
- authorKind: "agent" | "person" | "mossbear";
10401
- resolved: boolean;
10402
- createdAt: string;
10403
- url?: string | undefined;
10404
- excerpt: string;
10405
- } | {
10406
8411
  subjectKind: "artifact";
10407
8412
  itemId: string;
10408
8413
  guideId: string | null;