@mossbear/protocol 0.1.0-alpha.87 → 0.1.0-alpha.89

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