@mossbear/protocol 0.1.0-alpha.72 → 0.1.0-alpha.74

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
@@ -1035,6 +1035,28 @@ export type GuideHistoryUntrusted = v.InferOutput<typeof GuideHistoryUntrustedSc
1035
1035
  * never the thing that silently drops a comment a person left.
1036
1036
  */
1037
1037
  export declare const MAX_ITEM_COMMENTS_ON_WIRE = 20;
1038
+ /** What a finding rests on: graded sessions, how loads read a skill, or the rubric alone. */
1039
+ export declare const FindingTierSchema: v.PicklistSchema<["observed", "usage", "practice"], undefined>;
1040
+ export type FindingTier = v.InferOutput<typeof FindingTierSchema>;
1041
+ /**
1042
+ * What a Mossbear finding carries on the comment read, besides its claim.
1043
+ *
1044
+ * `tierLine` and `blindSpot` are written by the server from data it holds —
1045
+ * the cited sessions, the load counts, the rubric check — never by a model, so
1046
+ * they sit outside the response's untrusted markers. `prediction` is
1047
+ * model-authored and arrives inside them. A finding never carries replacement
1048
+ * text: the reader's agent has the repository and writes the fix.
1049
+ */
1050
+ export declare const ContextItemFindingSchema: v.ObjectSchema<{
1051
+ readonly tier: v.PicklistSchema<["observed", "usage", "practice"], undefined>;
1052
+ /** How the finding is known, in one line: "Seen in 3 sessions (2026-09-15 – 2026-10-03)". */
1053
+ readonly tierLine: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 300, undefined>]>;
1054
+ /** What the drafter did not read, fixed per tier. */
1055
+ readonly blindSpot: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 300, undefined>]>;
1056
+ /** What should change in later sessions if the finding is fixed, wrapped in the untrusted markers. */
1057
+ readonly prediction: v.NullableSchema<v.StringSchema<undefined>, undefined>;
1058
+ }, undefined>;
1059
+ export type ContextItemFinding = v.InferOutput<typeof ContextItemFindingSchema>;
1038
1060
  /**
1039
1061
  * One comment a **person** left about a context item, riding the item it is about.
1040
1062
  *
@@ -1070,11 +1092,28 @@ export declare const ContextItemCommentSchema: v.ObjectSchema<{
1070
1092
  */
1071
1093
  readonly suggestion: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
1072
1094
  /**
1073
- * One line saying what a server-drafted comment was drawn from — counts and
1074
- * dates, never the cited text. Present only on a comment Mossbear drafted
1075
- * and the person handed to their agent.
1095
+ * What a comment Mossbear wrote is: a finding about the item, never an edit.
1096
+ * Present only on a Mossbear comment. The comment's `body` begins with the
1097
+ * claim (what goes wrong); this carries what the claim rests on.
1076
1098
  */
1077
- readonly evidence: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 500, undefined>]>, undefined>;
1099
+ readonly finding: v.OptionalSchema<v.ObjectSchema<{
1100
+ readonly tier: v.PicklistSchema<["observed", "usage", "practice"], undefined>;
1101
+ /** How the finding is known, in one line: "Seen in 3 sessions (2026-09-15 – 2026-10-03)". */
1102
+ readonly tierLine: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 300, undefined>]>;
1103
+ /** What the drafter did not read, fixed per tier. */
1104
+ readonly blindSpot: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 300, undefined>]>;
1105
+ /** What should change in later sessions if the finding is fixed, wrapped in the untrusted markers. */
1106
+ readonly prediction: v.NullableSchema<v.StringSchema<undefined>, undefined>;
1107
+ }, undefined>, undefined>;
1108
+ /**
1109
+ * Whether the person approved a comment Mossbear drafted. Present on every
1110
+ * Mossbear comment and absent on a person's or an agent's, which are
1111
+ * requests as written. `false` is a draft nobody has read yet: a reader shows
1112
+ * it to the user and acts only on their go-ahead. Only a client that reports
1113
+ * a version able to mark drafts is ever listed one, so an older reader that
1114
+ * strips this field never receives a draft it would print as a request.
1115
+ */
1116
+ readonly approved: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
1078
1117
  /** The author's display name as the workspace shows it, or null. Never an email. */
1079
1118
  readonly authorName: v.NullableSchema<v.StringSchema<undefined>, undefined>;
1080
1119
  /** ISO timestamp, machine format. */
@@ -1259,11 +1298,28 @@ export declare const ContextItemSchema: v.ObjectSchema<{
1259
1298
  */
1260
1299
  readonly suggestion: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
1261
1300
  /**
1262
- * One line saying what a server-drafted comment was drawn from — counts and
1263
- * dates, never the cited text. Present only on a comment Mossbear drafted
1264
- * and the person handed to their agent.
1301
+ * What a comment Mossbear wrote is: a finding about the item, never an edit.
1302
+ * Present only on a Mossbear comment. The comment's `body` begins with the
1303
+ * claim (what goes wrong); this carries what the claim rests on.
1304
+ */
1305
+ readonly finding: v.OptionalSchema<v.ObjectSchema<{
1306
+ readonly tier: v.PicklistSchema<["observed", "usage", "practice"], undefined>;
1307
+ /** How the finding is known, in one line: "Seen in 3 sessions (2026-09-15 – 2026-10-03)". */
1308
+ readonly tierLine: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 300, undefined>]>;
1309
+ /** What the drafter did not read, fixed per tier. */
1310
+ readonly blindSpot: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 300, undefined>]>;
1311
+ /** What should change in later sessions if the finding is fixed, wrapped in the untrusted markers. */
1312
+ readonly prediction: v.NullableSchema<v.StringSchema<undefined>, undefined>;
1313
+ }, undefined>, undefined>;
1314
+ /**
1315
+ * Whether the person approved a comment Mossbear drafted. Present on every
1316
+ * Mossbear comment and absent on a person's or an agent's, which are
1317
+ * requests as written. `false` is a draft nobody has read yet: a reader shows
1318
+ * it to the user and acts only on their go-ahead. Only a client that reports
1319
+ * a version able to mark drafts is ever listed one, so an older reader that
1320
+ * strips this field never receives a draft it would print as a request.
1265
1321
  */
1266
- readonly evidence: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 500, undefined>]>, undefined>;
1322
+ readonly approved: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
1267
1323
  /** The author's display name as the workspace shows it, or null. Never an email. */
1268
1324
  readonly authorName: v.NullableSchema<v.StringSchema<undefined>, undefined>;
1269
1325
  /** ISO timestamp, machine format. */
@@ -1316,7 +1372,13 @@ export declare const ContextItemSchema: v.ObjectSchema<{
1316
1372
  } | undefined;
1317
1373
  body: string;
1318
1374
  suggestion?: string | undefined;
1319
- evidence?: string | undefined;
1375
+ finding?: {
1376
+ tier: "observed" | "usage" | "practice";
1377
+ tierLine: string;
1378
+ blindSpot: string;
1379
+ prediction: string | null;
1380
+ } | undefined;
1381
+ approved?: boolean | undefined;
1320
1382
  authorName: string | null;
1321
1383
  createdAt: string;
1322
1384
  itemVersion: number;
@@ -1492,11 +1554,28 @@ export declare const ContextItemsResponseSchema: v.ObjectSchema<{
1492
1554
  */
1493
1555
  readonly suggestion: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
1494
1556
  /**
1495
- * One line saying what a server-drafted comment was drawn from — counts and
1496
- * dates, never the cited text. Present only on a comment Mossbear drafted
1497
- * and the person handed to their agent.
1557
+ * What a comment Mossbear wrote is: a finding about the item, never an edit.
1558
+ * Present only on a Mossbear comment. The comment's `body` begins with the
1559
+ * claim (what goes wrong); this carries what the claim rests on.
1560
+ */
1561
+ readonly finding: v.OptionalSchema<v.ObjectSchema<{
1562
+ readonly tier: v.PicklistSchema<["observed", "usage", "practice"], undefined>;
1563
+ /** How the finding is known, in one line: "Seen in 3 sessions (2026-09-15 – 2026-10-03)". */
1564
+ readonly tierLine: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 300, undefined>]>;
1565
+ /** What the drafter did not read, fixed per tier. */
1566
+ readonly blindSpot: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 300, undefined>]>;
1567
+ /** What should change in later sessions if the finding is fixed, wrapped in the untrusted markers. */
1568
+ readonly prediction: v.NullableSchema<v.StringSchema<undefined>, undefined>;
1569
+ }, undefined>, undefined>;
1570
+ /**
1571
+ * Whether the person approved a comment Mossbear drafted. Present on every
1572
+ * Mossbear comment and absent on a person's or an agent's, which are
1573
+ * requests as written. `false` is a draft nobody has read yet: a reader shows
1574
+ * it to the user and acts only on their go-ahead. Only a client that reports
1575
+ * a version able to mark drafts is ever listed one, so an older reader that
1576
+ * strips this field never receives a draft it would print as a request.
1498
1577
  */
1499
- readonly evidence: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 500, undefined>]>, undefined>;
1578
+ readonly approved: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
1500
1579
  /** The author's display name as the workspace shows it, or null. Never an email. */
1501
1580
  readonly authorName: v.NullableSchema<v.StringSchema<undefined>, undefined>;
1502
1581
  /** ISO timestamp, machine format. */
@@ -1549,7 +1628,13 @@ export declare const ContextItemsResponseSchema: v.ObjectSchema<{
1549
1628
  } | undefined;
1550
1629
  body: string;
1551
1630
  suggestion?: string | undefined;
1552
- evidence?: string | undefined;
1631
+ finding?: {
1632
+ tier: "observed" | "usage" | "practice";
1633
+ tierLine: string;
1634
+ blindSpot: string;
1635
+ prediction: string | null;
1636
+ } | undefined;
1637
+ approved?: boolean | undefined;
1553
1638
  authorName: string | null;
1554
1639
  createdAt: string;
1555
1640
  itemVersion: number;
@@ -1750,11 +1835,28 @@ export declare const ItemCommentWithSubjectSchema: v.ObjectSchema<{
1750
1835
  */
1751
1836
  readonly suggestion: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
1752
1837
  /**
1753
- * One line saying what a server-drafted comment was drawn from — counts and
1754
- * dates, never the cited text. Present only on a comment Mossbear drafted
1755
- * and the person handed to their agent.
1838
+ * What a comment Mossbear wrote is: a finding about the item, never an edit.
1839
+ * Present only on a Mossbear comment. The comment's `body` begins with the
1840
+ * claim (what goes wrong); this carries what the claim rests on.
1756
1841
  */
1757
- readonly evidence: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 500, undefined>]>, undefined>;
1842
+ readonly finding: v.OptionalSchema<v.ObjectSchema<{
1843
+ readonly tier: v.PicklistSchema<["observed", "usage", "practice"], undefined>;
1844
+ /** How the finding is known, in one line: "Seen in 3 sessions (2026-09-15 – 2026-10-03)". */
1845
+ readonly tierLine: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 300, undefined>]>;
1846
+ /** What the drafter did not read, fixed per tier. */
1847
+ readonly blindSpot: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 300, undefined>]>;
1848
+ /** What should change in later sessions if the finding is fixed, wrapped in the untrusted markers. */
1849
+ readonly prediction: v.NullableSchema<v.StringSchema<undefined>, undefined>;
1850
+ }, undefined>, undefined>;
1851
+ /**
1852
+ * Whether the person approved a comment Mossbear drafted. Present on every
1853
+ * Mossbear comment and absent on a person's or an agent's, which are
1854
+ * requests as written. `false` is a draft nobody has read yet: a reader shows
1855
+ * it to the user and acts only on their go-ahead. Only a client that reports
1856
+ * a version able to mark drafts is ever listed one, so an older reader that
1857
+ * strips this field never receives a draft it would print as a request.
1858
+ */
1859
+ readonly approved: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
1758
1860
  /** The author's display name as the workspace shows it, or null. Never an email. */
1759
1861
  readonly authorName: v.NullableSchema<v.StringSchema<undefined>, undefined>;
1760
1862
  /** ISO timestamp, machine format. */
@@ -1835,11 +1937,28 @@ export declare const ItemCommentsResponseSchema: v.ObjectSchema<{
1835
1937
  */
1836
1938
  readonly suggestion: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
1837
1939
  /**
1838
- * One line saying what a server-drafted comment was drawn from — counts and
1839
- * dates, never the cited text. Present only on a comment Mossbear drafted
1840
- * and the person handed to their agent.
1940
+ * What a comment Mossbear wrote is: a finding about the item, never an edit.
1941
+ * Present only on a Mossbear comment. The comment's `body` begins with the
1942
+ * claim (what goes wrong); this carries what the claim rests on.
1943
+ */
1944
+ readonly finding: v.OptionalSchema<v.ObjectSchema<{
1945
+ readonly tier: v.PicklistSchema<["observed", "usage", "practice"], undefined>;
1946
+ /** How the finding is known, in one line: "Seen in 3 sessions (2026-09-15 – 2026-10-03)". */
1947
+ readonly tierLine: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 300, undefined>]>;
1948
+ /** What the drafter did not read, fixed per tier. */
1949
+ readonly blindSpot: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 300, undefined>]>;
1950
+ /** What should change in later sessions if the finding is fixed, wrapped in the untrusted markers. */
1951
+ readonly prediction: v.NullableSchema<v.StringSchema<undefined>, undefined>;
1952
+ }, undefined>, undefined>;
1953
+ /**
1954
+ * Whether the person approved a comment Mossbear drafted. Present on every
1955
+ * Mossbear comment and absent on a person's or an agent's, which are
1956
+ * requests as written. `false` is a draft nobody has read yet: a reader shows
1957
+ * it to the user and acts only on their go-ahead. Only a client that reports
1958
+ * a version able to mark drafts is ever listed one, so an older reader that
1959
+ * strips this field never receives a draft it would print as a request.
1841
1960
  */
1842
- readonly evidence: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 500, undefined>]>, undefined>;
1961
+ readonly approved: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
1843
1962
  /** The author's display name as the workspace shows it, or null. Never an email. */
1844
1963
  readonly authorName: v.NullableSchema<v.StringSchema<undefined>, undefined>;
1845
1964
  /** ISO timestamp, machine format. */
@@ -1894,30 +2013,31 @@ export declare const ItemCommentsResponseSchema: v.ObjectSchema<{
1894
2013
  }, undefined>;
1895
2014
  export type ItemCommentsResponse = v.InferOutput<typeof ItemCommentsResponseSchema>;
1896
2015
  /**
1897
- * The evidence behind one Mossbear comment an agent was handed
1898
- * (`GET /api/v1/context/comments/evidence`, `drafted-guide-suggestions` slice 7).
2016
+ * The evidence behind one Mossbear finding an agent was handed
2017
+ * (`GET /api/v1/context/comments/evidence`).
1899
2018
  *
1900
- * `list_comments` carries a one-line pointer; this is the envelope it points
1901
- * at: the summary, the observable change the edit predicts, and the cited
1902
- * sessions. Readable only through a comment the comment read itself would
1903
- * deliver to this reader, so an unapproved edit, another person's, or one
1904
- * drafted from another repo has no evidence here either.
2019
+ * `list_comments` carries the claim and a one-line tier; this is the finding
2020
+ * in full: the claim, the change it predicts in future sessions, what the
2021
+ * drafter did not read, and the evidence for its tier. Readable only through a
2022
+ * comment the comment read itself would deliver to this reader, so another
2023
+ * person's finding, one drafted from another repo, or a draft listed only to a
2024
+ * newer client has no evidence here either. A draft the reader was listed
2025
+ * does: an agent can say why it was raised before the person approves it.
1905
2026
  *
1906
- * Citations are reduced to what the reader may see: their own sessions, with a
1907
- * date and a short excerpt of the grader's reasoning or of their own redacted
1908
- * correction turn. A `navigation` citation — a skill load counted when a
1909
- * suggestion was drafted from how the skill's files were read — has an empty
1910
- * excerpt: it is dated evidence that a session loaded the skill, and nothing
1911
- * more. `citationsWithheld` counts any that were dropped, so a short
1912
- * list is never mistaken for the whole of it.
2027
+ * Citations (observed and usage findings) are reduced to what the reader may
2028
+ * see: their own sessions, with a date and a short excerpt of the grader's
2029
+ * reasoning or of their own redacted correction turn. A `navigation` citation
2030
+ * has an empty excerpt: it is dated evidence that a session loaded the skill,
2031
+ * and nothing more. `citationsWithheld` counts any that were dropped, so a
2032
+ * short list is never mistaken for the whole of it.
1913
2033
  */
1914
2034
  export declare const CommentEvidenceCitationSchema: v.ObjectSchema<{
1915
2035
  /**
1916
- * `navigation` is a skill load whose reads drafted the suggestion. It carries
1917
- * no excerpt (an empty string): it is evidence of how a skill was used, not of
1918
- * a failure. `action` is a recorded step of a workflow repeated across
1919
- * sessions: evidence of a habit, not of a failure. A server sends it only to a
1920
- * client that names a version new enough to parse it.
2036
+ * `navigation` is a skill load counted when a finding was drafted from how
2037
+ * the skill's files were read: evidence of how a skill was used, not of a
2038
+ * failure. `action` is a recorded step of a workflow repeated across
2039
+ * sessions. A server sends it only to a client that names a version new
2040
+ * enough to parse it.
1921
2041
  */
1922
2042
  readonly kind: v.PicklistSchema<["verdict", "turn", "navigation", "action"], undefined>;
1923
2043
  readonly sessionId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
@@ -1927,22 +2047,95 @@ export declare const CommentEvidenceCitationSchema: v.ObjectSchema<{
1927
2047
  readonly excerpt: v.StringSchema<undefined>;
1928
2048
  }, undefined>;
1929
2049
  export type CommentEvidenceCitation = v.InferOutput<typeof CommentEvidenceCitationSchema>;
2050
+ /** What a usage finding adds to its citations: the counts for one reference file. */
2051
+ export declare const CommentEvidenceUsageSchema: v.ObjectSchema<{
2052
+ /** The reference's skill-relative path, wrapped in the response's untrusted markers. */
2053
+ readonly path: v.StringSchema<undefined>;
2054
+ /** Eligible loads of the skill. */
2055
+ readonly loads: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>]>;
2056
+ /** Distinct sessions those loads span. */
2057
+ readonly sessions: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>]>;
2058
+ /** Loads followed by a successful read of the reference. */
2059
+ readonly loadsWithRead: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>]>;
2060
+ }, undefined>;
2061
+ /**
2062
+ * What a practice finding adds: the rubric check it answers and the rubric's
2063
+ * version, the practice lines it weighs with their sources, the facts measured
2064
+ * from the file, and the answer to each item of evidence the check asks for.
2065
+ * `answers[].answer` is model-written, so it travels wrapped in the response's
2066
+ * untrusted markers.
2067
+ */
2068
+ export declare const CommentEvidencePracticeSchema: v.ObjectSchema<{
2069
+ readonly check: v.ObjectSchema<{
2070
+ readonly id: v.StringSchema<undefined>;
2071
+ readonly name: v.StringSchema<undefined>;
2072
+ }, undefined>;
2073
+ readonly rubricVersion: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>]>;
2074
+ readonly practices: v.OptionalSchema<v.ArraySchema<v.ObjectSchema<{
2075
+ readonly text: v.StringSchema<undefined>;
2076
+ readonly source: v.ObjectSchema<{
2077
+ readonly title: v.StringSchema<undefined>;
2078
+ readonly url: v.StringSchema<undefined>;
2079
+ }, undefined>;
2080
+ }, undefined>, undefined>, readonly []>;
2081
+ readonly facts: v.OptionalSchema<v.ArraySchema<v.StringSchema<undefined>, undefined>, readonly []>;
2082
+ readonly answers: v.OptionalSchema<v.ArraySchema<v.ObjectSchema<{
2083
+ readonly item: v.StringSchema<undefined>;
2084
+ readonly answer: v.StringSchema<undefined>;
2085
+ }, undefined>, undefined>, readonly []>;
2086
+ }, undefined>;
1930
2087
  export declare const CommentEvidenceResponseSchema: v.ObjectSchema<{
1931
2088
  /** The comment's full id, even when the request named a prefix. */
1932
2089
  readonly commentId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
1933
2090
  readonly itemName: v.StringSchema<undefined>;
1934
2091
  readonly itemPath: v.NullableSchema<v.StringSchema<undefined>, undefined>;
1935
- /** Wrapped in the response's untrusted markers. */
1936
- readonly summary: v.StringSchema<undefined>;
1937
- /** What future sessions should show if the edit works, wrapped; null if none. */
2092
+ readonly tier: v.PicklistSchema<["observed", "usage", "practice"], undefined>;
2093
+ /** One line saying how the finding is known; server-written, outside the markers. */
2094
+ readonly tierLine: v.StringSchema<undefined>;
2095
+ /** What the drafter did not read; server-written, outside the markers. */
2096
+ readonly blindSpot: v.StringSchema<undefined>;
2097
+ /** What goes wrong, wrapped in the response's untrusted markers. */
2098
+ readonly claim: v.StringSchema<undefined>;
2099
+ /** What future sessions should show if the finding is fixed, wrapped; null if none. */
1938
2100
  readonly prediction: v.NullableSchema<v.StringSchema<undefined>, undefined>;
2101
+ /** A usage finding's counts; null on every other tier. */
2102
+ readonly usage: v.NullableSchema<v.ObjectSchema<{
2103
+ /** The reference's skill-relative path, wrapped in the response's untrusted markers. */
2104
+ readonly path: v.StringSchema<undefined>;
2105
+ /** Eligible loads of the skill. */
2106
+ readonly loads: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>]>;
2107
+ /** Distinct sessions those loads span. */
2108
+ readonly sessions: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>]>;
2109
+ /** Loads followed by a successful read of the reference. */
2110
+ readonly loadsWithRead: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>]>;
2111
+ }, undefined>, undefined>;
2112
+ /** A practice finding's rubric check; null on every other tier. */
2113
+ readonly practice: v.NullableSchema<v.ObjectSchema<{
2114
+ readonly check: v.ObjectSchema<{
2115
+ readonly id: v.StringSchema<undefined>;
2116
+ readonly name: v.StringSchema<undefined>;
2117
+ }, undefined>;
2118
+ readonly rubricVersion: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>]>;
2119
+ readonly practices: v.OptionalSchema<v.ArraySchema<v.ObjectSchema<{
2120
+ readonly text: v.StringSchema<undefined>;
2121
+ readonly source: v.ObjectSchema<{
2122
+ readonly title: v.StringSchema<undefined>;
2123
+ readonly url: v.StringSchema<undefined>;
2124
+ }, undefined>;
2125
+ }, undefined>, undefined>, readonly []>;
2126
+ readonly facts: v.OptionalSchema<v.ArraySchema<v.StringSchema<undefined>, undefined>, readonly []>;
2127
+ readonly answers: v.OptionalSchema<v.ArraySchema<v.ObjectSchema<{
2128
+ readonly item: v.StringSchema<undefined>;
2129
+ readonly answer: v.StringSchema<undefined>;
2130
+ }, undefined>, undefined>, readonly []>;
2131
+ }, undefined>, undefined>;
1939
2132
  readonly citations: v.ArraySchema<v.ObjectSchema<{
1940
2133
  /**
1941
- * `navigation` is a skill load whose reads drafted the suggestion. It carries
1942
- * no excerpt (an empty string): it is evidence of how a skill was used, not of
1943
- * a failure. `action` is a recorded step of a workflow repeated across
1944
- * sessions: evidence of a habit, not of a failure. A server sends it only to a
1945
- * client that names a version new enough to parse it.
2134
+ * `navigation` is a skill load counted when a finding was drafted from how
2135
+ * the skill's files were read: evidence of how a skill was used, not of a
2136
+ * failure. `action` is a recorded step of a workflow repeated across
2137
+ * sessions. A server sends it only to a client that names a version new
2138
+ * enough to parse it.
1946
2139
  */
1947
2140
  readonly kind: v.PicklistSchema<["verdict", "turn", "navigation", "action"], undefined>;
1948
2141
  readonly sessionId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
@@ -2140,11 +2333,28 @@ export declare const PushContextResponseSchema: v.ObjectSchema<{
2140
2333
  */
2141
2334
  readonly suggestion: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
2142
2335
  /**
2143
- * One line saying what a server-drafted comment was drawn from — counts and
2144
- * dates, never the cited text. Present only on a comment Mossbear drafted
2145
- * and the person handed to their agent.
2336
+ * What a comment Mossbear wrote is: a finding about the item, never an edit.
2337
+ * Present only on a Mossbear comment. The comment's `body` begins with the
2338
+ * claim (what goes wrong); this carries what the claim rests on.
2146
2339
  */
2147
- readonly evidence: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 500, undefined>]>, undefined>;
2340
+ readonly finding: v.OptionalSchema<v.ObjectSchema<{
2341
+ readonly tier: v.PicklistSchema<["observed", "usage", "practice"], undefined>;
2342
+ /** How the finding is known, in one line: "Seen in 3 sessions (2026-09-15 – 2026-10-03)". */
2343
+ readonly tierLine: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 300, undefined>]>;
2344
+ /** What the drafter did not read, fixed per tier. */
2345
+ readonly blindSpot: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 300, undefined>]>;
2346
+ /** What should change in later sessions if the finding is fixed, wrapped in the untrusted markers. */
2347
+ readonly prediction: v.NullableSchema<v.StringSchema<undefined>, undefined>;
2348
+ }, undefined>, undefined>;
2349
+ /**
2350
+ * Whether the person approved a comment Mossbear drafted. Present on every
2351
+ * Mossbear comment and absent on a person's or an agent's, which are
2352
+ * requests as written. `false` is a draft nobody has read yet: a reader shows
2353
+ * it to the user and acts only on their go-ahead. Only a client that reports
2354
+ * a version able to mark drafts is ever listed one, so an older reader that
2355
+ * strips this field never receives a draft it would print as a request.
2356
+ */
2357
+ readonly approved: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
2148
2358
  /** The author's display name as the workspace shows it, or null. Never an email. */
2149
2359
  readonly authorName: v.NullableSchema<v.StringSchema<undefined>, undefined>;
2150
2360
  /** ISO timestamp, machine format. */
@@ -2197,7 +2407,13 @@ export declare const PushContextResponseSchema: v.ObjectSchema<{
2197
2407
  } | undefined;
2198
2408
  body: string;
2199
2409
  suggestion?: string | undefined;
2200
- evidence?: string | undefined;
2410
+ finding?: {
2411
+ tier: "observed" | "usage" | "practice";
2412
+ tierLine: string;
2413
+ blindSpot: string;
2414
+ prediction: string | null;
2415
+ } | undefined;
2416
+ approved?: boolean | undefined;
2201
2417
  authorName: string | null;
2202
2418
  createdAt: string;
2203
2419
  itemVersion: number;
@@ -2462,11 +2678,28 @@ export declare const UpdateContextItemResponseSchema: v.ObjectSchema<{
2462
2678
  */
2463
2679
  readonly suggestion: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
2464
2680
  /**
2465
- * One line saying what a server-drafted comment was drawn from — counts and
2466
- * dates, never the cited text. Present only on a comment Mossbear drafted
2467
- * and the person handed to their agent.
2681
+ * What a comment Mossbear wrote is: a finding about the item, never an edit.
2682
+ * Present only on a Mossbear comment. The comment's `body` begins with the
2683
+ * claim (what goes wrong); this carries what the claim rests on.
2468
2684
  */
2469
- readonly evidence: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 500, undefined>]>, undefined>;
2685
+ readonly finding: v.OptionalSchema<v.ObjectSchema<{
2686
+ readonly tier: v.PicklistSchema<["observed", "usage", "practice"], undefined>;
2687
+ /** How the finding is known, in one line: "Seen in 3 sessions (2026-09-15 – 2026-10-03)". */
2688
+ readonly tierLine: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 300, undefined>]>;
2689
+ /** What the drafter did not read, fixed per tier. */
2690
+ readonly blindSpot: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 300, undefined>]>;
2691
+ /** What should change in later sessions if the finding is fixed, wrapped in the untrusted markers. */
2692
+ readonly prediction: v.NullableSchema<v.StringSchema<undefined>, undefined>;
2693
+ }, undefined>, undefined>;
2694
+ /**
2695
+ * Whether the person approved a comment Mossbear drafted. Present on every
2696
+ * Mossbear comment and absent on a person's or an agent's, which are
2697
+ * requests as written. `false` is a draft nobody has read yet: a reader shows
2698
+ * it to the user and acts only on their go-ahead. Only a client that reports
2699
+ * a version able to mark drafts is ever listed one, so an older reader that
2700
+ * strips this field never receives a draft it would print as a request.
2701
+ */
2702
+ readonly approved: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
2470
2703
  /** The author's display name as the workspace shows it, or null. Never an email. */
2471
2704
  readonly authorName: v.NullableSchema<v.StringSchema<undefined>, undefined>;
2472
2705
  /** ISO timestamp, machine format. */
@@ -2519,7 +2752,13 @@ export declare const UpdateContextItemResponseSchema: v.ObjectSchema<{
2519
2752
  } | undefined;
2520
2753
  body: string;
2521
2754
  suggestion?: string | undefined;
2522
- evidence?: string | undefined;
2755
+ finding?: {
2756
+ tier: "observed" | "usage" | "practice";
2757
+ tierLine: string;
2758
+ blindSpot: string;
2759
+ prediction: string | null;
2760
+ } | undefined;
2761
+ approved?: boolean | undefined;
2523
2762
  authorName: string | null;
2524
2763
  createdAt: string;
2525
2764
  itemVersion: number;
@@ -2945,11 +3184,28 @@ export declare const ContextItemResponseSchema: v.ObjectSchema<{
2945
3184
  */
2946
3185
  readonly suggestion: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
2947
3186
  /**
2948
- * One line saying what a server-drafted comment was drawn from — counts and
2949
- * dates, never the cited text. Present only on a comment Mossbear drafted
2950
- * and the person handed to their agent.
3187
+ * What a comment Mossbear wrote is: a finding about the item, never an edit.
3188
+ * Present only on a Mossbear comment. The comment's `body` begins with the
3189
+ * claim (what goes wrong); this carries what the claim rests on.
3190
+ */
3191
+ readonly finding: v.OptionalSchema<v.ObjectSchema<{
3192
+ readonly tier: v.PicklistSchema<["observed", "usage", "practice"], undefined>;
3193
+ /** How the finding is known, in one line: "Seen in 3 sessions (2026-09-15 – 2026-10-03)". */
3194
+ readonly tierLine: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 300, undefined>]>;
3195
+ /** What the drafter did not read, fixed per tier. */
3196
+ readonly blindSpot: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 300, undefined>]>;
3197
+ /** What should change in later sessions if the finding is fixed, wrapped in the untrusted markers. */
3198
+ readonly prediction: v.NullableSchema<v.StringSchema<undefined>, undefined>;
3199
+ }, undefined>, undefined>;
3200
+ /**
3201
+ * Whether the person approved a comment Mossbear drafted. Present on every
3202
+ * Mossbear comment and absent on a person's or an agent's, which are
3203
+ * requests as written. `false` is a draft nobody has read yet: a reader shows
3204
+ * it to the user and acts only on their go-ahead. Only a client that reports
3205
+ * a version able to mark drafts is ever listed one, so an older reader that
3206
+ * strips this field never receives a draft it would print as a request.
2951
3207
  */
2952
- readonly evidence: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 500, undefined>]>, undefined>;
3208
+ readonly approved: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
2953
3209
  /** The author's display name as the workspace shows it, or null. Never an email. */
2954
3210
  readonly authorName: v.NullableSchema<v.StringSchema<undefined>, undefined>;
2955
3211
  /** ISO timestamp, machine format. */
@@ -3002,7 +3258,13 @@ export declare const ContextItemResponseSchema: v.ObjectSchema<{
3002
3258
  } | undefined;
3003
3259
  body: string;
3004
3260
  suggestion?: string | undefined;
3005
- evidence?: string | undefined;
3261
+ finding?: {
3262
+ tier: "observed" | "usage" | "practice";
3263
+ tierLine: string;
3264
+ blindSpot: string;
3265
+ prediction: string | null;
3266
+ } | undefined;
3267
+ approved?: boolean | undefined;
3006
3268
  authorName: string | null;
3007
3269
  createdAt: string;
3008
3270
  itemVersion: number;
@@ -3180,11 +3442,28 @@ export declare const ArchiveContextItemResponseSchema: v.ObjectSchema<{
3180
3442
  */
3181
3443
  readonly suggestion: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
3182
3444
  /**
3183
- * One line saying what a server-drafted comment was drawn from — counts and
3184
- * dates, never the cited text. Present only on a comment Mossbear drafted
3185
- * and the person handed to their agent.
3445
+ * What a comment Mossbear wrote is: a finding about the item, never an edit.
3446
+ * Present only on a Mossbear comment. The comment's `body` begins with the
3447
+ * claim (what goes wrong); this carries what the claim rests on.
3186
3448
  */
3187
- readonly evidence: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 500, undefined>]>, undefined>;
3449
+ readonly finding: v.OptionalSchema<v.ObjectSchema<{
3450
+ readonly tier: v.PicklistSchema<["observed", "usage", "practice"], undefined>;
3451
+ /** How the finding is known, in one line: "Seen in 3 sessions (2026-09-15 – 2026-10-03)". */
3452
+ readonly tierLine: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 300, undefined>]>;
3453
+ /** What the drafter did not read, fixed per tier. */
3454
+ readonly blindSpot: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 300, undefined>]>;
3455
+ /** What should change in later sessions if the finding is fixed, wrapped in the untrusted markers. */
3456
+ readonly prediction: v.NullableSchema<v.StringSchema<undefined>, undefined>;
3457
+ }, undefined>, undefined>;
3458
+ /**
3459
+ * Whether the person approved a comment Mossbear drafted. Present on every
3460
+ * Mossbear comment and absent on a person's or an agent's, which are
3461
+ * requests as written. `false` is a draft nobody has read yet: a reader shows
3462
+ * it to the user and acts only on their go-ahead. Only a client that reports
3463
+ * a version able to mark drafts is ever listed one, so an older reader that
3464
+ * strips this field never receives a draft it would print as a request.
3465
+ */
3466
+ readonly approved: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
3188
3467
  /** The author's display name as the workspace shows it, or null. Never an email. */
3189
3468
  readonly authorName: v.NullableSchema<v.StringSchema<undefined>, undefined>;
3190
3469
  /** ISO timestamp, machine format. */
@@ -3237,7 +3516,13 @@ export declare const ArchiveContextItemResponseSchema: v.ObjectSchema<{
3237
3516
  } | undefined;
3238
3517
  body: string;
3239
3518
  suggestion?: string | undefined;
3240
- evidence?: string | undefined;
3519
+ finding?: {
3520
+ tier: "observed" | "usage" | "practice";
3521
+ tierLine: string;
3522
+ blindSpot: string;
3523
+ prediction: string | null;
3524
+ } | undefined;
3525
+ approved?: boolean | undefined;
3241
3526
  authorName: string | null;
3242
3527
  createdAt: string;
3243
3528
  itemVersion: number;
@@ -3689,17 +3974,9 @@ export declare const DashboardGuideSuggestionSchema: v.ObjectSchema<{
3689
3974
  }, undefined>], undefined>, undefined>, undefined>;
3690
3975
  readonly status: v.OptionalSchema<v.PicklistSchema<["pending", "accepted", "dismissed"], undefined>, undefined>;
3691
3976
  }, undefined>;
3692
- export declare const DashboardFeedbackCandidateSchema: v.ObjectSchema<{
3693
- readonly id: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
3694
- readonly signal: v.StringSchema<undefined>;
3695
- readonly signalType: v.PicklistSchema<["correction", "approval", "implied_preference", "stated_preference", "skill_suggestion"], undefined>;
3696
- readonly confidence: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.MinValueAction<number, 0, undefined>, v.MaxValueAction<number, 1, undefined>]>, undefined>;
3697
- readonly occurrences: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>, undefined>;
3698
- readonly status: v.OptionalSchema<v.PicklistSchema<["inferred", "confirmed", "dismissed"], undefined>, undefined>;
3699
- }, undefined>;
3700
3977
  /** Max number of actions accepted in a single `POST /api/sync` request. */
3701
3978
  export declare const MAX_SYNC_ACTIONS_BATCH = 500;
3702
- /** Max number of guideSuggestions/feedbackCandidates/runUsage entries per sync request. */
3979
+ /** Max number of guideSuggestions/runUsage entries per sync request. */
3703
3980
  export declare const MAX_SYNC_AUX_BATCH = 100;
3704
3981
  /**
3705
3982
  * Max rule files one delivery manifest enumerates. Well above what a real repo
@@ -3994,21 +4271,6 @@ export declare const DashboardSyncRequestSchema: v.ObjectSchema<{
3994
4271
  })[] | undefined;
3995
4272
  status?: "pending" | "accepted" | "dismissed" | undefined;
3996
4273
  }[], 100, undefined>]>, undefined>;
3997
- readonly feedbackCandidates: v.OptionalSchema<v.SchemaWithPipe<readonly [v.ArraySchema<v.ObjectSchema<{
3998
- readonly id: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
3999
- readonly signal: v.StringSchema<undefined>;
4000
- readonly signalType: v.PicklistSchema<["correction", "approval", "implied_preference", "stated_preference", "skill_suggestion"], undefined>;
4001
- readonly confidence: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.MinValueAction<number, 0, undefined>, v.MaxValueAction<number, 1, undefined>]>, undefined>;
4002
- readonly occurrences: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>, undefined>;
4003
- readonly status: v.OptionalSchema<v.PicklistSchema<["inferred", "confirmed", "dismissed"], undefined>, undefined>;
4004
- }, undefined>, undefined>, v.MaxLengthAction<{
4005
- id?: string | undefined;
4006
- signal: string;
4007
- signalType: "correction" | "approval" | "implied_preference" | "stated_preference" | "skill_suggestion";
4008
- confidence?: number | undefined;
4009
- occurrences?: number | undefined;
4010
- status?: "dismissed" | "inferred" | "confirmed" | undefined;
4011
- }[], 100, undefined>]>, undefined>;
4012
4274
  readonly runUsage: v.OptionalSchema<v.SchemaWithPipe<readonly [v.ArraySchema<v.ObjectSchema<{
4013
4275
  readonly sessionId: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
4014
4276
  readonly agentSessionId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
@@ -4910,9 +5172,16 @@ export type GuideHistoryResponse = v.InferOutput<typeof GuideHistoryResponseSche
4910
5172
  export declare const SessionGradeRequestSchema: v.SchemaWithPipe<readonly [v.ObjectSchema<{
4911
5173
  readonly 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>;
4912
5174
  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>;
5175
+ /**
5176
+ * Opt in to the session digest: the grade plus the turns, self-report and
5177
+ * git position of the session. Omitted, the small grade payload that
5178
+ * `mossbear sessions` and session start read is unchanged.
5179
+ */
5180
+ readonly detail: v.OptionalSchema<v.LiteralSchema<"digest", undefined>, undefined>;
4913
5181
  }, undefined>, v.CheckAction<{
4914
5182
  session?: string | undefined;
4915
5183
  agent_session?: string | undefined;
5184
+ detail?: "digest" | undefined;
4916
5185
  }, "Pass exactly one of session or agent_session">]>;
4917
5186
  export type SessionGradeRequest = v.InferOutput<typeof SessionGradeRequestSchema>;
4918
5187
  /**
@@ -5041,26 +5310,146 @@ export declare const SessionGradeResponseSchema: v.ObjectSchema<{
5041
5310
  }, undefined>, undefined>;
5042
5311
  }, undefined>;
5043
5312
  export type SessionGradeResponse = v.InferOutput<typeof SessionGradeResponseSchema>;
5313
+ /** Most turns one digest returns; `turnsTotal` says how many the session has. */
5314
+ export declare const SESSION_DIGEST_MAX_TURNS = 50;
5315
+ /** What the digest cannot carry yet, named so an absence is never read as "none". */
5316
+ export declare const SESSION_DIGEST_UNAVAILABLE: readonly ["comments", "resumeCommand", "cloudUrl"];
5317
+ export declare const SessionDigestUnavailableSchema: v.PicklistSchema<readonly ["comments", "resumeCommand", "cloudUrl"], undefined>;
5318
+ export type SessionDigestUnavailable = v.InferOutput<typeof SessionDigestUnavailableSchema>;
5319
+ export declare const SessionDigestTurnSchema: v.ObjectSchema<{
5320
+ readonly ordinal: v.NumberSchema<undefined>;
5321
+ /** What the user said, **wrapped in the response's untrusted markers** and bounded. */
5322
+ readonly text: v.StringSchema<undefined>;
5323
+ /** The steering classifier's label, or null when the turn was never classified. */
5324
+ readonly steeringLabel: v.NullableSchema<v.StringSchema<undefined>, undefined>;
5325
+ }, undefined>;
5326
+ export type SessionDigestTurn = v.InferOutput<typeof SessionDigestTurnSchema>;
5327
+ export declare const SessionDigestSchema: v.ObjectSchema<{
5328
+ /** The agent's own closing account of the session, wrapped and bounded; null when it gave none. */
5329
+ readonly selfReport: v.NullableSchema<v.StringSchema<undefined>, undefined>;
5330
+ /** The user's turns in order, at most `SESSION_DIGEST_MAX_TURNS`. */
5331
+ readonly turns: v.ArraySchema<v.ObjectSchema<{
5332
+ readonly ordinal: v.NumberSchema<undefined>;
5333
+ /** What the user said, **wrapped in the response's untrusted markers** and bounded. */
5334
+ readonly text: v.StringSchema<undefined>;
5335
+ /** The steering classifier's label, or null when the turn was never classified. */
5336
+ readonly steeringLabel: v.NullableSchema<v.StringSchema<undefined>, undefined>;
5337
+ }, undefined>, undefined>;
5338
+ /** Every turn the session recorded, so a cut list is not read as the whole. */
5339
+ readonly turnsTotal: v.NumberSchema<undefined>;
5340
+ /** The repository's identity digest, or null when the session recorded none. */
5341
+ readonly repoId: v.NullableSchema<v.StringSchema<undefined>, undefined>;
5342
+ /** The branch observed at close, wrapped like any text taken from the repo; null when unrecorded. */
5343
+ readonly branch: v.NullableSchema<v.StringSchema<undefined>, undefined>;
5344
+ /** The head commit observed at close, or null. A commit made mid-session is not it. */
5345
+ readonly headSha: v.NullableSchema<v.StringSchema<undefined>, undefined>;
5346
+ /** The session's page on the dashboard, as a path; the client prefixes the dashboard address. */
5347
+ readonly dashboardPath: v.StringSchema<undefined>;
5348
+ /** Absolute dashboard link, added by the client that knows the address. */
5349
+ readonly dashboardUrl: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
5350
+ /** Comments on this session, wrapped; empty until sessions can be commented on. */
5351
+ readonly comments: v.ArraySchema<v.StringSchema<undefined>, undefined>;
5352
+ /** The parts of a digest no session carries yet. */
5353
+ readonly notYetAvailable: v.ArraySchema<v.PicklistSchema<readonly ["comments", "resumeCommand", "cloudUrl"], undefined>, undefined>;
5354
+ }, undefined>;
5355
+ export type SessionDigest = v.InferOutput<typeof SessionDigestSchema>;
5356
+ export declare const SessionDigestResponseSchema: v.ObjectSchema<{
5357
+ readonly run: v.ObjectSchema<{
5358
+ readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
5359
+ readonly agentSessionId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
5360
+ readonly startedAt: v.StringSchema<undefined>;
5361
+ readonly endedAt: v.NullableSchema<v.StringSchema<undefined>, undefined>;
5362
+ readonly status: v.PicklistSchema<["open", "closed"], undefined>;
5363
+ }, undefined>;
5364
+ readonly state: v.PicklistSchema<["pending", "graded", "nothing_to_grade", "expired"], undefined>;
5365
+ readonly grade: v.NullableSchema<v.ObjectSchema<{
5366
+ /** The grader's one-paragraph judgment of the run, wrapped like `reasoning`; null when the record carries none. */
5367
+ readonly summary: v.NullableSchema<v.StringSchema<undefined>, undefined>;
5368
+ /** ISO timestamp, machine format — display formatting is the reader's job. */
5369
+ readonly gradedAt: v.StringSchema<undefined>;
5370
+ /** The model that produced the judgment, or null when the record does not say. */
5371
+ readonly model: v.NullableSchema<v.StringSchema<undefined>, undefined>;
5372
+ /**
5373
+ * True when the run grew after this grade was written — a later sync
5374
+ * attached more actions — so the judgment describes a smaller run than the
5375
+ * one on record. A superseded grade is real and is still reported; it is
5376
+ * labelled rather than hidden.
5377
+ */
5378
+ readonly superseded: v.BooleanSchema<undefined>;
5379
+ readonly guides: v.ArraySchema<v.ObjectSchema<{
5380
+ readonly guideId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
5381
+ readonly title: v.StringSchema<undefined>;
5382
+ readonly verdict: v.PicklistSchema<["aligned", "misaligned", "not_applicable"], undefined>;
5383
+ /**
5384
+ * The grader's reasoning, **already wrapped in the response's untrusted
5385
+ * markers** — model-authored text derived from a transcript, delimited at the
5386
+ * source so a consumer cannot skip the markers. Empty between the markers
5387
+ * when the row recorded none.
5388
+ */
5389
+ readonly reasoning: v.StringSchema<undefined>;
5390
+ }, undefined>, undefined>;
5391
+ }, undefined>, undefined>;
5392
+ readonly digest: v.ObjectSchema<{
5393
+ /** The agent's own closing account of the session, wrapped and bounded; null when it gave none. */
5394
+ readonly selfReport: v.NullableSchema<v.StringSchema<undefined>, undefined>;
5395
+ /** The user's turns in order, at most `SESSION_DIGEST_MAX_TURNS`. */
5396
+ readonly turns: v.ArraySchema<v.ObjectSchema<{
5397
+ readonly ordinal: v.NumberSchema<undefined>;
5398
+ /** What the user said, **wrapped in the response's untrusted markers** and bounded. */
5399
+ readonly text: v.StringSchema<undefined>;
5400
+ /** The steering classifier's label, or null when the turn was never classified. */
5401
+ readonly steeringLabel: v.NullableSchema<v.StringSchema<undefined>, undefined>;
5402
+ }, undefined>, undefined>;
5403
+ /** Every turn the session recorded, so a cut list is not read as the whole. */
5404
+ readonly turnsTotal: v.NumberSchema<undefined>;
5405
+ /** The repository's identity digest, or null when the session recorded none. */
5406
+ readonly repoId: v.NullableSchema<v.StringSchema<undefined>, undefined>;
5407
+ /** The branch observed at close, wrapped like any text taken from the repo; null when unrecorded. */
5408
+ readonly branch: v.NullableSchema<v.StringSchema<undefined>, undefined>;
5409
+ /** The head commit observed at close, or null. A commit made mid-session is not it. */
5410
+ readonly headSha: v.NullableSchema<v.StringSchema<undefined>, undefined>;
5411
+ /** The session's page on the dashboard, as a path; the client prefixes the dashboard address. */
5412
+ readonly dashboardPath: v.StringSchema<undefined>;
5413
+ /** Absolute dashboard link, added by the client that knows the address. */
5414
+ readonly dashboardUrl: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
5415
+ /** Comments on this session, wrapped; empty until sessions can be commented on. */
5416
+ readonly comments: v.ArraySchema<v.StringSchema<undefined>, undefined>;
5417
+ /** The parts of a digest no session carries yet. */
5418
+ readonly notYetAvailable: v.ArraySchema<v.PicklistSchema<readonly ["comments", "resumeCommand", "cloudUrl"], undefined>, undefined>;
5419
+ }, undefined>;
5420
+ /** One marker pair over every wrapped block in the response, present always. */
5421
+ readonly untrusted: v.ObjectSchema<{
5422
+ readonly token: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
5423
+ readonly startMarker: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
5424
+ readonly endMarker: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
5425
+ readonly note: v.StringSchema<undefined>;
5426
+ }, undefined>;
5427
+ }, undefined>;
5428
+ export type SessionDigestResponse = v.InferOutput<typeof SessionDigestResponseSchema>;
5044
5429
  /**
5045
- * The corpora a search can reach today (`universal-search`, deliverable 1).
5430
+ * The corpora a search can reach today.
5046
5431
  *
5047
5432
  * `guides` is guide bodies and their author-written eval criteria; `verdicts`
5048
- * is the grader's reasoning for why a session did or did not follow a guide.
5049
- * One registry on the server declares how each is matched and scoped; this
5050
- * list is only what a caller may name.
5433
+ * is the grader's reasoning for why a session did or did not follow a guide;
5434
+ * `content` is the name and body of the documents saved in bundles; `comments`
5435
+ * is the text of comments left on guides and documents; `turns` is what the
5436
+ * caller themself said to their agents, redacted. One registry on the
5437
+ * server declares how each is matched and scoped; this list is only what a
5438
+ * caller may name.
5051
5439
  */
5052
- export declare const SEARCH_CORPUS_IDS: readonly ["guides", "verdicts"];
5053
- export declare const SearchCorpusIdSchema: v.PicklistSchema<readonly ["guides", "verdicts"], undefined>;
5440
+ export declare const SEARCH_CORPUS_IDS: readonly ["guides", "verdicts", "content", "comments", "turns"];
5441
+ export declare const SearchCorpusIdSchema: v.PicklistSchema<readonly ["guides", "verdicts", "content", "comments", "turns"], undefined>;
5054
5442
  export type SearchCorpusId = v.InferOutput<typeof SearchCorpusIdSchema>;
5055
5443
  /**
5056
- * Every stored text no search reaches yet — session findings, actions and
5057
- * their narration, guide suggestions, and feedback candidates. Every response
5058
- * names them, so "nothing found" can never be read as covering them. (Earlier
5059
- * wordings of a guide are deliberately never searched, which is a different
5060
- * thing from not yet.)
5444
+ * Every stored text no search reaches yet — comments left on a session (a
5445
+ * comment on a guide or document is searched; findings and guide suggestions
5446
+ * are comments), the sessions a run records, and the actions and
5447
+ * their narration. Every response names them, so "nothing found" can never be read
5448
+ * as covering them. (Earlier wordings of a guide are deliberately never
5449
+ * searched, which is a different thing from not yet.)
5061
5450
  */
5062
- export declare const SEARCH_UNIMPLEMENTED_CORPORA: readonly ["findings", "actions", "suggestions", "feedback-candidates"];
5063
- export declare const SearchUnimplementedCorpusSchema: v.PicklistSchema<readonly ["findings", "actions", "suggestions", "feedback-candidates"], undefined>;
5451
+ export declare const SEARCH_UNIMPLEMENTED_CORPORA: readonly ["session-comments", "sessions", "actions"];
5452
+ export declare const SearchUnimplementedCorpusSchema: v.PicklistSchema<readonly ["session-comments", "sessions", "actions"], undefined>;
5064
5453
  /** Hits returned per corpus when the caller does not say. */
5065
5454
  export declare const SEARCH_DEFAULT_LIMIT = 10;
5066
5455
  /** The most hits one corpus returns. Totals are counted past it. */
@@ -5087,10 +5476,42 @@ export declare const SearchTermSchema: v.SchemaWithPipe<readonly [v.StringSchema
5087
5476
  export declare const SEARCH_DETAILS: readonly ["excerpt", "section"];
5088
5477
  export declare const SearchDetailSchema: v.PicklistSchema<readonly ["excerpt", "section"], undefined>;
5089
5478
  export type SearchDetail = v.InferOutput<typeof SearchDetailSchema>;
5479
+ /** Frontmatter filters a `content` search accepts at once. */
5480
+ export declare const SEARCH_MAX_FRONTMATTER_FILTERS = 3;
5481
+ /**
5482
+ * One top-level frontmatter field a `content` item must carry, by exact scalar
5483
+ * value (`type: recipe`). The key is a plain YAML key so it can be matched
5484
+ * without being interpreted; the value is literal text, compared
5485
+ * case-insensitively.
5486
+ */
5487
+ export declare const SearchFrontmatterSchema: v.SchemaWithPipe<readonly [v.RecordSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "frontmatter keys are plain names">]>, v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, "a frontmatter value must not be empty">, v.MaxLengthAction<string, 100, "a frontmatter value must be at most 100 characters">, v.CheckAction<string, "a frontmatter value must not contain control characters">]>, undefined>, v.CheckAction<{
5488
+ [x: string]: string;
5489
+ }, "frontmatter takes between 1 and 3 fields">]>;
5490
+ export type SearchFrontmatter = v.InferOutput<typeof SearchFrontmatterSchema>;
5491
+ /** Who wrote a comment: a person, an agent, or Mossbear itself. */
5492
+ export declare const SEARCH_COMMENT_AUTHOR_KINDS: readonly ["person", "agent", "mossbear"];
5493
+ export declare const SearchCommentAuthorKindSchema: v.PicklistSchema<readonly ["person", "agent", "mossbear"], undefined>;
5494
+ export type SearchCommentAuthorKind = v.InferOutput<typeof SearchCommentAuthorKindSchema>;
5495
+ /**
5496
+ * What a comment is attached to. `item` is a guide or a document; `session` is
5497
+ * accepted so a caller can ask for it, but nothing searches session comments
5498
+ * yet, and a request that names only `session` says so rather than returning
5499
+ * an empty match.
5500
+ */
5501
+ export declare const SEARCH_COMMENT_SUBJECT_KINDS: readonly ["item", "session"];
5502
+ export declare const SearchCommentSubjectKindSchema: v.PicklistSchema<readonly ["item", "session"], undefined>;
5503
+ export type SearchCommentSubjectKind = v.InferOutput<typeof SearchCommentSubjectKindSchema>;
5504
+ /**
5505
+ * What a user turn was, as the session classifier labels it. The same
5506
+ * vocabulary the classifier writes; a `turns` search may keep only some.
5507
+ */
5508
+ export declare const SEARCH_STEERING_LABELS: readonly ["correction", "steering", "new request", "acknowledgement", "insufficient evidence"];
5509
+ export declare const SearchSteeringLabelSchema: v.PicklistSchema<readonly ["correction", "steering", "new request", "acknowledgement", "insufficient evidence"], undefined>;
5510
+ export type SearchSteeringLabel = v.InferOutput<typeof SearchSteeringLabelSchema>;
5090
5511
  export declare const SearchRequestSchema: v.ObjectSchema<{
5091
5512
  readonly q: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 2, "q must be at least 2 characters">, v.MaxLengthAction<string, 200, "q must be at most 200 characters">, v.CheckAction<string, "q must not contain control characters">, v.CheckAction<string, "q must contain at least 2 characters besides * and ?">]>;
5092
5513
  /** Which corpora to search; every one when absent. */
5093
- readonly corpora: v.OptionalSchema<v.SchemaWithPipe<readonly [v.ArraySchema<v.PicklistSchema<readonly ["guides", "verdicts"], undefined>, undefined>, v.MinLengthAction<("guides" | "verdicts")[], 1, undefined>]>, undefined>;
5514
+ readonly corpora: v.OptionalSchema<v.SchemaWithPipe<readonly [v.ArraySchema<v.PicklistSchema<readonly ["guides", "verdicts", "content", "comments", "turns"], undefined>, undefined>, v.MinLengthAction<("content" | "guides" | "comments" | "turns" | "verdicts")[], 1, undefined>]>, undefined>;
5094
5515
  /**
5095
5516
  * The bundles a scoped caller may read content from — `mossbear mcp
5096
5517
  * --bundles` resolved to ids by the CLI, since the server never sees that
@@ -5108,13 +5529,35 @@ export declare const SearchRequestSchema: v.ObjectSchema<{
5108
5529
  * id the caller cannot read matches nothing. Does not touch other corpora.
5109
5530
  */
5110
5531
  readonly fileIds: 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[], 25, undefined>]>, undefined>;
5532
+ /**
5533
+ * Restrict the `content` corpus to items whose frontmatter carries every one
5534
+ * of these fields. Does not touch other corpora.
5535
+ */
5536
+ readonly frontmatter: v.OptionalSchema<v.SchemaWithPipe<readonly [v.RecordSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "frontmatter keys are plain names">]>, v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, "a frontmatter value must not be empty">, v.MaxLengthAction<string, 100, "a frontmatter value must be at most 100 characters">, v.CheckAction<string, "a frontmatter value must not contain control characters">]>, undefined>, v.CheckAction<{
5537
+ [x: string]: string;
5538
+ }, "frontmatter takes between 1 and 3 fields">]>, undefined>;
5539
+ /**
5540
+ * Restrict the `comments` corpus to comments written by these kinds of
5541
+ * author. Does not touch other corpora.
5542
+ */
5543
+ readonly authorKinds: v.OptionalSchema<v.SchemaWithPipe<readonly [v.ArraySchema<v.PicklistSchema<readonly ["person", "agent", "mossbear"], undefined>, undefined>, v.MinLengthAction<("person" | "agent" | "mossbear")[], 1, undefined>]>, undefined>;
5544
+ /**
5545
+ * Restrict the `comments` corpus to comments on these kinds of subject. Does
5546
+ * not touch other corpora.
5547
+ */
5548
+ readonly subjectKinds: v.OptionalSchema<v.SchemaWithPipe<readonly [v.ArraySchema<v.PicklistSchema<readonly ["item", "session"], undefined>, undefined>, v.MinLengthAction<("item" | "session")[], 1, undefined>]>, undefined>;
5549
+ /**
5550
+ * Restrict the `turns` corpus to turns the classifier gave one of these
5551
+ * labels. A turn with no label never matches. Does not touch other corpora.
5552
+ */
5553
+ readonly steeringLabels: v.OptionalSchema<v.SchemaWithPipe<readonly [v.ArraySchema<v.PicklistSchema<readonly ["correction", "steering", "new request", "acknowledgement", "insufficient evidence"], undefined>, undefined>, v.MinLengthAction<("correction" | "steering" | "new request" | "acknowledgement" | "insufficient evidence")[], 1, undefined>]>, undefined>;
5111
5554
  }, undefined>;
5112
5555
  export type SearchRequest = v.InferOutput<typeof SearchRequestSchema>;
5113
5556
  /**
5114
5557
  * Why a corpus was not searched. Codes, never prose: each caller writes its own
5115
5558
  * sentence, and the dashboard's has to be a translatable one.
5116
5559
  */
5117
- export declare const SearchSkipReasonSchema: v.PicklistSchema<["excluded-by-caller", "timed-out", "not-granted"], undefined>;
5560
+ export declare const SearchSkipReasonSchema: v.PicklistSchema<["excluded-by-caller", "timed-out", "not-granted", "not-yet-searchable"], undefined>;
5118
5561
  export type SearchSkipReason = v.InferOutput<typeof SearchSkipReasonSchema>;
5119
5562
  /** Why a searched corpus covered less than the caller's whole scope. */
5120
5563
  export declare const SearchNarrowingSchema: v.PicklistSchema<["narrowed-by-bundle-allowlist"], undefined>;
@@ -5162,6 +5605,111 @@ export declare const SearchVerdictHitSchema: v.ObjectSchema<{
5162
5605
  readonly reasoning: v.StringSchema<undefined>;
5163
5606
  }, undefined>;
5164
5607
  export type SearchVerdictHit = v.InferOutput<typeof SearchVerdictHitSchema>;
5608
+ /**
5609
+ * A saved document whose name or body matched — an item `pull_context` returns
5610
+ * as `type: content`. The name, workspace name and excerpt are wrapped in
5611
+ * `untrusted`'s markers.
5612
+ */
5613
+ export declare const SearchContentHitSchema: v.ObjectSchema<{
5614
+ readonly itemId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
5615
+ /** Wrapped in `untrusted`'s markers; null when the item has no name. */
5616
+ readonly name: v.NullableSchema<v.StringSchema<undefined>, undefined>;
5617
+ readonly workspaceId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
5618
+ /** Wrapped in `untrusted`'s markers. */
5619
+ readonly workspaceName: v.StringSchema<undefined>;
5620
+ /**
5621
+ * Slugs of the bundles that hold the item and that the caller may read — the
5622
+ * argument `pull_context` takes to read the whole document. Never more than
5623
+ * a scoped caller's allowlist reaches.
5624
+ */
5625
+ readonly bundles: v.ArraySchema<v.StringSchema<undefined>, undefined>;
5626
+ readonly updatedAt: v.StringSchema<undefined>;
5627
+ /**
5628
+ * Where the item opens on the dashboard. Added by the CLI, which knows the
5629
+ * dashboard's address; the server does not send it.
5630
+ */
5631
+ readonly url: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
5632
+ /** A window around the match, wrapped in `untrusted`'s markers. */
5633
+ readonly excerpt: v.StringSchema<undefined>;
5634
+ }, undefined>;
5635
+ export type SearchContentHit = v.InferOutput<typeof SearchContentHitSchema>;
5636
+ /**
5637
+ * A comment on a guide or document that matched. `body` and `itemName` and
5638
+ * `workspaceName` are wrapped in `untrusted`'s markers.
5639
+ */
5640
+ export declare const SearchCommentHitSchema: v.ObjectSchema<{
5641
+ readonly commentId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
5642
+ /** The thread's root; equal to `commentId` for a root comment. */
5643
+ readonly threadId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
5644
+ readonly authorKind: v.PicklistSchema<readonly ["person", "agent", "mossbear"], undefined>;
5645
+ readonly subjectKind: v.LiteralSchema<"item", undefined>;
5646
+ readonly itemId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
5647
+ /**
5648
+ * The guide the item belongs to, or null for a standalone document. A comment
5649
+ * on a guide sits on its body file, so this is the id the dashboard's guide
5650
+ * page takes; `itemId` is the one a document page takes.
5651
+ */
5652
+ readonly guideId: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>;
5653
+ /** Wrapped in `untrusted`'s markers; null when the item has no name. */
5654
+ readonly itemName: v.NullableSchema<v.StringSchema<undefined>, undefined>;
5655
+ readonly workspaceId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
5656
+ /** Wrapped in `untrusted`'s markers. */
5657
+ readonly workspaceName: v.StringSchema<undefined>;
5658
+ /** Whether the thread has been resolved — a resolved thread is answered, not open. */
5659
+ readonly resolved: v.BooleanSchema<undefined>;
5660
+ /** Whether the item has been edited since the comment was written. */
5661
+ readonly itemChangedSince: v.BooleanSchema<undefined>;
5662
+ /**
5663
+ * Whether the match is in the comment's text or in the replacement it
5664
+ * suggests (Mossbear's drafted edits).
5665
+ */
5666
+ readonly matchedIn: v.PicklistSchema<["body", "suggestion"], undefined>;
5667
+ /**
5668
+ * A Mossbear suggestion's draft state: whether its owner has handed it to
5669
+ * their agents. Absent on a person's or an agent's comment and on a reply.
5670
+ */
5671
+ readonly approved: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
5672
+ readonly createdAt: v.StringSchema<undefined>;
5673
+ /**
5674
+ * Where the comment's item opens on the dashboard. Added by the CLI, which
5675
+ * knows the dashboard's address; the server does not send it.
5676
+ */
5677
+ readonly url: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
5678
+ /** A window around the match, wrapped in `untrusted`'s markers. */
5679
+ readonly excerpt: v.StringSchema<undefined>;
5680
+ }, undefined>;
5681
+ export type SearchCommentHit = v.InferOutput<typeof SearchCommentHitSchema>;
5682
+ /**
5683
+ * One thing the caller said to an agent, redacted at the source. `excerpt` and
5684
+ * `projectId` and `branch` are wrapped in `untrusted`'s markers: a turn is text a
5685
+ * person typed (or pasted) and a branch name is whatever git was told.
5686
+ */
5687
+ export declare const SearchTurnHitSchema: v.ObjectSchema<{
5688
+ /** The agent's own session id — the key a session digest takes. */
5689
+ readonly agentSessionId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
5690
+ /**
5691
+ * The dashboard's id for the session, which its session page takes. Null when
5692
+ * the session has not been recorded as a run yet.
5693
+ */
5694
+ readonly sessionId: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>;
5695
+ /** Which turn of the session this was, counting from 1. */
5696
+ readonly ordinal: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>;
5697
+ /** Null when the classifier has not labelled the turn. */
5698
+ readonly steeringLabel: v.NullableSchema<v.PicklistSchema<readonly ["correction", "steering", "new request", "acknowledgement", "insufficient evidence"], undefined>, undefined>;
5699
+ /** Wrapped in `untrusted`'s markers; null where the session recorded none. */
5700
+ readonly projectId: v.NullableSchema<v.StringSchema<undefined>, undefined>;
5701
+ /** Wrapped in `untrusted`'s markers; null where the session recorded none. */
5702
+ readonly branch: v.NullableSchema<v.StringSchema<undefined>, undefined>;
5703
+ readonly createdAt: v.StringSchema<undefined>;
5704
+ /**
5705
+ * Where the session opens on the dashboard. Added by the CLI, which knows the
5706
+ * dashboard's address; the server does not send it.
5707
+ */
5708
+ readonly url: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
5709
+ /** A window around the match, wrapped in `untrusted`'s markers. */
5710
+ readonly excerpt: v.StringSchema<undefined>;
5711
+ }, undefined>;
5712
+ export type SearchTurnHit = v.InferOutput<typeof SearchTurnHitSchema>;
5165
5713
  export declare const SearchGuidesReportSchema: v.VariantSchema<"status", [v.ObjectSchema<{
5166
5714
  readonly status: v.LiteralSchema<"searched", undefined>;
5167
5715
  /** Every match in scope, counted past the returned page. */
@@ -5198,7 +5746,7 @@ export declare const SearchGuidesReportSchema: v.VariantSchema<"status", [v.Obje
5198
5746
  }, undefined>, undefined>;
5199
5747
  }, undefined>, v.ObjectSchema<{
5200
5748
  readonly status: v.LiteralSchema<"skipped", undefined>;
5201
- readonly reason: v.PicklistSchema<["excluded-by-caller", "timed-out", "not-granted"], undefined>;
5749
+ readonly reason: v.PicklistSchema<["excluded-by-caller", "timed-out", "not-granted", "not-yet-searchable"], undefined>;
5202
5750
  }, undefined>], undefined>;
5203
5751
  export declare const SearchVerdictsReportSchema: v.VariantSchema<"status", [v.ObjectSchema<{
5204
5752
  readonly status: v.LiteralSchema<"searched", undefined>;
@@ -5220,10 +5768,131 @@ export declare const SearchVerdictsReportSchema: v.VariantSchema<"status", [v.Ob
5220
5768
  }, undefined>, undefined>;
5221
5769
  }, undefined>, v.ObjectSchema<{
5222
5770
  readonly status: v.LiteralSchema<"skipped", undefined>;
5223
- readonly reason: v.PicklistSchema<["excluded-by-caller", "timed-out", "not-granted"], undefined>;
5771
+ readonly reason: v.PicklistSchema<["excluded-by-caller", "timed-out", "not-granted", "not-yet-searchable"], undefined>;
5772
+ }, undefined>], undefined>;
5773
+ export declare const SearchContentReportSchema: v.VariantSchema<"status", [v.ObjectSchema<{
5774
+ readonly status: v.LiteralSchema<"searched", undefined>;
5775
+ /** Every match in scope, counted past the returned page. */
5776
+ readonly total: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
5777
+ readonly narrowedBy: v.NullableSchema<v.PicklistSchema<["narrowed-by-bundle-allowlist"], undefined>, undefined>;
5778
+ /** Newest first, at most the request's limit. */
5779
+ readonly hits: v.ArraySchema<v.ObjectSchema<{
5780
+ readonly itemId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
5781
+ /** Wrapped in `untrusted`'s markers; null when the item has no name. */
5782
+ readonly name: v.NullableSchema<v.StringSchema<undefined>, undefined>;
5783
+ readonly workspaceId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
5784
+ /** Wrapped in `untrusted`'s markers. */
5785
+ readonly workspaceName: v.StringSchema<undefined>;
5786
+ /**
5787
+ * Slugs of the bundles that hold the item and that the caller may read — the
5788
+ * argument `pull_context` takes to read the whole document. Never more than
5789
+ * a scoped caller's allowlist reaches.
5790
+ */
5791
+ readonly bundles: v.ArraySchema<v.StringSchema<undefined>, undefined>;
5792
+ readonly updatedAt: v.StringSchema<undefined>;
5793
+ /**
5794
+ * Where the item opens on the dashboard. Added by the CLI, which knows the
5795
+ * dashboard's address; the server does not send it.
5796
+ */
5797
+ readonly url: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
5798
+ /** A window around the match, wrapped in `untrusted`'s markers. */
5799
+ readonly excerpt: v.StringSchema<undefined>;
5800
+ }, undefined>, undefined>;
5801
+ }, undefined>, v.ObjectSchema<{
5802
+ readonly status: v.LiteralSchema<"skipped", undefined>;
5803
+ readonly reason: v.PicklistSchema<["excluded-by-caller", "timed-out", "not-granted", "not-yet-searchable"], undefined>;
5804
+ }, undefined>], undefined>;
5805
+ export declare const SearchCommentsReportSchema: v.VariantSchema<"status", [v.ObjectSchema<{
5806
+ readonly status: v.LiteralSchema<"searched", undefined>;
5807
+ /** Every match in scope, counted past the returned page. */
5808
+ readonly total: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
5809
+ readonly narrowedBy: v.NullableSchema<v.PicklistSchema<["narrowed-by-bundle-allowlist"], undefined>, undefined>;
5810
+ /** Newest first, at most the request's limit. */
5811
+ readonly hits: v.ArraySchema<v.ObjectSchema<{
5812
+ readonly commentId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
5813
+ /** The thread's root; equal to `commentId` for a root comment. */
5814
+ readonly threadId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
5815
+ readonly authorKind: v.PicklistSchema<readonly ["person", "agent", "mossbear"], undefined>;
5816
+ readonly subjectKind: v.LiteralSchema<"item", undefined>;
5817
+ readonly itemId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
5818
+ /**
5819
+ * The guide the item belongs to, or null for a standalone document. A comment
5820
+ * on a guide sits on its body file, so this is the id the dashboard's guide
5821
+ * page takes; `itemId` is the one a document page takes.
5822
+ */
5823
+ readonly guideId: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>;
5824
+ /** Wrapped in `untrusted`'s markers; null when the item has no name. */
5825
+ readonly itemName: v.NullableSchema<v.StringSchema<undefined>, undefined>;
5826
+ readonly workspaceId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
5827
+ /** Wrapped in `untrusted`'s markers. */
5828
+ readonly workspaceName: v.StringSchema<undefined>;
5829
+ /** Whether the thread has been resolved — a resolved thread is answered, not open. */
5830
+ readonly resolved: v.BooleanSchema<undefined>;
5831
+ /** Whether the item has been edited since the comment was written. */
5832
+ readonly itemChangedSince: v.BooleanSchema<undefined>;
5833
+ /**
5834
+ * Whether the match is in the comment's text or in the replacement it
5835
+ * suggests (Mossbear's drafted edits).
5836
+ */
5837
+ readonly matchedIn: v.PicklistSchema<["body", "suggestion"], undefined>;
5838
+ /**
5839
+ * A Mossbear suggestion's draft state: whether its owner has handed it to
5840
+ * their agents. Absent on a person's or an agent's comment and on a reply.
5841
+ */
5842
+ readonly approved: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
5843
+ readonly createdAt: v.StringSchema<undefined>;
5844
+ /**
5845
+ * Where the comment's item opens on the dashboard. Added by the CLI, which
5846
+ * knows the dashboard's address; the server does not send it.
5847
+ */
5848
+ readonly url: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
5849
+ /** A window around the match, wrapped in `untrusted`'s markers. */
5850
+ readonly excerpt: v.StringSchema<undefined>;
5851
+ }, undefined>, undefined>;
5852
+ }, undefined>, v.ObjectSchema<{
5853
+ readonly status: v.LiteralSchema<"skipped", undefined>;
5854
+ readonly reason: v.PicklistSchema<["excluded-by-caller", "timed-out", "not-granted", "not-yet-searchable"], undefined>;
5855
+ }, undefined>], undefined>;
5856
+ export declare const SearchTurnsReportSchema: v.VariantSchema<"status", [v.ObjectSchema<{
5857
+ readonly status: v.LiteralSchema<"searched", undefined>;
5858
+ /** Every match in scope, counted past the returned page. */
5859
+ readonly total: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
5860
+ readonly narrowedBy: v.NullableSchema<v.PicklistSchema<["narrowed-by-bundle-allowlist"], undefined>, undefined>;
5861
+ /** Newest first, at most the request's limit. */
5862
+ readonly hits: v.ArraySchema<v.ObjectSchema<{
5863
+ /** The agent's own session id — the key a session digest takes. */
5864
+ readonly agentSessionId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
5865
+ /**
5866
+ * The dashboard's id for the session, which its session page takes. Null when
5867
+ * the session has not been recorded as a run yet.
5868
+ */
5869
+ readonly sessionId: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>;
5870
+ /** Which turn of the session this was, counting from 1. */
5871
+ readonly ordinal: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>;
5872
+ /** Null when the classifier has not labelled the turn. */
5873
+ readonly steeringLabel: v.NullableSchema<v.PicklistSchema<readonly ["correction", "steering", "new request", "acknowledgement", "insufficient evidence"], undefined>, undefined>;
5874
+ /** Wrapped in `untrusted`'s markers; null where the session recorded none. */
5875
+ readonly projectId: v.NullableSchema<v.StringSchema<undefined>, undefined>;
5876
+ /** Wrapped in `untrusted`'s markers; null where the session recorded none. */
5877
+ readonly branch: v.NullableSchema<v.StringSchema<undefined>, undefined>;
5878
+ readonly createdAt: v.StringSchema<undefined>;
5879
+ /**
5880
+ * Where the session opens on the dashboard. Added by the CLI, which knows the
5881
+ * dashboard's address; the server does not send it.
5882
+ */
5883
+ readonly url: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
5884
+ /** A window around the match, wrapped in `untrusted`'s markers. */
5885
+ readonly excerpt: v.StringSchema<undefined>;
5886
+ }, undefined>, undefined>;
5887
+ }, undefined>, v.ObjectSchema<{
5888
+ readonly status: v.LiteralSchema<"skipped", undefined>;
5889
+ readonly reason: v.PicklistSchema<["excluded-by-caller", "timed-out", "not-granted", "not-yet-searchable"], undefined>;
5224
5890
  }, undefined>], undefined>;
5225
5891
  export type SearchGuidesReport = v.InferOutput<typeof SearchGuidesReportSchema>;
5226
5892
  export type SearchVerdictsReport = v.InferOutput<typeof SearchVerdictsReportSchema>;
5893
+ export type SearchContentReport = v.InferOutput<typeof SearchContentReportSchema>;
5894
+ export type SearchCommentsReport = v.InferOutput<typeof SearchCommentsReportSchema>;
5895
+ export type SearchTurnsReport = v.InferOutput<typeof SearchTurnsReportSchema>;
5227
5896
  /**
5228
5897
  * A search's answer: **a report per corpus, never a bare list.**
5229
5898
  *
@@ -5271,7 +5940,7 @@ export declare const SearchResponseSchema: v.ObjectSchema<{
5271
5940
  }, undefined>, undefined>;
5272
5941
  }, undefined>, v.ObjectSchema<{
5273
5942
  readonly status: v.LiteralSchema<"skipped", undefined>;
5274
- readonly reason: v.PicklistSchema<["excluded-by-caller", "timed-out", "not-granted"], undefined>;
5943
+ readonly reason: v.PicklistSchema<["excluded-by-caller", "timed-out", "not-granted", "not-yet-searchable"], undefined>;
5275
5944
  }, undefined>], undefined>;
5276
5945
  readonly verdicts: v.VariantSchema<"status", [v.ObjectSchema<{
5277
5946
  readonly status: v.LiteralSchema<"searched", undefined>;
@@ -5293,10 +5962,135 @@ export declare const SearchResponseSchema: v.ObjectSchema<{
5293
5962
  }, undefined>, undefined>;
5294
5963
  }, undefined>, v.ObjectSchema<{
5295
5964
  readonly status: v.LiteralSchema<"skipped", undefined>;
5296
- readonly reason: v.PicklistSchema<["excluded-by-caller", "timed-out", "not-granted"], undefined>;
5965
+ readonly reason: v.PicklistSchema<["excluded-by-caller", "timed-out", "not-granted", "not-yet-searchable"], undefined>;
5297
5966
  }, undefined>], undefined>;
5967
+ /**
5968
+ * Optional because a server that predates the `content` corpus does not
5969
+ * send it — and then did not search it, which a caller must say rather
5970
+ * than read as zero hits.
5971
+ */
5972
+ readonly content: v.OptionalSchema<v.VariantSchema<"status", [v.ObjectSchema<{
5973
+ readonly status: v.LiteralSchema<"searched", undefined>;
5974
+ /** Every match in scope, counted past the returned page. */
5975
+ readonly total: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
5976
+ readonly narrowedBy: v.NullableSchema<v.PicklistSchema<["narrowed-by-bundle-allowlist"], undefined>, undefined>;
5977
+ /** Newest first, at most the request's limit. */
5978
+ readonly hits: v.ArraySchema<v.ObjectSchema<{
5979
+ readonly itemId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
5980
+ /** Wrapped in `untrusted`'s markers; null when the item has no name. */
5981
+ readonly name: v.NullableSchema<v.StringSchema<undefined>, undefined>;
5982
+ readonly workspaceId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
5983
+ /** Wrapped in `untrusted`'s markers. */
5984
+ readonly workspaceName: v.StringSchema<undefined>;
5985
+ /**
5986
+ * Slugs of the bundles that hold the item and that the caller may read — the
5987
+ * argument `pull_context` takes to read the whole document. Never more than
5988
+ * a scoped caller's allowlist reaches.
5989
+ */
5990
+ readonly bundles: v.ArraySchema<v.StringSchema<undefined>, undefined>;
5991
+ readonly updatedAt: v.StringSchema<undefined>;
5992
+ /**
5993
+ * Where the item opens on the dashboard. Added by the CLI, which knows the
5994
+ * dashboard's address; the server does not send it.
5995
+ */
5996
+ readonly url: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
5997
+ /** A window around the match, wrapped in `untrusted`'s markers. */
5998
+ readonly excerpt: v.StringSchema<undefined>;
5999
+ }, undefined>, undefined>;
6000
+ }, undefined>, v.ObjectSchema<{
6001
+ readonly status: v.LiteralSchema<"skipped", undefined>;
6002
+ readonly reason: v.PicklistSchema<["excluded-by-caller", "timed-out", "not-granted", "not-yet-searchable"], undefined>;
6003
+ }, undefined>], undefined>, undefined>;
6004
+ /** Optional for the same reason as `content`. Covers comments on guides and documents only. */
6005
+ readonly comments: v.OptionalSchema<v.VariantSchema<"status", [v.ObjectSchema<{
6006
+ readonly status: v.LiteralSchema<"searched", undefined>;
6007
+ /** Every match in scope, counted past the returned page. */
6008
+ readonly total: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
6009
+ readonly narrowedBy: v.NullableSchema<v.PicklistSchema<["narrowed-by-bundle-allowlist"], undefined>, undefined>;
6010
+ /** Newest first, at most the request's limit. */
6011
+ readonly hits: v.ArraySchema<v.ObjectSchema<{
6012
+ readonly commentId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
6013
+ /** The thread's root; equal to `commentId` for a root comment. */
6014
+ readonly threadId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
6015
+ readonly authorKind: v.PicklistSchema<readonly ["person", "agent", "mossbear"], undefined>;
6016
+ readonly subjectKind: v.LiteralSchema<"item", undefined>;
6017
+ readonly itemId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
6018
+ /**
6019
+ * The guide the item belongs to, or null for a standalone document. A comment
6020
+ * on a guide sits on its body file, so this is the id the dashboard's guide
6021
+ * page takes; `itemId` is the one a document page takes.
6022
+ */
6023
+ readonly guideId: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>;
6024
+ /** Wrapped in `untrusted`'s markers; null when the item has no name. */
6025
+ readonly itemName: v.NullableSchema<v.StringSchema<undefined>, undefined>;
6026
+ readonly workspaceId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
6027
+ /** Wrapped in `untrusted`'s markers. */
6028
+ readonly workspaceName: v.StringSchema<undefined>;
6029
+ /** Whether the thread has been resolved — a resolved thread is answered, not open. */
6030
+ readonly resolved: v.BooleanSchema<undefined>;
6031
+ /** Whether the item has been edited since the comment was written. */
6032
+ readonly itemChangedSince: v.BooleanSchema<undefined>;
6033
+ /**
6034
+ * Whether the match is in the comment's text or in the replacement it
6035
+ * suggests (Mossbear's drafted edits).
6036
+ */
6037
+ readonly matchedIn: v.PicklistSchema<["body", "suggestion"], undefined>;
6038
+ /**
6039
+ * A Mossbear suggestion's draft state: whether its owner has handed it to
6040
+ * their agents. Absent on a person's or an agent's comment and on a reply.
6041
+ */
6042
+ readonly approved: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
6043
+ readonly createdAt: v.StringSchema<undefined>;
6044
+ /**
6045
+ * Where the comment's item opens on the dashboard. Added by the CLI, which
6046
+ * knows the dashboard's address; the server does not send it.
6047
+ */
6048
+ readonly url: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
6049
+ /** A window around the match, wrapped in `untrusted`'s markers. */
6050
+ readonly excerpt: v.StringSchema<undefined>;
6051
+ }, undefined>, undefined>;
6052
+ }, undefined>, v.ObjectSchema<{
6053
+ readonly status: v.LiteralSchema<"skipped", undefined>;
6054
+ readonly reason: v.PicklistSchema<["excluded-by-caller", "timed-out", "not-granted", "not-yet-searchable"], undefined>;
6055
+ }, undefined>], undefined>, undefined>;
6056
+ /** Optional for the same reason as `content`. The caller's own turns, never a workspace-mate's. */
6057
+ readonly turns: v.OptionalSchema<v.VariantSchema<"status", [v.ObjectSchema<{
6058
+ readonly status: v.LiteralSchema<"searched", undefined>;
6059
+ /** Every match in scope, counted past the returned page. */
6060
+ readonly total: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
6061
+ readonly narrowedBy: v.NullableSchema<v.PicklistSchema<["narrowed-by-bundle-allowlist"], undefined>, undefined>;
6062
+ /** Newest first, at most the request's limit. */
6063
+ readonly hits: v.ArraySchema<v.ObjectSchema<{
6064
+ /** The agent's own session id — the key a session digest takes. */
6065
+ readonly agentSessionId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
6066
+ /**
6067
+ * The dashboard's id for the session, which its session page takes. Null when
6068
+ * the session has not been recorded as a run yet.
6069
+ */
6070
+ readonly sessionId: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>;
6071
+ /** Which turn of the session this was, counting from 1. */
6072
+ readonly ordinal: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>;
6073
+ /** Null when the classifier has not labelled the turn. */
6074
+ readonly steeringLabel: v.NullableSchema<v.PicklistSchema<readonly ["correction", "steering", "new request", "acknowledgement", "insufficient evidence"], undefined>, undefined>;
6075
+ /** Wrapped in `untrusted`'s markers; null where the session recorded none. */
6076
+ readonly projectId: v.NullableSchema<v.StringSchema<undefined>, undefined>;
6077
+ /** Wrapped in `untrusted`'s markers; null where the session recorded none. */
6078
+ readonly branch: v.NullableSchema<v.StringSchema<undefined>, undefined>;
6079
+ readonly createdAt: v.StringSchema<undefined>;
6080
+ /**
6081
+ * Where the session opens on the dashboard. Added by the CLI, which knows the
6082
+ * dashboard's address; the server does not send it.
6083
+ */
6084
+ readonly url: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
6085
+ /** A window around the match, wrapped in `untrusted`'s markers. */
6086
+ readonly excerpt: v.StringSchema<undefined>;
6087
+ }, undefined>, undefined>;
6088
+ }, undefined>, v.ObjectSchema<{
6089
+ readonly status: v.LiteralSchema<"skipped", undefined>;
6090
+ readonly reason: v.PicklistSchema<["excluded-by-caller", "timed-out", "not-granted", "not-yet-searchable"], undefined>;
6091
+ }, undefined>], undefined>, undefined>;
5298
6092
  }, undefined>;
5299
- readonly notYetSearchable: v.ArraySchema<v.PicklistSchema<readonly ["findings", "actions", "suggestions", "feedback-candidates"], undefined>, undefined>;
6093
+ readonly notYetSearchable: v.ArraySchema<v.PicklistSchema<["session-comments", "sessions", "actions", "comments", "turns"], undefined>, undefined>;
5300
6094
  readonly untrusted: v.ObjectSchema<{
5301
6095
  readonly token: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
5302
6096
  readonly startMarker: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
@@ -5512,7 +6306,13 @@ export declare function parseContextItem(data: unknown): {
5512
6306
  } | undefined;
5513
6307
  body: string;
5514
6308
  suggestion?: string | undefined;
5515
- evidence?: string | undefined;
6309
+ finding?: {
6310
+ tier: "observed" | "usage" | "practice";
6311
+ tierLine: string;
6312
+ blindSpot: string;
6313
+ prediction: string | null;
6314
+ } | undefined;
6315
+ approved?: boolean | undefined;
5516
6316
  authorName: string | null;
5517
6317
  createdAt: string;
5518
6318
  itemVersion: number;
@@ -5561,7 +6361,13 @@ export declare function parseContextItemsResponse(data: unknown): {
5561
6361
  } | undefined;
5562
6362
  body: string;
5563
6363
  suggestion?: string | undefined;
5564
- evidence?: string | undefined;
6364
+ finding?: {
6365
+ tier: "observed" | "usage" | "practice";
6366
+ tierLine: string;
6367
+ blindSpot: string;
6368
+ prediction: string | null;
6369
+ } | undefined;
6370
+ approved?: boolean | undefined;
5565
6371
  authorName: string | null;
5566
6372
  createdAt: string;
5567
6373
  itemVersion: number;
@@ -5632,7 +6438,13 @@ export declare function parsePushContextResponse(data: unknown): {
5632
6438
  } | undefined;
5633
6439
  body: string;
5634
6440
  suggestion?: string | undefined;
5635
- evidence?: string | undefined;
6441
+ finding?: {
6442
+ tier: "observed" | "usage" | "practice";
6443
+ tierLine: string;
6444
+ blindSpot: string;
6445
+ prediction: string | null;
6446
+ } | undefined;
6447
+ approved?: boolean | undefined;
5636
6448
  authorName: string | null;
5637
6449
  createdAt: string;
5638
6450
  itemVersion: number;
@@ -5698,7 +6510,13 @@ export declare function parseUpdateContextItemResponse(data: unknown): {
5698
6510
  } | undefined;
5699
6511
  body: string;
5700
6512
  suggestion?: string | undefined;
5701
- evidence?: string | undefined;
6513
+ finding?: {
6514
+ tier: "observed" | "usage" | "practice";
6515
+ tierLine: string;
6516
+ blindSpot: string;
6517
+ prediction: string | null;
6518
+ } | undefined;
6519
+ approved?: boolean | undefined;
5702
6520
  authorName: string | null;
5703
6521
  createdAt: string;
5704
6522
  itemVersion: number;
@@ -5763,7 +6581,13 @@ export declare function parseContextItemResponse(data: unknown): {
5763
6581
  } | undefined;
5764
6582
  body: string;
5765
6583
  suggestion?: string | undefined;
5766
- evidence?: string | undefined;
6584
+ finding?: {
6585
+ tier: "observed" | "usage" | "practice";
6586
+ tierLine: string;
6587
+ blindSpot: string;
6588
+ prediction: string | null;
6589
+ } | undefined;
6590
+ approved?: boolean | undefined;
5767
6591
  authorName: string | null;
5768
6592
  createdAt: string;
5769
6593
  itemVersion: number;
@@ -5814,7 +6638,13 @@ export declare function parseArchiveContextItemResponse(data: unknown): {
5814
6638
  } | undefined;
5815
6639
  body: string;
5816
6640
  suggestion?: string | undefined;
5817
- evidence?: string | undefined;
6641
+ finding?: {
6642
+ tier: "observed" | "usage" | "practice";
6643
+ tierLine: string;
6644
+ blindSpot: string;
6645
+ prediction: string | null;
6646
+ } | undefined;
6647
+ approved?: boolean | undefined;
5818
6648
  authorName: string | null;
5819
6649
  createdAt: string;
5820
6650
  itemVersion: number;
@@ -5933,14 +6763,6 @@ export declare function parseDashboardSyncRequest(data: unknown): {
5933
6763
  })[] | undefined;
5934
6764
  status?: "pending" | "accepted" | "dismissed" | undefined;
5935
6765
  }[] | undefined;
5936
- feedbackCandidates?: {
5937
- id?: string | undefined;
5938
- signal: string;
5939
- signalType: "correction" | "approval" | "implied_preference" | "stated_preference" | "skill_suggestion";
5940
- confidence?: number | undefined;
5941
- occurrences?: number | undefined;
5942
- status?: "dismissed" | "inferred" | "confirmed" | undefined;
5943
- }[] | undefined;
5944
6766
  runUsage?: {
5945
6767
  sessionId?: string | undefined;
5946
6768
  agentSessionId: string;
@@ -6170,7 +6992,13 @@ export declare function parseItemCommentsResponse(data: unknown): {
6170
6992
  } | undefined;
6171
6993
  body: string;
6172
6994
  suggestion?: string | undefined;
6173
- evidence?: string | undefined;
6995
+ finding?: {
6996
+ tier: "observed" | "usage" | "practice";
6997
+ tierLine: string;
6998
+ blindSpot: string;
6999
+ prediction: string | null;
7000
+ } | undefined;
7001
+ approved?: boolean | undefined;
6174
7002
  authorName: string | null;
6175
7003
  createdAt: string;
6176
7004
  itemVersion: number;
@@ -6191,8 +7019,36 @@ export declare function parseCommentEvidenceResponse(data: unknown): {
6191
7019
  commentId: string;
6192
7020
  itemName: string;
6193
7021
  itemPath: string | null;
6194
- summary: string;
7022
+ tier: "observed" | "usage" | "practice";
7023
+ tierLine: string;
7024
+ blindSpot: string;
7025
+ claim: string;
6195
7026
  prediction: string | null;
7027
+ usage: {
7028
+ path: string;
7029
+ loads: number;
7030
+ sessions: number;
7031
+ loadsWithRead: number;
7032
+ } | null;
7033
+ practice: {
7034
+ check: {
7035
+ id: string;
7036
+ name: string;
7037
+ };
7038
+ rubricVersion: number;
7039
+ practices: {
7040
+ text: string;
7041
+ source: {
7042
+ title: string;
7043
+ url: string;
7044
+ };
7045
+ }[];
7046
+ facts: string[];
7047
+ answers: {
7048
+ item: string;
7049
+ answer: string;
7050
+ }[];
7051
+ } | null;
6196
7052
  citations: {
6197
7053
  kind: "verdict" | "turn" | "navigation" | "action";
6198
7054
  sessionId: string;
@@ -6210,6 +7066,7 @@ export declare function parseCommentEvidenceResponse(data: unknown): {
6210
7066
  export declare function parseRunGradeRequest(data: unknown): {
6211
7067
  session?: string | undefined;
6212
7068
  agent_session?: string | undefined;
7069
+ detail?: "digest" | undefined;
6213
7070
  };
6214
7071
  export declare function parseSessionGradeResponse(data: unknown): {
6215
7072
  run: {
@@ -6239,6 +7096,50 @@ export declare function parseSessionGradeResponse(data: unknown): {
6239
7096
  note: string;
6240
7097
  } | null;
6241
7098
  };
7099
+ export declare function parseSessionDigestResponse(data: unknown): {
7100
+ run: {
7101
+ id: string;
7102
+ agentSessionId: string;
7103
+ startedAt: string;
7104
+ endedAt: string | null;
7105
+ status: "open" | "closed";
7106
+ };
7107
+ state: "pending" | "graded" | "nothing_to_grade" | "expired";
7108
+ grade: {
7109
+ summary: string | null;
7110
+ gradedAt: string;
7111
+ model: string | null;
7112
+ superseded: boolean;
7113
+ guides: {
7114
+ guideId: string;
7115
+ title: string;
7116
+ verdict: "aligned" | "misaligned" | "not_applicable";
7117
+ reasoning: string;
7118
+ }[];
7119
+ } | null;
7120
+ digest: {
7121
+ selfReport: string | null;
7122
+ turns: {
7123
+ ordinal: number;
7124
+ text: string;
7125
+ steeringLabel: string | null;
7126
+ }[];
7127
+ turnsTotal: number;
7128
+ repoId: string | null;
7129
+ branch: string | null;
7130
+ headSha: string | null;
7131
+ dashboardPath: string;
7132
+ dashboardUrl?: string | undefined;
7133
+ comments: string[];
7134
+ notYetAvailable: ("comments" | "resumeCommand" | "cloudUrl")[];
7135
+ };
7136
+ untrusted: {
7137
+ token: string;
7138
+ startMarker: string;
7139
+ endMarker: string;
7140
+ note: string;
7141
+ };
7142
+ };
6242
7143
  export declare function parseSearchResponse(data: unknown): {
6243
7144
  corpora: {
6244
7145
  guides: {
@@ -6257,7 +7158,7 @@ export declare function parseSearchResponse(data: unknown): {
6257
7158
  }[];
6258
7159
  } | {
6259
7160
  status: "skipped";
6260
- reason: "excluded-by-caller" | "timed-out" | "not-granted";
7161
+ reason: "excluded-by-caller" | "timed-out" | "not-granted" | "not-yet-searchable";
6261
7162
  };
6262
7163
  verdicts: {
6263
7164
  status: "searched";
@@ -6273,10 +7174,73 @@ export declare function parseSearchResponse(data: unknown): {
6273
7174
  }[];
6274
7175
  } | {
6275
7176
  status: "skipped";
6276
- reason: "excluded-by-caller" | "timed-out" | "not-granted";
7177
+ reason: "excluded-by-caller" | "timed-out" | "not-granted" | "not-yet-searchable";
6277
7178
  };
7179
+ content?: {
7180
+ status: "searched";
7181
+ total: number;
7182
+ narrowedBy: "narrowed-by-bundle-allowlist" | null;
7183
+ hits: {
7184
+ itemId: string;
7185
+ name: string | null;
7186
+ workspaceId: string;
7187
+ workspaceName: string;
7188
+ bundles: string[];
7189
+ updatedAt: string;
7190
+ url?: string | undefined;
7191
+ excerpt: string;
7192
+ }[];
7193
+ } | {
7194
+ status: "skipped";
7195
+ reason: "excluded-by-caller" | "timed-out" | "not-granted" | "not-yet-searchable";
7196
+ } | undefined;
7197
+ comments?: {
7198
+ status: "searched";
7199
+ total: number;
7200
+ narrowedBy: "narrowed-by-bundle-allowlist" | null;
7201
+ hits: {
7202
+ commentId: string;
7203
+ threadId: string;
7204
+ authorKind: "person" | "agent" | "mossbear";
7205
+ subjectKind: "item";
7206
+ itemId: string;
7207
+ guideId: string | null;
7208
+ itemName: string | null;
7209
+ workspaceId: string;
7210
+ workspaceName: string;
7211
+ resolved: boolean;
7212
+ itemChangedSince: boolean;
7213
+ matchedIn: "suggestion" | "body";
7214
+ approved?: boolean | undefined;
7215
+ createdAt: string;
7216
+ url?: string | undefined;
7217
+ excerpt: string;
7218
+ }[];
7219
+ } | {
7220
+ status: "skipped";
7221
+ reason: "excluded-by-caller" | "timed-out" | "not-granted" | "not-yet-searchable";
7222
+ } | undefined;
7223
+ turns?: {
7224
+ status: "searched";
7225
+ total: number;
7226
+ narrowedBy: "narrowed-by-bundle-allowlist" | null;
7227
+ hits: {
7228
+ agentSessionId: string;
7229
+ sessionId: string | null;
7230
+ ordinal: number;
7231
+ steeringLabel: "correction" | "steering" | "new request" | "acknowledgement" | "insufficient evidence" | null;
7232
+ projectId: string | null;
7233
+ branch: string | null;
7234
+ createdAt: string;
7235
+ url?: string | undefined;
7236
+ excerpt: string;
7237
+ }[];
7238
+ } | {
7239
+ status: "skipped";
7240
+ reason: "excluded-by-caller" | "timed-out" | "not-granted" | "not-yet-searchable";
7241
+ } | undefined;
6278
7242
  };
6279
- notYetSearchable: ("actions" | "findings" | "suggestions" | "feedback-candidates")[];
7243
+ notYetSearchable: ("comments" | "sessions" | "actions" | "turns" | "session-comments")[];
6280
7244
  untrusted: {
6281
7245
  token: string;
6282
7246
  startMarker: string;