@mossbear/protocol 0.1.0-alpha.105 → 0.1.0-alpha.107

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
@@ -592,11 +592,35 @@ export declare function displayNameSchema(maxLength: number): v.SchemaWithPipe<r
592
592
  /** A bundle's display name. Bundles are addressed by slug; this is the label. */
593
593
  export declare const BUNDLE_NAME_MAX_LENGTH = 200;
594
594
  export declare const BundleSlugSchema: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.CheckAction<string, "slug must be lowercase alphanumeric with hyphens, at most 64 characters">]>;
595
+ /**
596
+ * A publisher's lowercase handle: the prefix of a published bundle's address,
597
+ * `<handle>/<slug>` (`mossbear/guides`). Slugs are unique per workspace, so a
598
+ * bare slug names one of the caller's own bundles and a published bundle is
599
+ * named through its publisher.
600
+ */
601
+ export declare const PUBLISHER_HANDLE_PATTERN: RegExp;
602
+ export declare const PublisherHandleSchema: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "handle must be lowercase alphanumeric with hyphens">]>;
603
+ /** The longest publisher name a reader is shown. */
604
+ export declare const PUBLISHER_NAME_MAX_LENGTH = 100;
605
+ /**
606
+ * Who publishes a bundle, as a reader sees it. Present only on a bundle that is
607
+ * published; absent is the ordinary case, a bundle of the caller's own.
608
+ */
609
+ export declare const BundlePublisherSchema: v.ObjectSchema<{
610
+ readonly name: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 100, undefined>]>;
611
+ readonly handle: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "handle must be lowercase alphanumeric with hyphens">]>;
612
+ }, undefined>;
613
+ /** A published bundle's address, `<handle>/<slug>`. */
614
+ export declare const PublishedBundleAddressSchema: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 104, undefined>, v.CheckAction<string, "address must be <publisher handle>/<bundle slug>">]>;
615
+ /**
616
+ * An artifact's description as a writer sends it: one paragraph of plain text,
617
+ * with no line breaks or other control characters, so it saves on Enter like a
618
+ * title, prints safely in a terminal, and stays a plain YAML
619
+ * scalar in a Markdown artifact's frontmatter. Blank text is refused rather than
620
+ * stored: `null` is how a description is cleared, so "none" has one shape.
621
+ */
622
+ export declare const ArtifactDescriptionSchema: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "description must not be blank">, v.MaxLengthAction<string, 1000, "description must be at most 1000 characters">, v.CheckAction<string, "description must be one line of text, with no control characters">]>;
595
623
  export declare const BundleSchema: v.ObjectSchema<{
596
- readonly id: v.StringSchema<undefined>;
597
- readonly slug: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.CheckAction<string, "slug must be lowercase alphanumeric with hyphens, at most 64 characters">]>;
598
- readonly name: v.StringSchema<undefined>;
599
- readonly createdAt: v.StringSchema<undefined>;
600
624
  /**
601
625
  * The project id of the repo that owns this bundle's items, when one claims it
602
626
  * (`subscription-delivery-target-plan.md` → slice 3). Absent is the ordinary
@@ -609,13 +633,19 @@ export declare const BundleSchema: v.ObjectSchema<{
609
633
  * server's listing unchanged.
610
634
  */
611
635
  readonly home: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
636
+ readonly publisher: v.OptionalSchema<v.ObjectSchema<{
637
+ readonly name: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 100, undefined>]>;
638
+ readonly handle: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "handle must be lowercase alphanumeric with hyphens">]>;
639
+ }, undefined>, undefined>;
640
+ readonly readOnly: v.OptionalSchema<v.LiteralSchema<true, undefined>, undefined>;
641
+ readonly id: v.StringSchema<undefined>;
642
+ readonly slug: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.CheckAction<string, "slug must be lowercase alphanumeric with hyphens, at most 64 characters">]>;
643
+ readonly name: v.StringSchema<undefined>;
644
+ readonly createdAt: v.StringSchema<undefined>;
645
+ readonly description: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
612
646
  }, undefined>;
613
647
  export declare const BundleListResponseSchema: v.ObjectSchema<{
614
648
  readonly bundles: v.ArraySchema<v.ObjectSchema<{
615
- readonly id: v.StringSchema<undefined>;
616
- readonly slug: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.CheckAction<string, "slug must be lowercase alphanumeric with hyphens, at most 64 characters">]>;
617
- readonly name: v.StringSchema<undefined>;
618
- readonly createdAt: v.StringSchema<undefined>;
619
649
  /**
620
650
  * The project id of the repo that owns this bundle's items, when one claims it
621
651
  * (`subscription-delivery-target-plan.md` → slice 3). Absent is the ordinary
@@ -628,6 +658,16 @@ export declare const BundleListResponseSchema: v.ObjectSchema<{
628
658
  * server's listing unchanged.
629
659
  */
630
660
  readonly home: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
661
+ readonly publisher: v.OptionalSchema<v.ObjectSchema<{
662
+ readonly name: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 100, undefined>]>;
663
+ readonly handle: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "handle must be lowercase alphanumeric with hyphens">]>;
664
+ }, undefined>, undefined>;
665
+ readonly readOnly: v.OptionalSchema<v.LiteralSchema<true, undefined>, undefined>;
666
+ readonly id: v.StringSchema<undefined>;
667
+ readonly slug: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.CheckAction<string, "slug must be lowercase alphanumeric with hyphens, at most 64 characters">]>;
668
+ readonly name: v.StringSchema<undefined>;
669
+ readonly createdAt: v.StringSchema<undefined>;
670
+ readonly description: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
631
671
  }, undefined>, undefined>;
632
672
  }, undefined>;
633
673
  /**
@@ -687,6 +727,17 @@ export declare const SubscriptionScopeSchema: v.PicklistSchema<["repo", "user"],
687
727
  */
688
728
  export declare const DeliverTargetSchema: v.PicklistSchema<["repo", "global"], undefined>;
689
729
  export declare const ResolvedSubscriptionSchema: v.ObjectSchema<{
730
+ /**
731
+ * The address this bundle was resolved from, when the caller named it as
732
+ * `<handle>/<slug>` in `repoBundleAddresses` rather than by id. Lets the
733
+ * caller pair each committed address with the id it stands for.
734
+ */
735
+ readonly address: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 104, undefined>, v.CheckAction<string, "address must be <publisher handle>/<bundle slug>">]>, undefined>;
736
+ readonly publisher: v.OptionalSchema<v.ObjectSchema<{
737
+ readonly name: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 100, undefined>]>;
738
+ readonly handle: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "handle must be lowercase alphanumeric with hyphens">]>;
739
+ }, undefined>, undefined>;
740
+ readonly readOnly: v.OptionalSchema<v.LiteralSchema<true, undefined>, undefined>;
690
741
  readonly id: v.StringSchema<undefined>;
691
742
  readonly slug: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.CheckAction<string, "slug must be lowercase alphanumeric with hyphens, at most 64 characters">]>;
692
743
  readonly name: v.StringSchema<undefined>;
@@ -742,12 +793,31 @@ export declare const ResolvedSubscriptionSchema: v.ObjectSchema<{
742
793
  * being refused as bad input. Raised by Codex on #735.
743
794
  */
744
795
  export declare const MAX_REPO_BUNDLE_IDS = 500;
796
+ /** Capped for the reason `MAX_REPO_BUNDLE_IDS` gives. */
797
+ export declare const MAX_REPO_BUNDLE_ADDRESSES = 64;
745
798
  export declare const ResolveSubscriptionsRequestSchema: v.ObjectSchema<{
746
799
  readonly repoBundleIds: v.SchemaWithPipe<readonly [v.ArraySchema<v.StringSchema<undefined>, undefined>, v.MaxLengthAction<string[], 500, undefined>]>;
800
+ /**
801
+ * Published bundles the committed config names by address,
802
+ * `<handle>/<slug>`, rather than by id. Optional, so a CLI that sends only
803
+ * ids is answered as before.
804
+ */
805
+ readonly repoBundleAddresses: v.OptionalSchema<v.SchemaWithPipe<readonly [v.ArraySchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 104, undefined>, v.CheckAction<string, "address must be <publisher handle>/<bundle slug>">]>, undefined>, v.MaxLengthAction<string[], 64, undefined>]>, undefined>;
747
806
  }, undefined>;
748
807
  export declare const ResolveSubscriptionsResponseSchema: v.ObjectSchema<{
749
808
  /** The effective delivery set, de-duplicated by bundle id. */
750
809
  readonly bundles: v.ArraySchema<v.ObjectSchema<{
810
+ /**
811
+ * The address this bundle was resolved from, when the caller named it as
812
+ * `<handle>/<slug>` in `repoBundleAddresses` rather than by id. Lets the
813
+ * caller pair each committed address with the id it stands for.
814
+ */
815
+ readonly address: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 104, undefined>, v.CheckAction<string, "address must be <publisher handle>/<bundle slug>">]>, undefined>;
816
+ readonly publisher: v.OptionalSchema<v.ObjectSchema<{
817
+ readonly name: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 100, undefined>]>;
818
+ readonly handle: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "handle must be lowercase alphanumeric with hyphens">]>;
819
+ }, undefined>, undefined>;
820
+ readonly readOnly: v.OptionalSchema<v.LiteralSchema<true, undefined>, undefined>;
751
821
  readonly id: v.StringSchema<undefined>;
752
822
  readonly slug: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.CheckAction<string, "slug must be lowercase alphanumeric with hyphens, at most 64 characters">]>;
753
823
  readonly name: v.StringSchema<undefined>;
@@ -793,10 +863,24 @@ export declare const ResolveSubscriptionsResponseSchema: v.ObjectSchema<{
793
863
  * Committed ids the caller cannot see. **Reported, never dropped** — the line
794
864
  * was put in the config deliberately by whoever owns the repo, so a non-member
795
865
  * gets a named failure rather than deletion advice.
866
+ *
867
+ * It also names the caller's **account** subscriptions whose bundle they can
868
+ * no longer read: one unpublished, or in a workspace they left. The row is
869
+ * still theirs, so a sync must hold retirement for it as for a repo id it
870
+ * cannot see, rather than read its absence as an empty bundle.
796
871
  */
797
872
  readonly unresolved: v.ArraySchema<v.ObjectSchema<{
798
873
  readonly id: v.StringSchema<undefined>;
799
874
  }, undefined>, undefined>;
875
+ /**
876
+ * Committed addresses (`repoBundleAddresses`) that name no published bundle.
877
+ * Kept apart from `unresolved`, whose entries are ids, so a CLI that reads
878
+ * `id` off every entry is never handed one without it. Absent when the
879
+ * request named no address.
880
+ */
881
+ readonly unresolvedAddresses: v.OptionalSchema<v.ArraySchema<v.ObjectSchema<{
882
+ readonly address: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 104, undefined>, v.CheckAction<string, "address must be <publisher handle>/<bundle slug>">]>;
883
+ }, undefined>, undefined>, undefined>;
800
884
  /**
801
885
  * Account-level settings the sync needs, carried on the response every sync
802
886
  * already fetches rather than on a request of their own.
@@ -873,16 +957,13 @@ export declare const SubscribeBundleResponseSchema: v.ObjectSchema<{
873
957
  readonly muted: v.OptionalSchema<v.ArraySchema<v.StringSchema<undefined>, undefined>, undefined>;
874
958
  }, undefined>;
875
959
  export declare const CreateBundleRequestSchema: v.ObjectSchema<{
960
+ readonly description: v.OptionalSchema<v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "description must not be blank">, v.MaxLengthAction<string, 1000, "description must be at most 1000 characters">, v.CheckAction<string, "description must be one line of text, with no control characters">]>, undefined>, undefined>;
876
961
  readonly slug: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.CheckAction<string, "slug must be lowercase alphanumeric with hyphens, at most 64 characters">]>;
877
962
  readonly name: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, number, undefined>, v.CheckAction<string, "Remove the invisible characters from this name — copying text from another app often brings them along.">, v.RegexAction<string, "Remove the invisible characters from this name — copying text from another app often brings them along.">]>;
878
963
  readonly workspaceId: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>;
879
964
  }, undefined>;
880
965
  export declare const CreateBundleResponseSchema: v.ObjectSchema<{
881
966
  readonly bundle: v.ObjectSchema<{
882
- readonly id: v.StringSchema<undefined>;
883
- readonly slug: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.CheckAction<string, "slug must be lowercase alphanumeric with hyphens, at most 64 characters">]>;
884
- readonly name: v.StringSchema<undefined>;
885
- readonly createdAt: v.StringSchema<undefined>;
886
967
  /**
887
968
  * The project id of the repo that owns this bundle's items, when one claims it
888
969
  * (`subscription-delivery-target-plan.md` → slice 3). Absent is the ordinary
@@ -895,6 +976,16 @@ export declare const CreateBundleResponseSchema: v.ObjectSchema<{
895
976
  * server's listing unchanged.
896
977
  */
897
978
  readonly home: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
979
+ readonly publisher: v.OptionalSchema<v.ObjectSchema<{
980
+ readonly name: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 100, undefined>]>;
981
+ readonly handle: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "handle must be lowercase alphanumeric with hyphens">]>;
982
+ }, undefined>, undefined>;
983
+ readonly readOnly: v.OptionalSchema<v.LiteralSchema<true, undefined>, undefined>;
984
+ readonly id: v.StringSchema<undefined>;
985
+ readonly slug: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.CheckAction<string, "slug must be lowercase alphanumeric with hyphens, at most 64 characters">]>;
986
+ readonly name: v.StringSchema<undefined>;
987
+ readonly createdAt: v.StringSchema<undefined>;
988
+ readonly description: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
898
989
  }, undefined>;
899
990
  }, undefined>;
900
991
  export declare const SCOPED_TOKEN_MAX_GRANTS = 200;
@@ -1039,17 +1130,15 @@ export declare const UpdateBundleRequestSchema: v.SchemaWithPipe<readonly [v.Obj
1039
1130
  readonly name: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, number, undefined>, v.CheckAction<string, "Remove the invisible characters from this name — copying text from another app often brings them along.">, v.RegexAction<string, "Remove the invisible characters from this name — copying text from another app often brings them along.">]>, undefined>;
1040
1131
  readonly home: v.OptionalSchema<v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 200, undefined>]>, undefined>, undefined>;
1041
1132
  readonly columns: v.OptionalSchema<v.NullableSchema<v.SchemaWithPipe<readonly [v.ArraySchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 200, undefined>]>, undefined>, v.MaxLengthAction<string[], 100, undefined>, v.CheckAction<string[], "columns must not repeat a key">]>, undefined>, undefined>;
1133
+ readonly description: v.OptionalSchema<v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "description must not be blank">, v.MaxLengthAction<string, 1000, "description must be at most 1000 characters">, v.CheckAction<string, "description must be one line of text, with no control characters">]>, undefined>, undefined>;
1042
1134
  }, undefined>, v.CheckAction<{
1043
1135
  name?: string | undefined;
1044
1136
  home?: string | null | undefined;
1045
1137
  columns?: string[] | null | undefined;
1046
- }, "name, home or columns is required">]>;
1138
+ description?: string | null | undefined;
1139
+ }, "name, home, columns or description is required">]>;
1047
1140
  export declare const UpdateBundleResponseSchema: v.ObjectSchema<{
1048
1141
  readonly bundle: v.ObjectSchema<{
1049
- readonly id: v.StringSchema<undefined>;
1050
- readonly slug: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.CheckAction<string, "slug must be lowercase alphanumeric with hyphens, at most 64 characters">]>;
1051
- readonly name: v.StringSchema<undefined>;
1052
- readonly createdAt: v.StringSchema<undefined>;
1053
1142
  /**
1054
1143
  * The project id of the repo that owns this bundle's items, when one claims it
1055
1144
  * (`subscription-delivery-target-plan.md` → slice 3). Absent is the ordinary
@@ -1062,6 +1151,16 @@ export declare const UpdateBundleResponseSchema: v.ObjectSchema<{
1062
1151
  * server's listing unchanged.
1063
1152
  */
1064
1153
  readonly home: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
1154
+ readonly publisher: v.OptionalSchema<v.ObjectSchema<{
1155
+ readonly name: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 100, undefined>]>;
1156
+ readonly handle: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "handle must be lowercase alphanumeric with hyphens">]>;
1157
+ }, undefined>, undefined>;
1158
+ readonly readOnly: v.OptionalSchema<v.LiteralSchema<true, undefined>, undefined>;
1159
+ readonly id: v.StringSchema<undefined>;
1160
+ readonly slug: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.CheckAction<string, "slug must be lowercase alphanumeric with hyphens, at most 64 characters">]>;
1161
+ readonly name: v.StringSchema<undefined>;
1162
+ readonly createdAt: v.StringSchema<undefined>;
1163
+ readonly description: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
1065
1164
  }, undefined>;
1066
1165
  }, undefined>;
1067
1166
  export declare const DeleteBundleResponseSchema: v.ObjectSchema<{
@@ -1079,14 +1178,6 @@ export declare const ContextItemTypeSchema: v.PicklistSchema<string[], undefined
1079
1178
  export declare const ContextItemTypeFilterSchema: v.PicklistSchema<string[], undefined>;
1080
1179
  export declare const CaptureContentTypeSchema: v.PicklistSchema<("content" | "asset")[], undefined>;
1081
1180
  export { MAX_CONTEXT_CONTENT_BYTES };
1082
- /**
1083
- * An artifact's description as a writer sends it: one paragraph of plain text,
1084
- * with no line breaks or other control characters, so it saves on Enter like a
1085
- * title, prints safely in a terminal, and stays a plain YAML
1086
- * scalar in a Markdown artifact's frontmatter. Blank text is refused rather than
1087
- * stored: `null` is how a description is cleared, so "none" has one shape.
1088
- */
1089
- export declare const ArtifactDescriptionSchema: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "description must not be blank">, v.MaxLengthAction<string, 1000, "description must be at most 1000 characters">, v.CheckAction<string, "description must be one line of text, with no control characters">]>;
1090
1181
  /**
1091
1182
  * Max alias paths one guide reports. Three root instruction files and two
1092
1183
  * skills directories are the whole population today
@@ -1173,6 +1264,17 @@ export declare const CommentFindingSchema: v.ObjectSchema<{
1173
1264
  readonly prediction: v.NullableSchema<v.StringSchema<undefined>, undefined>;
1174
1265
  }, undefined>;
1175
1266
  export type CommentFinding = v.InferOutput<typeof CommentFindingSchema>;
1267
+ /** Whether an open Mossbear finding is the agent's to act on (`ArtifactComment.findingState`). */
1268
+ export declare const CommentFindingStateSchema: v.PicklistSchema<["ready", "waiting"], undefined>;
1269
+ export type CommentFindingState = v.InferOutput<typeof CommentFindingStateSchema>;
1270
+ /** Where a commented artifact is published from (`ArtifactComment.publishedFrom`). */
1271
+ export declare const CommentPublishedFromSchema: v.ObjectSchema<{
1272
+ readonly repository: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 200, undefined>, v.CheckAction<string, "repository must be trimmed and hold no control characters">]>, undefined>;
1273
+ readonly projectId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
1274
+ readonly branch: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 255, undefined>]>, undefined>;
1275
+ readonly thisRepo: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
1276
+ }, undefined>;
1277
+ export type CommentPublishedFrom = v.InferOutput<typeof CommentPublishedFromSchema>;
1176
1278
  /**
1177
1279
  * One comment a **person** left about a context item, riding the item it is about.
1178
1280
  *
@@ -1223,6 +1325,31 @@ export declare const ArtifactCommentSchema: v.ObjectSchema<{
1223
1325
  * strips this field never receives a draft it would print as a request.
1224
1326
  */
1225
1327
  readonly approved: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
1328
+ /**
1329
+ * Whether an open Mossbear finding is the agent's to act on. `ready` means the
1330
+ * person accepted it, or its evidence spans enough separate days to need no
1331
+ * Accept. `waiting` means it waits on the person: show it to the user and
1332
+ * change nothing unless they say so. Present only on an open Mossbear comment.
1333
+ * A server that predates the field omits it, and a reader then falls back to
1334
+ * `approved`. This is a new name rather than a new meaning for `state`,
1335
+ * which already says open or resolved.
1336
+ */
1337
+ readonly findingState: v.OptionalSchema<v.PicklistSchema<["ready", "waiting"], undefined>, undefined>;
1338
+ /**
1339
+ * Where the artifact is published from, when Mossbear records one: the
1340
+ * committed `project.id` of the repository whose commits own it, and the
1341
+ * branch it was published from (null when none was recorded). `thisRepo` is
1342
+ * true when that is the repo the read declared, false when it is another repo,
1343
+ * and absent when the read declared no repo. The field is absent when Mossbear
1344
+ * records no publishing repo, which is not a claim that the artifact is
1345
+ * Mossbear-owned.
1346
+ */
1347
+ readonly publishedFrom: v.OptionalSchema<v.ObjectSchema<{
1348
+ readonly repository: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 200, undefined>, v.CheckAction<string, "repository must be trimmed and hold no control characters">]>, undefined>;
1349
+ readonly projectId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
1350
+ readonly branch: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 255, undefined>]>, undefined>;
1351
+ readonly thisRepo: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
1352
+ }, undefined>, undefined>;
1226
1353
  /** The author's display name as the workspace shows it, or null. Never an email. */
1227
1354
  readonly authorName: v.NullableSchema<v.StringSchema<undefined>, undefined>;
1228
1355
  /**
@@ -1329,6 +1456,31 @@ export declare const ContextItemCommentSchema: v.ObjectSchema<{
1329
1456
  * strips this field never receives a draft it would print as a request.
1330
1457
  */
1331
1458
  readonly approved: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
1459
+ /**
1460
+ * Whether an open Mossbear finding is the agent's to act on. `ready` means the
1461
+ * person accepted it, or its evidence spans enough separate days to need no
1462
+ * Accept. `waiting` means it waits on the person: show it to the user and
1463
+ * change nothing unless they say so. Present only on an open Mossbear comment.
1464
+ * A server that predates the field omits it, and a reader then falls back to
1465
+ * `approved`. This is a new name rather than a new meaning for `state`,
1466
+ * which already says open or resolved.
1467
+ */
1468
+ readonly findingState: v.OptionalSchema<v.PicklistSchema<["ready", "waiting"], undefined>, undefined>;
1469
+ /**
1470
+ * Where the artifact is published from, when Mossbear records one: the
1471
+ * committed `project.id` of the repository whose commits own it, and the
1472
+ * branch it was published from (null when none was recorded). `thisRepo` is
1473
+ * true when that is the repo the read declared, false when it is another repo,
1474
+ * and absent when the read declared no repo. The field is absent when Mossbear
1475
+ * records no publishing repo, which is not a claim that the artifact is
1476
+ * Mossbear-owned.
1477
+ */
1478
+ readonly publishedFrom: v.OptionalSchema<v.ObjectSchema<{
1479
+ readonly repository: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 200, undefined>, v.CheckAction<string, "repository must be trimmed and hold no control characters">]>, undefined>;
1480
+ readonly projectId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
1481
+ readonly branch: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 255, undefined>]>, undefined>;
1482
+ readonly thisRepo: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
1483
+ }, undefined>, undefined>;
1332
1484
  /** The author's display name as the workspace shows it, or null. Never an email. */
1333
1485
  readonly authorName: v.NullableSchema<v.StringSchema<undefined>, undefined>;
1334
1486
  /**
@@ -1428,6 +1580,8 @@ export declare const CommitShaSchema: v.SchemaWithPipe<readonly [v.StringSchema<
1428
1580
  * projection path that publication and delivery could disagree about.
1429
1581
  */
1430
1582
  export declare const GitSourceSchema: v.ObjectSchema<{
1583
+ /** Unverified display label, never an ownership key or a remote URL. */
1584
+ readonly repository: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 200, undefined>, v.CheckAction<string, "repository must be trimmed and hold no control characters">]>, undefined>;
1431
1585
  /**
1432
1586
  * The committed `project.id` of the source repository — the same id space as
1433
1587
  * an item's delivery-scoping `projectId` below, but a different fact: that one
@@ -1598,6 +1752,31 @@ export declare const ContextItemSchema: v.SchemaWithPipe<readonly [v.ObjectSchem
1598
1752
  * strips this field never receives a draft it would print as a request.
1599
1753
  */
1600
1754
  readonly approved: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
1755
+ /**
1756
+ * Whether an open Mossbear finding is the agent's to act on. `ready` means the
1757
+ * person accepted it, or its evidence spans enough separate days to need no
1758
+ * Accept. `waiting` means it waits on the person: show it to the user and
1759
+ * change nothing unless they say so. Present only on an open Mossbear comment.
1760
+ * A server that predates the field omits it, and a reader then falls back to
1761
+ * `approved`. This is a new name rather than a new meaning for `state`,
1762
+ * which already says open or resolved.
1763
+ */
1764
+ readonly findingState: v.OptionalSchema<v.PicklistSchema<["ready", "waiting"], undefined>, undefined>;
1765
+ /**
1766
+ * Where the artifact is published from, when Mossbear records one: the
1767
+ * committed `project.id` of the repository whose commits own it, and the
1768
+ * branch it was published from (null when none was recorded). `thisRepo` is
1769
+ * true when that is the repo the read declared, false when it is another repo,
1770
+ * and absent when the read declared no repo. The field is absent when Mossbear
1771
+ * records no publishing repo, which is not a claim that the artifact is
1772
+ * Mossbear-owned.
1773
+ */
1774
+ readonly publishedFrom: v.OptionalSchema<v.ObjectSchema<{
1775
+ readonly repository: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 200, undefined>, v.CheckAction<string, "repository must be trimmed and hold no control characters">]>, undefined>;
1776
+ readonly projectId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
1777
+ readonly branch: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 255, undefined>]>, undefined>;
1778
+ readonly thisRepo: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
1779
+ }, undefined>, undefined>;
1601
1780
  /** The author's display name as the workspace shows it, or null. Never an email. */
1602
1781
  readonly authorName: v.NullableSchema<v.StringSchema<undefined>, undefined>;
1603
1782
  /**
@@ -1683,6 +1862,13 @@ export declare const ContextItemSchema: v.SchemaWithPipe<readonly [v.ObjectSchem
1683
1862
  prediction: string | null;
1684
1863
  } | undefined;
1685
1864
  approved?: boolean | undefined;
1865
+ findingState?: "ready" | "waiting" | undefined;
1866
+ publishedFrom?: {
1867
+ repository?: string | undefined;
1868
+ projectId: string;
1869
+ branch: string | null;
1870
+ thisRepo?: boolean | undefined;
1871
+ } | undefined;
1686
1872
  authorName: string | null;
1687
1873
  authorKind?: "person" | "agent" | "mossbear" | undefined;
1688
1874
  createdAt: string;
@@ -1721,6 +1907,8 @@ export declare const ContextItemSchema: v.SchemaWithPipe<readonly [v.ObjectSchem
1721
1907
  * without a usable path is a broken item, not a broken response.
1722
1908
  */
1723
1909
  readonly gitSource: v.OptionalSchema<v.NullableSchema<v.ObjectSchema<{
1910
+ /** Unverified display label, never an ownership key or a remote URL. */
1911
+ readonly repository: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 200, undefined>, v.CheckAction<string, "repository must be trimmed and hold no control characters">]>, undefined>;
1724
1912
  /**
1725
1913
  * The committed `project.id` of the source repository — the same id space as
1726
1914
  * an item's delivery-scoping `projectId` below, but a different fact: that one
@@ -1828,6 +2016,13 @@ export declare const ContextItemSchema: v.SchemaWithPipe<readonly [v.ObjectSchem
1828
2016
  prediction: string | null;
1829
2017
  } | undefined;
1830
2018
  approved?: boolean | undefined;
2019
+ findingState?: "ready" | "waiting" | undefined;
2020
+ publishedFrom?: {
2021
+ repository?: string | undefined;
2022
+ projectId: string;
2023
+ branch: string | null;
2024
+ thisRepo?: boolean | undefined;
2025
+ } | undefined;
1831
2026
  authorName: string | null;
1832
2027
  authorKind?: "person" | "agent" | "mossbear" | undefined;
1833
2028
  createdAt: string;
@@ -1841,6 +2036,7 @@ export declare const ContextItemSchema: v.SchemaWithPipe<readonly [v.ObjectSchem
1841
2036
  }[] | undefined;
1842
2037
  updatedAt: string;
1843
2038
  gitSource?: {
2039
+ repository?: string | undefined;
1844
2040
  projectId: string;
1845
2041
  commitSha: string;
1846
2042
  branch?: string | undefined;
@@ -1897,6 +2093,13 @@ export declare const ContextItemSchema: v.SchemaWithPipe<readonly [v.ObjectSchem
1897
2093
  prediction: string | null;
1898
2094
  } | undefined;
1899
2095
  approved?: boolean | undefined;
2096
+ findingState?: "ready" | "waiting" | undefined;
2097
+ publishedFrom?: {
2098
+ repository?: string | undefined;
2099
+ projectId: string;
2100
+ branch: string | null;
2101
+ thisRepo?: boolean | undefined;
2102
+ } | undefined;
1900
2103
  authorName: string | null;
1901
2104
  authorKind?: "person" | "agent" | "mossbear" | undefined;
1902
2105
  createdAt: string;
@@ -1910,6 +2113,7 @@ export declare const ContextItemSchema: v.SchemaWithPipe<readonly [v.ObjectSchem
1910
2113
  }[] | undefined;
1911
2114
  updatedAt: string;
1912
2115
  gitSource?: {
2116
+ repository?: string | undefined;
1913
2117
  projectId: string;
1914
2118
  commitSha: string;
1915
2119
  branch?: string | undefined;
@@ -2068,6 +2272,31 @@ export declare const ContextItemsResponseSchema: v.ObjectSchema<{
2068
2272
  * strips this field never receives a draft it would print as a request.
2069
2273
  */
2070
2274
  readonly approved: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
2275
+ /**
2276
+ * Whether an open Mossbear finding is the agent's to act on. `ready` means the
2277
+ * person accepted it, or its evidence spans enough separate days to need no
2278
+ * Accept. `waiting` means it waits on the person: show it to the user and
2279
+ * change nothing unless they say so. Present only on an open Mossbear comment.
2280
+ * A server that predates the field omits it, and a reader then falls back to
2281
+ * `approved`. This is a new name rather than a new meaning for `state`,
2282
+ * which already says open or resolved.
2283
+ */
2284
+ readonly findingState: v.OptionalSchema<v.PicklistSchema<["ready", "waiting"], undefined>, undefined>;
2285
+ /**
2286
+ * Where the artifact is published from, when Mossbear records one: the
2287
+ * committed `project.id` of the repository whose commits own it, and the
2288
+ * branch it was published from (null when none was recorded). `thisRepo` is
2289
+ * true when that is the repo the read declared, false when it is another repo,
2290
+ * and absent when the read declared no repo. The field is absent when Mossbear
2291
+ * records no publishing repo, which is not a claim that the artifact is
2292
+ * Mossbear-owned.
2293
+ */
2294
+ readonly publishedFrom: v.OptionalSchema<v.ObjectSchema<{
2295
+ readonly repository: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 200, undefined>, v.CheckAction<string, "repository must be trimmed and hold no control characters">]>, undefined>;
2296
+ readonly projectId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
2297
+ readonly branch: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 255, undefined>]>, undefined>;
2298
+ readonly thisRepo: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
2299
+ }, undefined>, undefined>;
2071
2300
  /** The author's display name as the workspace shows it, or null. Never an email. */
2072
2301
  readonly authorName: v.NullableSchema<v.StringSchema<undefined>, undefined>;
2073
2302
  /**
@@ -2153,6 +2382,13 @@ export declare const ContextItemsResponseSchema: v.ObjectSchema<{
2153
2382
  prediction: string | null;
2154
2383
  } | undefined;
2155
2384
  approved?: boolean | undefined;
2385
+ findingState?: "ready" | "waiting" | undefined;
2386
+ publishedFrom?: {
2387
+ repository?: string | undefined;
2388
+ projectId: string;
2389
+ branch: string | null;
2390
+ thisRepo?: boolean | undefined;
2391
+ } | undefined;
2156
2392
  authorName: string | null;
2157
2393
  authorKind?: "person" | "agent" | "mossbear" | undefined;
2158
2394
  createdAt: string;
@@ -2191,6 +2427,8 @@ export declare const ContextItemsResponseSchema: v.ObjectSchema<{
2191
2427
  * without a usable path is a broken item, not a broken response.
2192
2428
  */
2193
2429
  readonly gitSource: v.OptionalSchema<v.NullableSchema<v.ObjectSchema<{
2430
+ /** Unverified display label, never an ownership key or a remote URL. */
2431
+ readonly repository: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 200, undefined>, v.CheckAction<string, "repository must be trimmed and hold no control characters">]>, undefined>;
2194
2432
  /**
2195
2433
  * The committed `project.id` of the source repository — the same id space as
2196
2434
  * an item's delivery-scoping `projectId` below, but a different fact: that one
@@ -2298,6 +2536,13 @@ export declare const ContextItemsResponseSchema: v.ObjectSchema<{
2298
2536
  prediction: string | null;
2299
2537
  } | undefined;
2300
2538
  approved?: boolean | undefined;
2539
+ findingState?: "ready" | "waiting" | undefined;
2540
+ publishedFrom?: {
2541
+ repository?: string | undefined;
2542
+ projectId: string;
2543
+ branch: string | null;
2544
+ thisRepo?: boolean | undefined;
2545
+ } | undefined;
2301
2546
  authorName: string | null;
2302
2547
  authorKind?: "person" | "agent" | "mossbear" | undefined;
2303
2548
  createdAt: string;
@@ -2311,6 +2556,7 @@ export declare const ContextItemsResponseSchema: v.ObjectSchema<{
2311
2556
  }[] | undefined;
2312
2557
  updatedAt: string;
2313
2558
  gitSource?: {
2559
+ repository?: string | undefined;
2314
2560
  projectId: string;
2315
2561
  commitSha: string;
2316
2562
  branch?: string | undefined;
@@ -2367,6 +2613,13 @@ export declare const ContextItemsResponseSchema: v.ObjectSchema<{
2367
2613
  prediction: string | null;
2368
2614
  } | undefined;
2369
2615
  approved?: boolean | undefined;
2616
+ findingState?: "ready" | "waiting" | undefined;
2617
+ publishedFrom?: {
2618
+ repository?: string | undefined;
2619
+ projectId: string;
2620
+ branch: string | null;
2621
+ thisRepo?: boolean | undefined;
2622
+ } | undefined;
2370
2623
  authorName: string | null;
2371
2624
  authorKind?: "person" | "agent" | "mossbear" | undefined;
2372
2625
  createdAt: string;
@@ -2380,6 +2633,7 @@ export declare const ContextItemsResponseSchema: v.ObjectSchema<{
2380
2633
  }[] | undefined;
2381
2634
  updatedAt: string;
2382
2635
  gitSource?: {
2636
+ repository?: string | undefined;
2383
2637
  projectId: string;
2384
2638
  commitSha: string;
2385
2639
  branch?: string | undefined;
@@ -2556,6 +2810,31 @@ export declare const BundleArtifactsResponseSchema: v.ObjectSchema<{
2556
2810
  * strips this field never receives a draft it would print as a request.
2557
2811
  */
2558
2812
  readonly approved: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
2813
+ /**
2814
+ * Whether an open Mossbear finding is the agent's to act on. `ready` means the
2815
+ * person accepted it, or its evidence spans enough separate days to need no
2816
+ * Accept. `waiting` means it waits on the person: show it to the user and
2817
+ * change nothing unless they say so. Present only on an open Mossbear comment.
2818
+ * A server that predates the field omits it, and a reader then falls back to
2819
+ * `approved`. This is a new name rather than a new meaning for `state`,
2820
+ * which already says open or resolved.
2821
+ */
2822
+ readonly findingState: v.OptionalSchema<v.PicklistSchema<["ready", "waiting"], undefined>, undefined>;
2823
+ /**
2824
+ * Where the artifact is published from, when Mossbear records one: the
2825
+ * committed `project.id` of the repository whose commits own it, and the
2826
+ * branch it was published from (null when none was recorded). `thisRepo` is
2827
+ * true when that is the repo the read declared, false when it is another repo,
2828
+ * and absent when the read declared no repo. The field is absent when Mossbear
2829
+ * records no publishing repo, which is not a claim that the artifact is
2830
+ * Mossbear-owned.
2831
+ */
2832
+ readonly publishedFrom: v.OptionalSchema<v.ObjectSchema<{
2833
+ readonly repository: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 200, undefined>, v.CheckAction<string, "repository must be trimmed and hold no control characters">]>, undefined>;
2834
+ readonly projectId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
2835
+ readonly branch: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 255, undefined>]>, undefined>;
2836
+ readonly thisRepo: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
2837
+ }, undefined>, undefined>;
2559
2838
  /** The author's display name as the workspace shows it, or null. Never an email. */
2560
2839
  readonly authorName: v.NullableSchema<v.StringSchema<undefined>, undefined>;
2561
2840
  /**
@@ -2641,6 +2920,13 @@ export declare const BundleArtifactsResponseSchema: v.ObjectSchema<{
2641
2920
  prediction: string | null;
2642
2921
  } | undefined;
2643
2922
  approved?: boolean | undefined;
2923
+ findingState?: "ready" | "waiting" | undefined;
2924
+ publishedFrom?: {
2925
+ repository?: string | undefined;
2926
+ projectId: string;
2927
+ branch: string | null;
2928
+ thisRepo?: boolean | undefined;
2929
+ } | undefined;
2644
2930
  authorName: string | null;
2645
2931
  authorKind?: "person" | "agent" | "mossbear" | undefined;
2646
2932
  createdAt: string;
@@ -2679,6 +2965,8 @@ export declare const BundleArtifactsResponseSchema: v.ObjectSchema<{
2679
2965
  * without a usable path is a broken item, not a broken response.
2680
2966
  */
2681
2967
  readonly gitSource: v.OptionalSchema<v.NullableSchema<v.ObjectSchema<{
2968
+ /** Unverified display label, never an ownership key or a remote URL. */
2969
+ readonly repository: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 200, undefined>, v.CheckAction<string, "repository must be trimmed and hold no control characters">]>, undefined>;
2682
2970
  /**
2683
2971
  * The committed `project.id` of the source repository — the same id space as
2684
2972
  * an item's delivery-scoping `projectId` below, but a different fact: that one
@@ -2786,6 +3074,13 @@ export declare const BundleArtifactsResponseSchema: v.ObjectSchema<{
2786
3074
  prediction: string | null;
2787
3075
  } | undefined;
2788
3076
  approved?: boolean | undefined;
3077
+ findingState?: "ready" | "waiting" | undefined;
3078
+ publishedFrom?: {
3079
+ repository?: string | undefined;
3080
+ projectId: string;
3081
+ branch: string | null;
3082
+ thisRepo?: boolean | undefined;
3083
+ } | undefined;
2789
3084
  authorName: string | null;
2790
3085
  authorKind?: "person" | "agent" | "mossbear" | undefined;
2791
3086
  createdAt: string;
@@ -2799,6 +3094,7 @@ export declare const BundleArtifactsResponseSchema: v.ObjectSchema<{
2799
3094
  }[] | undefined;
2800
3095
  updatedAt: string;
2801
3096
  gitSource?: {
3097
+ repository?: string | undefined;
2802
3098
  projectId: string;
2803
3099
  commitSha: string;
2804
3100
  branch?: string | undefined;
@@ -2855,6 +3151,13 @@ export declare const BundleArtifactsResponseSchema: v.ObjectSchema<{
2855
3151
  prediction: string | null;
2856
3152
  } | undefined;
2857
3153
  approved?: boolean | undefined;
3154
+ findingState?: "ready" | "waiting" | undefined;
3155
+ publishedFrom?: {
3156
+ repository?: string | undefined;
3157
+ projectId: string;
3158
+ branch: string | null;
3159
+ thisRepo?: boolean | undefined;
3160
+ } | undefined;
2858
3161
  authorName: string | null;
2859
3162
  authorKind?: "person" | "agent" | "mossbear" | undefined;
2860
3163
  createdAt: string;
@@ -2868,6 +3171,7 @@ export declare const BundleArtifactsResponseSchema: v.ObjectSchema<{
2868
3171
  }[] | undefined;
2869
3172
  updatedAt: string;
2870
3173
  gitSource?: {
3174
+ repository?: string | undefined;
2871
3175
  projectId: string;
2872
3176
  commitSha: string;
2873
3177
  branch?: string | undefined;
@@ -3150,6 +3454,31 @@ export declare const ItemCommentWithSubjectSchema: v.ObjectSchema<{
3150
3454
  * strips this field never receives a draft it would print as a request.
3151
3455
  */
3152
3456
  readonly approved: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
3457
+ /**
3458
+ * Whether an open Mossbear finding is the agent's to act on. `ready` means the
3459
+ * person accepted it, or its evidence spans enough separate days to need no
3460
+ * Accept. `waiting` means it waits on the person: show it to the user and
3461
+ * change nothing unless they say so. Present only on an open Mossbear comment.
3462
+ * A server that predates the field omits it, and a reader then falls back to
3463
+ * `approved`. This is a new name rather than a new meaning for `state`,
3464
+ * which already says open or resolved.
3465
+ */
3466
+ readonly findingState: v.OptionalSchema<v.PicklistSchema<["ready", "waiting"], undefined>, undefined>;
3467
+ /**
3468
+ * Where the artifact is published from, when Mossbear records one: the
3469
+ * committed `project.id` of the repository whose commits own it, and the
3470
+ * branch it was published from (null when none was recorded). `thisRepo` is
3471
+ * true when that is the repo the read declared, false when it is another repo,
3472
+ * and absent when the read declared no repo. The field is absent when Mossbear
3473
+ * records no publishing repo, which is not a claim that the artifact is
3474
+ * Mossbear-owned.
3475
+ */
3476
+ readonly publishedFrom: v.OptionalSchema<v.ObjectSchema<{
3477
+ readonly repository: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 200, undefined>, v.CheckAction<string, "repository must be trimmed and hold no control characters">]>, undefined>;
3478
+ readonly projectId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
3479
+ readonly branch: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 255, undefined>]>, undefined>;
3480
+ readonly thisRepo: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
3481
+ }, undefined>, undefined>;
3153
3482
  /** The author's display name as the workspace shows it, or null. Never an email. */
3154
3483
  readonly authorName: v.NullableSchema<v.StringSchema<undefined>, undefined>;
3155
3484
  /**
@@ -3272,6 +3601,31 @@ export declare const ItemCommentsResponseSchema: v.ObjectSchema<{
3272
3601
  * strips this field never receives a draft it would print as a request.
3273
3602
  */
3274
3603
  readonly approved: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
3604
+ /**
3605
+ * Whether an open Mossbear finding is the agent's to act on. `ready` means the
3606
+ * person accepted it, or its evidence spans enough separate days to need no
3607
+ * Accept. `waiting` means it waits on the person: show it to the user and
3608
+ * change nothing unless they say so. Present only on an open Mossbear comment.
3609
+ * A server that predates the field omits it, and a reader then falls back to
3610
+ * `approved`. This is a new name rather than a new meaning for `state`,
3611
+ * which already says open or resolved.
3612
+ */
3613
+ readonly findingState: v.OptionalSchema<v.PicklistSchema<["ready", "waiting"], undefined>, undefined>;
3614
+ /**
3615
+ * Where the artifact is published from, when Mossbear records one: the
3616
+ * committed `project.id` of the repository whose commits own it, and the
3617
+ * branch it was published from (null when none was recorded). `thisRepo` is
3618
+ * true when that is the repo the read declared, false when it is another repo,
3619
+ * and absent when the read declared no repo. The field is absent when Mossbear
3620
+ * records no publishing repo, which is not a claim that the artifact is
3621
+ * Mossbear-owned.
3622
+ */
3623
+ readonly publishedFrom: v.OptionalSchema<v.ObjectSchema<{
3624
+ readonly repository: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 200, undefined>, v.CheckAction<string, "repository must be trimmed and hold no control characters">]>, undefined>;
3625
+ readonly projectId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
3626
+ readonly branch: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 255, undefined>]>, undefined>;
3627
+ readonly thisRepo: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
3628
+ }, undefined>, undefined>;
3275
3629
  /** The author's display name as the workspace shows it, or null. Never an email. */
3276
3630
  readonly authorName: v.NullableSchema<v.StringSchema<undefined>, undefined>;
3277
3631
  /**
@@ -3935,6 +4289,8 @@ export declare const ArtifactSchema: v.ObjectSchema<{
3935
4289
  }[], 8, undefined>]>, undefined>;
3936
4290
  /** Present iff git owns this artifact. */
3937
4291
  readonly gitSource: v.OptionalSchema<v.NullableSchema<v.ObjectSchema<{
4292
+ /** Unverified display label, never an ownership key or a remote URL. */
4293
+ readonly repository: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 200, undefined>, v.CheckAction<string, "repository must be trimmed and hold no control characters">]>, undefined>;
3938
4294
  /**
3939
4295
  * The committed `project.id` of the source repository — the same id space as
3940
4296
  * an item's delivery-scoping `projectId` below, but a different fact: that one
@@ -3989,6 +4345,31 @@ export declare const ArtifactSchema: v.ObjectSchema<{
3989
4345
  * strips this field never receives a draft it would print as a request.
3990
4346
  */
3991
4347
  readonly approved: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
4348
+ /**
4349
+ * Whether an open Mossbear finding is the agent's to act on. `ready` means the
4350
+ * person accepted it, or its evidence spans enough separate days to need no
4351
+ * Accept. `waiting` means it waits on the person: show it to the user and
4352
+ * change nothing unless they say so. Present only on an open Mossbear comment.
4353
+ * A server that predates the field omits it, and a reader then falls back to
4354
+ * `approved`. This is a new name rather than a new meaning for `state`,
4355
+ * which already says open or resolved.
4356
+ */
4357
+ readonly findingState: v.OptionalSchema<v.PicklistSchema<["ready", "waiting"], undefined>, undefined>;
4358
+ /**
4359
+ * Where the artifact is published from, when Mossbear records one: the
4360
+ * committed `project.id` of the repository whose commits own it, and the
4361
+ * branch it was published from (null when none was recorded). `thisRepo` is
4362
+ * true when that is the repo the read declared, false when it is another repo,
4363
+ * and absent when the read declared no repo. The field is absent when Mossbear
4364
+ * records no publishing repo, which is not a claim that the artifact is
4365
+ * Mossbear-owned.
4366
+ */
4367
+ readonly publishedFrom: v.OptionalSchema<v.ObjectSchema<{
4368
+ readonly repository: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 200, undefined>, v.CheckAction<string, "repository must be trimmed and hold no control characters">]>, undefined>;
4369
+ readonly projectId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
4370
+ readonly branch: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 255, undefined>]>, undefined>;
4371
+ readonly thisRepo: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
4372
+ }, undefined>, undefined>;
3992
4373
  /** The author's display name as the workspace shows it, or null. Never an email. */
3993
4374
  readonly authorName: v.NullableSchema<v.StringSchema<undefined>, undefined>;
3994
4375
  /**
@@ -4074,6 +4455,13 @@ export declare const ArtifactSchema: v.ObjectSchema<{
4074
4455
  prediction: string | null;
4075
4456
  } | undefined;
4076
4457
  approved?: boolean | undefined;
4458
+ findingState?: "ready" | "waiting" | undefined;
4459
+ publishedFrom?: {
4460
+ repository?: string | undefined;
4461
+ projectId: string;
4462
+ branch: string | null;
4463
+ thisRepo?: boolean | undefined;
4464
+ } | undefined;
4077
4465
  authorName: string | null;
4078
4466
  authorKind?: "person" | "agent" | "mossbear" | undefined;
4079
4467
  createdAt: string;
@@ -4088,101 +4476,342 @@ export declare const ArtifactSchema: v.ObjectSchema<{
4088
4476
  readonly createdAt: v.StringSchema<undefined>;
4089
4477
  readonly updatedAt: v.StringSchema<undefined>;
4090
4478
  }, undefined>;
4091
- /**
4092
- * A guide publication: the bytes at an agent-guidance path, published from the
4093
- * repository that homes the bundle, land as a guide rather than a document.
4094
- *
4095
- * `format` is the discovery format of the path, the one import records.
4096
- * `members` is a skill's member files, relative to its directory, and is
4097
- * authoritative when present: a stored member it omits is removed, unless it
4098
- * is listed in `skippedPaths` (present at the ref, but not sendable). Only a
4099
- * `skill-md` publication carries members.
4100
- */
4101
- export declare const GuidePublishSchema: v.SchemaWithPipe<readonly [v.StrictObjectSchema<{
4102
- readonly format: v.PicklistSchema<["agents-md", "agents-dir", "claude-md", "claude-rules", "cursorrules", "cursor-rules", "skill-md"], undefined>;
4103
- readonly members: v.OptionalSchema<v.SchemaWithPipe<readonly [v.ArraySchema<v.StrictObjectSchema<{
4104
- readonly path: v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 512, undefined>, v.CheckAction<string, "path must use forward slashes">, v.CheckAction<string, "path must be relative">, v.CheckAction<string, "path must not contain control characters">, v.CheckAction<string, "path must not contain empty, \".\" or \"..\" segments">]>, v.CheckAction<string, "path must not shadow the skill’s own SKILL.md">]>;
4105
- readonly content: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.CheckAction<string, "rawContent must be at most 524288 bytes">]>;
4106
- /** As on {@link RawSkillMemberFileSchema}: absent is not `false`. */
4107
- readonly executable: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
4108
- }, undefined>, undefined>, v.MaxLengthAction<{
4109
- path: string;
4110
- content: string;
4111
- executable?: boolean | undefined;
4112
- }[], 64, undefined>, v.CheckAction<{
4113
- path: string;
4114
- content: string;
4115
- executable?: boolean | undefined;
4116
- }[], "member paths must be unique (case-insensitive)">]>, undefined>;
4117
- readonly skippedPaths: v.OptionalSchema<v.SchemaWithPipe<readonly [v.ArraySchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 512, undefined>]>, undefined>, v.MaxLengthAction<string[], 256, undefined>]>, undefined>;
4479
+ /** A list row with no body or comment payload; never a full Artifact. */
4480
+ export declare const ArtifactMetadataSchema: v.StrictObjectSchema<Omit<{
4481
+ readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
4482
+ readonly name: v.StringSchema<undefined>;
4483
+ readonly role: v.PicklistSchema<["guidance", "criteria", "content"], undefined>;
4484
+ readonly format: v.PicklistSchema<["markdown", "html", "binary", "code"], undefined>;
4485
+ /** What the artifact is, as a reader names it: {@link artifactKindOf}. */
4486
+ readonly kind: v.PicklistSchema<readonly ["markdown", "html", "code", "photo", "file", "guide"], undefined>;
4487
+ /** Set when the artifact is a photo: its stored parts, never their bytes. */
4488
+ readonly asset: v.OptionalSchema<v.NullableSchema<v.ObjectSchema<{
4489
+ readonly parts: v.ArraySchema<v.ObjectSchema<{
4490
+ readonly role: v.PicklistSchema<readonly ["original", "display", "thumb"], undefined>;
4491
+ readonly mediaType: v.PicklistSchema<readonly ["image/jpeg", "image/png", "image/webp", "image/gif", "image/heic", "image/heif"], undefined>;
4492
+ readonly bytes: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.SafeIntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>;
4493
+ readonly width: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.SafeIntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>;
4494
+ readonly height: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.SafeIntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>;
4495
+ }, undefined>, undefined>;
4496
+ }, undefined>, undefined>, undefined>;
4497
+ /** Monotonic content version; echo it back as `expectedVersion` to update. */
4498
+ readonly version: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>;
4499
+ readonly state: v.PicklistSchema<["live", "deleted", "removed"], undefined>;
4500
+ readonly workspaceId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
4501
+ /** True for a deliberate capture (Inbox). Not derivable from filing state. */
4502
+ readonly capture: v.BooleanSchema<undefined>;
4118
4503
  /**
4119
- * The repository's other copies of this file, such as a skill's twin in
4120
- * the other skills folder, each published as an alias of this guide rather
4121
- * than a guide of its own. Each must be an alias path of the published one
4122
- * (`aliasPathSiblings`). Additive: an alias it omits is kept.
4504
+ * When a capture was marked done, which takes it out of the inbox and nothing
4505
+ * else: a done artifact is still `state: 'live'`. Null while it waits.
4123
4506
  */
4124
- readonly aliases: v.OptionalSchema<v.SchemaWithPipe<readonly [v.ArraySchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 512, undefined>, v.CheckAction<string, "path must use forward slashes">, v.CheckAction<string, "path must be relative">, v.CheckAction<string, "path must not contain control characters">, v.CheckAction<string, "path must not contain empty, \".\" or \"..\" segments">]>, undefined>, v.MaxLengthAction<string[], 8, undefined>]>, undefined>;
4125
- }, undefined>, v.CheckAction<{
4126
- format: "agents-md" | "agents-dir" | "claude-md" | "claude-rules" | "cursorrules" | "cursor-rules" | "skill-md";
4127
- members?: {
4128
- path: string;
4129
- content: string;
4130
- executable?: boolean | undefined;
4131
- }[] | undefined;
4132
- skippedPaths?: string[] | undefined;
4133
- aliases?: string[] | undefined;
4134
- }, "only a skill-md guide carries members">]>;
4135
- export type GuidePublish = v.InferOutput<typeof GuidePublishSchema>;
4136
- /**
4137
- * Create an artifact. Always a create: it takes no id, and an update is a
4138
- * separate request. `bundle` is optional for an unrestricted caller, who files
4139
- * later; a scoped credential must name a bundle it may write, and the server
4140
- * refuses a scoped create without one.
4141
- */
4142
- /**
4143
- * The identity a guide's files carry with them: a skill's
4144
- * `metadata.mossbear-id`. An opaque lookup key, resolved only inside the
4145
- * publishing workspace, so it grants nothing even though it sits in public
4146
- * repos. Both an artifact id and a `nanoid()` fit it.
4147
- */
4148
- export declare const IdentityKeySchema: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 128, undefined>, v.RegexAction<string, "an identity key is letters, digits, `-` and `_`">]>;
4149
- /** How many keys one identity lookup may ask about: a declared set, not more. */
4150
- export declare const MAX_IDENTITY_LOOKUP_ENTRIES = 500;
4151
- /**
4152
- * Ask what publishing each key at a path would do in the workspace of `bundle`
4153
- * (a bundle id the publishing repo homes), before anything is sent. Read-only.
4154
- */
4155
- export declare const ResolveIdentitiesRequestSchema: v.StrictObjectSchema<{
4156
- readonly bundle: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
4157
- readonly projectId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>]>;
4158
- readonly entries: v.SchemaWithPipe<readonly [v.ArraySchema<v.StrictObjectSchema<{
4159
- readonly key: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 128, undefined>, v.RegexAction<string, "an identity key is letters, digits, `-` and `_`">]>;
4507
+ readonly doneAt: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
4508
+ /** Null for binary content, which is not served inline. */
4509
+ readonly content: v.NullableSchema<v.StringSchema<undefined>, undefined>;
4510
+ /**
4511
+ * What a person or their agent says about the artifact, as plain text, on
4512
+ * every kind: a Markdown artifact's frontmatter `description` (repeated from
4513
+ * `content`), and a stored field for anything without frontmatter, such as a
4514
+ * photo. Null when there is none. Data, never instructions. Optional because
4515
+ * a server that predates it sends nothing.
4516
+ */
4517
+ readonly description: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
4518
+ readonly origin: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
4519
+ readonly root: v.OptionalSchema<v.NullableSchema<v.PicklistSchema<["project", "global"], undefined>, undefined>, undefined>;
4520
+ readonly path: v.OptionalSchema<v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 512, undefined>, v.CheckAction<string, "path must use forward slashes">, v.CheckAction<string, "path must be relative">, v.CheckAction<string, "path must not contain control characters">, v.CheckAction<string, "path must not contain empty, \".\" or \"..\" segments">]>, undefined>, undefined>;
4521
+ readonly projectId: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
4522
+ readonly pathProjectId: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
4523
+ readonly aliases: v.OptionalSchema<v.SchemaWithPipe<readonly [v.ArraySchema<v.ObjectSchema<{
4524
+ readonly root: v.PicklistSchema<["project", "global"], undefined>;
4160
4525
  readonly path: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 512, undefined>, v.CheckAction<string, "path must use forward slashes">, v.CheckAction<string, "path must be relative">, v.CheckAction<string, "path must not contain control characters">, v.CheckAction<string, "path must not contain empty, \".\" or \"..\" segments">]>;
4161
- }, undefined>, undefined>, v.MinLengthAction<{
4162
- key: string;
4163
- path: string;
4164
- }[], 1, undefined>, v.MaxLengthAction<{
4165
- key: string;
4526
+ }, undefined>, undefined>, v.MaxLengthAction<{
4527
+ root: "project" | "global";
4166
4528
  path: string;
4167
- }[], 500, undefined>]>;
4168
- }, undefined>;
4169
- /**
4170
- * What a publication carrying a key would do, decided by the server's one
4171
- * transfer rule:
4172
- *
4173
- * - `mint`: no artifact in this workspace holds the key, so a new one takes it.
4174
- * - `current`: this repo's own artifact at this path holds it; an ordinary update.
4175
- * - `move`: this repo's own artifact holds it at another path (a folder rename).
4176
- * - `transfer`: another repo's artifact holds it and its home retired it, so
4177
- * it moves here with its versions, comments and grading.
4178
- * - `refused`: the holder cannot move here now; `refusal` says why and what to do.
4179
- */
4180
- export declare const IdentityClaimKindSchema: v.PicklistSchema<["mint", "current", "move", "transfer", "refused"], undefined>;
4181
- /** What an artifact carries with it, for a preview to name before a yes. */
4182
- export declare const IdentityHistorySchema: v.ObjectSchema<{
4183
- readonly artifactId: v.StringSchema<undefined>;
4184
- /** Comment threads not yet resolved. */
4185
- readonly openComments: v.NumberSchema<undefined>;
4529
+ }[], 8, undefined>]>, undefined>;
4530
+ /** Present iff git owns this artifact. */
4531
+ readonly gitSource: v.OptionalSchema<v.NullableSchema<v.ObjectSchema<{
4532
+ /** Unverified display label, never an ownership key or a remote URL. */
4533
+ readonly repository: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 200, undefined>, v.CheckAction<string, "repository must be trimmed and hold no control characters">]>, undefined>;
4534
+ /**
4535
+ * The committed `project.id` of the source repository — the same id space as
4536
+ * an item's delivery-scoping `projectId` below, but a different fact: that one
4537
+ * says which repo an item is materialized into and is stamped onto
4538
+ * Mossbear-owned rows too, this one says who may edit it.
4539
+ */
4540
+ readonly projectId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 128, undefined>, v.RegexAction<string, "projectId must contain only letters, digits, underscore, dot or hyphen">]>;
4541
+ readonly commitSha: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "commitSha must be 40 or 64 lowercase hex characters">]>;
4542
+ /**
4543
+ * The branch the publishing commit was on. **The one optional member**: a
4544
+ * detached HEAD has none to record. Publishers read it back to tell a copy
4545
+ * from another branch, whose commit a squash merge may have discarded, from
4546
+ * one of the published branch itself.
4547
+ */
4548
+ readonly branch: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 255, undefined>]>, undefined>;
4549
+ }, undefined>, undefined>, undefined>;
4550
+ /** Absent, not empty, when there are none. Absence is not a verdict. */
4551
+ readonly comments: v.OptionalSchema<v.SchemaWithPipe<readonly [v.ArraySchema<v.ObjectSchema<{
4552
+ readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
4553
+ readonly state: v.OptionalSchema<v.PicklistSchema<["open", "resolved"], undefined>, undefined>;
4554
+ /** Current source location of an anchored passage, or its lost quote. */
4555
+ readonly passage: v.OptionalSchema<v.ObjectSchema<{
4556
+ readonly quote: v.StringSchema<undefined>;
4557
+ readonly status: v.PicklistSchema<["located", "changed", "orphaned"], undefined>;
4558
+ readonly lines: v.NullableSchema<v.ObjectSchema<{
4559
+ readonly start: v.NumberSchema<undefined>;
4560
+ readonly end: v.NumberSchema<undefined>;
4561
+ }, undefined>, undefined>;
4562
+ }, undefined>, undefined>;
4563
+ /** The comment's text, already wrapped in the response's untrusted markers. */
4564
+ readonly body: v.StringSchema<undefined>;
4565
+ /**
4566
+ * What a comment Mossbear wrote is: a finding about the item, never an edit.
4567
+ * Present only on a Mossbear comment. The comment's `body` begins with the
4568
+ * claim (what goes wrong); this carries what the claim rests on.
4569
+ */
4570
+ readonly finding: v.OptionalSchema<v.ObjectSchema<{
4571
+ readonly tier: v.PicklistSchema<["observed", "usage", "practice"], undefined>;
4572
+ /** How the finding is known, in one line: "Seen in 3 sessions (2026-09-15 – 2026-10-03)". */
4573
+ readonly tierLine: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 300, undefined>]>;
4574
+ /** What the drafter did not read, fixed per tier. */
4575
+ readonly blindSpot: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 300, undefined>]>;
4576
+ /** What should change in later sessions if the finding is fixed, wrapped in the untrusted markers. */
4577
+ readonly prediction: v.NullableSchema<v.StringSchema<undefined>, undefined>;
4578
+ }, undefined>, undefined>;
4579
+ /**
4580
+ * Whether the person approved a comment Mossbear drafted. Present on every
4581
+ * Mossbear comment and absent on a person's or an agent's, which are
4582
+ * requests as written. `false` is a draft nobody has read yet: a reader shows
4583
+ * it to the user and acts only on their go-ahead. Only a client that reports
4584
+ * a version able to mark drafts is ever listed one, so an older reader that
4585
+ * strips this field never receives a draft it would print as a request.
4586
+ */
4587
+ readonly approved: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
4588
+ /**
4589
+ * Whether an open Mossbear finding is the agent's to act on. `ready` means the
4590
+ * person accepted it, or its evidence spans enough separate days to need no
4591
+ * Accept. `waiting` means it waits on the person: show it to the user and
4592
+ * change nothing unless they say so. Present only on an open Mossbear comment.
4593
+ * A server that predates the field omits it, and a reader then falls back to
4594
+ * `approved`. This is a new name rather than a new meaning for `state`,
4595
+ * which already says open or resolved.
4596
+ */
4597
+ readonly findingState: v.OptionalSchema<v.PicklistSchema<["ready", "waiting"], undefined>, undefined>;
4598
+ /**
4599
+ * Where the artifact is published from, when Mossbear records one: the
4600
+ * committed `project.id` of the repository whose commits own it, and the
4601
+ * branch it was published from (null when none was recorded). `thisRepo` is
4602
+ * true when that is the repo the read declared, false when it is another repo,
4603
+ * and absent when the read declared no repo. The field is absent when Mossbear
4604
+ * records no publishing repo, which is not a claim that the artifact is
4605
+ * Mossbear-owned.
4606
+ */
4607
+ readonly publishedFrom: v.OptionalSchema<v.ObjectSchema<{
4608
+ readonly repository: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 200, undefined>, v.CheckAction<string, "repository must be trimmed and hold no control characters">]>, undefined>;
4609
+ readonly projectId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
4610
+ readonly branch: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 255, undefined>]>, undefined>;
4611
+ readonly thisRepo: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
4612
+ }, undefined>, undefined>;
4613
+ /** The author's display name as the workspace shows it, or null. Never an email. */
4614
+ readonly authorName: v.NullableSchema<v.StringSchema<undefined>, undefined>;
4615
+ /**
4616
+ * Who wrote it. Optional because a server that predates the field omits it;
4617
+ * a reader that meets a reply without it cannot tell whose it is, and a
4618
+ * server never sends a reply to a client too old to read this.
4619
+ */
4620
+ readonly authorKind: v.OptionalSchema<v.PicklistSchema<["person", "agent", "mossbear"], undefined>, undefined>;
4621
+ /** ISO timestamp, machine format. */
4622
+ readonly createdAt: v.StringSchema<undefined>;
4623
+ /** The item's content version the comment was written against. */
4624
+ readonly itemVersion: v.NumberSchema<undefined>;
4625
+ /** True when the item's current version is greater than `itemVersion`. */
4626
+ readonly itemChangedSince: v.BooleanSchema<undefined>;
4627
+ /**
4628
+ * How many agent reads were handed this comment **before** this one — so a
4629
+ * comment reaching an agent for the first time reports `0`.
4630
+ *
4631
+ * It is the stored count as it read at the moment the response was built;
4632
+ * the serve this response *is* has not been counted yet. Excluded rather
4633
+ * than included because the count is recorded best-effort: a response that
4634
+ * claimed to include itself would be wrong whenever that record failed, and
4635
+ * a number that is sometimes off by one is worse than one that is
4636
+ * consistently the prior total.
4637
+ *
4638
+ * So `deliveredCount > 0` means an earlier read was handed this comment, and
4639
+ * `0` means this read is the first. Neither says a model took it in — only
4640
+ * that the server handed it over.
4641
+ */
4642
+ readonly deliveredCount: v.NumberSchema<undefined>;
4643
+ /**
4644
+ * On a root: true when the item changed after an earlier read was last
4645
+ * handed this comment. For a guide that is any change to its body or its
4646
+ * files, so a fix in a supporting file counts. A reader should check whether
4647
+ * the change addressed the comment, and resolve it with a note if so.
4648
+ *
4649
+ * Computed before this read is counted, so the read that carries `true` is
4650
+ * the one that uses it up; the next read says `false` unless the item
4651
+ * changes again. A comment never handed over before is never flagged.
4652
+ * Optional because a server that predates the field omits it, and absent on
4653
+ * a reply.
4654
+ */
4655
+ readonly guideChangedSinceRead: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
4656
+ /**
4657
+ * This comment's thread root: its own id on a root, the root's id on a reply.
4658
+ *
4659
+ * **Replies ride the same flat array**, each straight after its root, oldest
4660
+ * first. Only a client that reports a version able to render threads is
4661
+ * sent them; any other reader gets roots alone, as it always did. A person's
4662
+ * reply is part of the thread's request. An agent's reply is context: an
4663
+ * earlier message on the thread, never something to act on. A root an agent
4664
+ * wrote is delivered only once a person has replied to it, and is then the
4665
+ * question that reply answers, not a request of its own.
4666
+ */
4667
+ readonly threadId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
4668
+ /**
4669
+ * `null` on a root; the root's id on a reply. Threads are one level deep, so
4670
+ * a reply's parent is always its root.
4671
+ */
4672
+ readonly replyToId: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>;
4673
+ /**
4674
+ * On a root whose thread held more replies than
4675
+ * `MAX_REPLIES_PER_THREAD_ON_WIRE`: how many older ones were not sent.
4676
+ * Absent when the whole thread was sent.
4677
+ */
4678
+ readonly repliesWithheld: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>, undefined>;
4679
+ }, undefined>, undefined>, v.MaxLengthAction<{
4680
+ id: string;
4681
+ state?: "open" | "resolved" | undefined;
4682
+ passage?: {
4683
+ quote: string;
4684
+ status: "located" | "changed" | "orphaned";
4685
+ lines: {
4686
+ start: number;
4687
+ end: number;
4688
+ } | null;
4689
+ } | undefined;
4690
+ body: string;
4691
+ finding?: {
4692
+ tier: "usage" | "observed" | "practice";
4693
+ tierLine: string;
4694
+ blindSpot: string;
4695
+ prediction: string | null;
4696
+ } | undefined;
4697
+ approved?: boolean | undefined;
4698
+ findingState?: "ready" | "waiting" | undefined;
4699
+ publishedFrom?: {
4700
+ repository?: string | undefined;
4701
+ projectId: string;
4702
+ branch: string | null;
4703
+ thisRepo?: boolean | undefined;
4704
+ } | undefined;
4705
+ authorName: string | null;
4706
+ authorKind?: "person" | "agent" | "mossbear" | undefined;
4707
+ createdAt: string;
4708
+ itemVersion: number;
4709
+ itemChangedSince: boolean;
4710
+ deliveredCount: number;
4711
+ guideChangedSinceRead?: boolean | undefined;
4712
+ threadId: string;
4713
+ replyToId: string | null;
4714
+ repliesWithheld?: number | undefined;
4715
+ }[], number, undefined>]>, undefined>;
4716
+ readonly createdAt: v.StringSchema<undefined>;
4717
+ readonly updatedAt: v.StringSchema<undefined>;
4718
+ }, "content" | "comments">, undefined>;
4719
+ export type ArtifactMetadata = v.InferOutput<typeof ArtifactMetadataSchema>;
4720
+ /**
4721
+ * A guide publication: the bytes at an agent-guidance path, published from the
4722
+ * repository that homes the bundle, land as a guide rather than a document.
4723
+ *
4724
+ * `format` is the discovery format of the path, the one import records.
4725
+ * `members` is a skill's member files, relative to its directory, and is
4726
+ * authoritative when present: a stored member it omits is removed, unless it
4727
+ * is listed in `skippedPaths` (present at the ref, but not sendable). Only a
4728
+ * `skill-md` publication carries members.
4729
+ */
4730
+ export declare const GuidePublishSchema: v.SchemaWithPipe<readonly [v.StrictObjectSchema<{
4731
+ readonly format: v.PicklistSchema<["agents-md", "agents-dir", "claude-md", "claude-rules", "cursorrules", "cursor-rules", "skill-md"], undefined>;
4732
+ readonly members: v.OptionalSchema<v.SchemaWithPipe<readonly [v.ArraySchema<v.StrictObjectSchema<{
4733
+ readonly path: v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 512, undefined>, v.CheckAction<string, "path must use forward slashes">, v.CheckAction<string, "path must be relative">, v.CheckAction<string, "path must not contain control characters">, v.CheckAction<string, "path must not contain empty, \".\" or \"..\" segments">]>, v.CheckAction<string, "path must not shadow the skill’s own SKILL.md">]>;
4734
+ readonly content: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.CheckAction<string, "rawContent must be at most 524288 bytes">]>;
4735
+ /** As on {@link RawSkillMemberFileSchema}: absent is not `false`. */
4736
+ readonly executable: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
4737
+ }, undefined>, undefined>, v.MaxLengthAction<{
4738
+ path: string;
4739
+ content: string;
4740
+ executable?: boolean | undefined;
4741
+ }[], 64, undefined>, v.CheckAction<{
4742
+ path: string;
4743
+ content: string;
4744
+ executable?: boolean | undefined;
4745
+ }[], "member paths must be unique (case-insensitive)">]>, undefined>;
4746
+ readonly skippedPaths: v.OptionalSchema<v.SchemaWithPipe<readonly [v.ArraySchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 512, undefined>]>, undefined>, v.MaxLengthAction<string[], 256, undefined>]>, undefined>;
4747
+ /**
4748
+ * The repository's other copies of this file, such as a skill's twin in
4749
+ * the other skills folder, each published as an alias of this guide rather
4750
+ * than a guide of its own. Each must be an alias path of the published one
4751
+ * (`aliasPathSiblings`). Additive: an alias it omits is kept.
4752
+ */
4753
+ readonly aliases: v.OptionalSchema<v.SchemaWithPipe<readonly [v.ArraySchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 512, undefined>, v.CheckAction<string, "path must use forward slashes">, v.CheckAction<string, "path must be relative">, v.CheckAction<string, "path must not contain control characters">, v.CheckAction<string, "path must not contain empty, \".\" or \"..\" segments">]>, undefined>, v.MaxLengthAction<string[], 8, undefined>]>, undefined>;
4754
+ }, undefined>, v.CheckAction<{
4755
+ format: "agents-md" | "agents-dir" | "claude-md" | "claude-rules" | "cursorrules" | "cursor-rules" | "skill-md";
4756
+ members?: {
4757
+ path: string;
4758
+ content: string;
4759
+ executable?: boolean | undefined;
4760
+ }[] | undefined;
4761
+ skippedPaths?: string[] | undefined;
4762
+ aliases?: string[] | undefined;
4763
+ }, "only a skill-md guide carries members">]>;
4764
+ export type GuidePublish = v.InferOutput<typeof GuidePublishSchema>;
4765
+ /**
4766
+ * Create an artifact. Always a create: it takes no id, and an update is a
4767
+ * separate request. `bundle` is optional for an unrestricted caller, who files
4768
+ * later; a scoped credential must name a bundle it may write, and the server
4769
+ * refuses a scoped create without one.
4770
+ */
4771
+ /**
4772
+ * The identity a guide's files carry with them: a skill's
4773
+ * `metadata.mossbear-id`. An opaque lookup key, resolved only inside the
4774
+ * publishing workspace, so it grants nothing even though it sits in public
4775
+ * repos. Both an artifact id and a `nanoid()` fit it.
4776
+ */
4777
+ export declare const IdentityKeySchema: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 128, undefined>, v.RegexAction<string, "an identity key is letters, digits, `-` and `_`">]>;
4778
+ /** How many keys one identity lookup may ask about: a declared set, not more. */
4779
+ export declare const MAX_IDENTITY_LOOKUP_ENTRIES = 500;
4780
+ /**
4781
+ * Ask what publishing each key at a path would do in the workspace of `bundle`
4782
+ * (a bundle id the publishing repo homes), before anything is sent. Read-only.
4783
+ */
4784
+ export declare const ResolveIdentitiesRequestSchema: v.StrictObjectSchema<{
4785
+ readonly bundle: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
4786
+ readonly projectId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>]>;
4787
+ readonly entries: v.SchemaWithPipe<readonly [v.ArraySchema<v.StrictObjectSchema<{
4788
+ readonly key: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 128, undefined>, v.RegexAction<string, "an identity key is letters, digits, `-` and `_`">]>;
4789
+ readonly path: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 512, undefined>, v.CheckAction<string, "path must use forward slashes">, v.CheckAction<string, "path must be relative">, v.CheckAction<string, "path must not contain control characters">, v.CheckAction<string, "path must not contain empty, \".\" or \"..\" segments">]>;
4790
+ }, undefined>, undefined>, v.MinLengthAction<{
4791
+ key: string;
4792
+ path: string;
4793
+ }[], 1, undefined>, v.MaxLengthAction<{
4794
+ key: string;
4795
+ path: string;
4796
+ }[], 500, undefined>]>;
4797
+ }, undefined>;
4798
+ /**
4799
+ * What a publication carrying a key would do, decided by the server's one
4800
+ * transfer rule:
4801
+ *
4802
+ * - `mint`: no artifact in this workspace holds the key, so a new one takes it.
4803
+ * - `current`: this repo's own artifact at this path holds it; an ordinary update.
4804
+ * - `move`: this repo's own artifact holds it at another path (a folder rename).
4805
+ * - `transfer`: another repo's artifact holds it and its home retired it, so
4806
+ * it moves here with its versions, comments and grading.
4807
+ * - `refused`: the holder cannot move here now; `refusal` says why and what to do.
4808
+ */
4809
+ export declare const IdentityClaimKindSchema: v.PicklistSchema<["mint", "current", "move", "transfer", "refused"], undefined>;
4810
+ /** What an artifact carries with it, for a preview to name before a yes. */
4811
+ export declare const IdentityHistorySchema: v.ObjectSchema<{
4812
+ readonly artifactId: v.StringSchema<undefined>;
4813
+ /** Comment threads not yet resolved. */
4814
+ readonly openComments: v.NumberSchema<undefined>;
4186
4815
  /** Grading verdicts recorded against it. */
4187
4816
  readonly verdicts: v.NumberSchema<undefined>;
4188
4817
  }, undefined>;
@@ -4317,6 +4946,8 @@ export declare const CreateArtifactRequestSchema: v.StrictObjectSchema<{
4317
4946
  * `path` and `bundle` beside it.
4318
4947
  */
4319
4948
  readonly gitSource: v.OptionalSchema<v.ObjectSchema<{
4949
+ /** Unverified display label, never an ownership key or a remote URL. */
4950
+ readonly repository: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 200, undefined>, v.CheckAction<string, "repository must be trimmed and hold no control characters">]>, undefined>;
4320
4951
  /**
4321
4952
  * The committed `project.id` of the source repository — the same id space as
4322
4953
  * an item's delivery-scoping `projectId` below, but a different fact: that one
@@ -4483,6 +5114,8 @@ export declare const UpdateArtifactRequestFieldsSchema: v.StrictObjectSchema<{
4483
5114
  * with no path it is refused (400).
4484
5115
  */
4485
5116
  readonly gitSource: v.OptionalSchema<v.ObjectSchema<{
5117
+ /** Unverified display label, never an ownership key or a remote URL. */
5118
+ readonly repository: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 200, undefined>, v.CheckAction<string, "repository must be trimmed and hold no control characters">]>, undefined>;
4486
5119
  /**
4487
5120
  * The committed `project.id` of the source repository — the same id space as
4488
5121
  * an item's delivery-scoping `projectId` below, but a different fact: that one
@@ -4647,6 +5280,8 @@ export declare const UpdateArtifactRequestSchema: v.SchemaWithPipe<readonly [v.S
4647
5280
  * with no path it is refused (400).
4648
5281
  */
4649
5282
  readonly gitSource: v.OptionalSchema<v.ObjectSchema<{
5283
+ /** Unverified display label, never an ownership key or a remote URL. */
5284
+ readonly repository: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 200, undefined>, v.CheckAction<string, "repository must be trimmed and hold no control characters">]>, undefined>;
4650
5285
  /**
4651
5286
  * The committed `project.id` of the source repository — the same id space as
4652
5287
  * an item's delivery-scoping `projectId` below, but a different fact: that one
@@ -4737,6 +5372,7 @@ export declare const UpdateArtifactRequestSchema: v.SchemaWithPipe<readonly [v.S
4737
5372
  authored?: boolean | undefined;
4738
5373
  projectId?: string | undefined;
4739
5374
  gitSource?: {
5375
+ repository?: string | undefined;
4740
5376
  projectId: string;
4741
5377
  commitSha: string;
4742
5378
  branch?: string | undefined;
@@ -4766,6 +5402,8 @@ export declare const UpdateArtifactRequestSchema: v.SchemaWithPipe<readonly [v.S
4766
5402
  */
4767
5403
  export declare const WithdrawArtifactRequestSchema: v.StrictObjectSchema<{
4768
5404
  readonly gitSource: v.ObjectSchema<{
5405
+ /** Unverified display label, never an ownership key or a remote URL. */
5406
+ readonly repository: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 200, undefined>, v.CheckAction<string, "repository must be trimmed and hold no control characters">]>, undefined>;
4769
5407
  /**
4770
5408
  * The committed `project.id` of the source repository — the same id space as
4771
5409
  * an item's delivery-scoping `projectId` below, but a different fact: that one
@@ -4830,11 +5468,25 @@ export declare const ArtifactHistoryQuerySchema: v.ObjectSchema<{
4830
5468
  * revision's bytes while `artifact.version` stays the current version, so the
4831
5469
  * value to send back as `expectedVersion` never depends on what was selected.
4832
5470
  * A version that was never saved is a 404, not the nearest one.
5471
+ * Instead, `expectedVersion` plus `expectedBodyToken` pin a live head and refuse
5472
+ * a mismatch with 409, including an autosave that kept the saved version.
5473
+ * These selectors cannot be combined.
4833
5474
  */
4834
- export declare const ReadArtifactQuerySchema: v.ObjectSchema<{
5475
+ export declare const ReadArtifactQuerySchema: v.SchemaWithPipe<readonly [v.ObjectSchema<{
4835
5476
  readonly version: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>, v.MaxValueAction<number, 2147483647, undefined>]>, undefined>;
4836
- }, undefined>;
4837
- /** Which revision the content in a read response is. */
5477
+ /** Pair the saved version with a live-body token when hydrating a cache. */
5478
+ readonly expectedVersion: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>, v.MaxValueAction<number, 2147483647, undefined>]>, undefined>;
5479
+ readonly expectedBodyToken: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>]>, undefined>;
5480
+ }, undefined>, v.CheckAction<{
5481
+ version?: number | undefined;
5482
+ expectedVersion?: number | undefined;
5483
+ expectedBodyToken?: string | undefined;
5484
+ }, "A historical revision and a current-head precondition cannot be combined.">, v.CheckAction<{
5485
+ version?: number | undefined;
5486
+ expectedVersion?: number | undefined;
5487
+ expectedBodyToken?: string | undefined;
5488
+ }, "A current-head precondition requires both expectedVersion and expectedBodyToken.">]>;
5489
+ /** Which revision the content in a read response is. */
4838
5490
  export declare const ArtifactSelectedRevisionSchema: v.ObjectSchema<{
4839
5491
  readonly version: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>;
4840
5492
  /** True when this is the current version. */
@@ -4894,6 +5546,8 @@ export declare const ReadArtifactResponseSchema: v.ObjectSchema<{
4894
5546
  }[], 8, undefined>]>, undefined>;
4895
5547
  /** Present iff git owns this artifact. */
4896
5548
  readonly gitSource: v.OptionalSchema<v.NullableSchema<v.ObjectSchema<{
5549
+ /** Unverified display label, never an ownership key or a remote URL. */
5550
+ readonly repository: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 200, undefined>, v.CheckAction<string, "repository must be trimmed and hold no control characters">]>, undefined>;
4897
5551
  /**
4898
5552
  * The committed `project.id` of the source repository — the same id space as
4899
5553
  * an item's delivery-scoping `projectId` below, but a different fact: that one
@@ -4948,6 +5602,31 @@ export declare const ReadArtifactResponseSchema: v.ObjectSchema<{
4948
5602
  * strips this field never receives a draft it would print as a request.
4949
5603
  */
4950
5604
  readonly approved: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
5605
+ /**
5606
+ * Whether an open Mossbear finding is the agent's to act on. `ready` means the
5607
+ * person accepted it, or its evidence spans enough separate days to need no
5608
+ * Accept. `waiting` means it waits on the person: show it to the user and
5609
+ * change nothing unless they say so. Present only on an open Mossbear comment.
5610
+ * A server that predates the field omits it, and a reader then falls back to
5611
+ * `approved`. This is a new name rather than a new meaning for `state`,
5612
+ * which already says open or resolved.
5613
+ */
5614
+ readonly findingState: v.OptionalSchema<v.PicklistSchema<["ready", "waiting"], undefined>, undefined>;
5615
+ /**
5616
+ * Where the artifact is published from, when Mossbear records one: the
5617
+ * committed `project.id` of the repository whose commits own it, and the
5618
+ * branch it was published from (null when none was recorded). `thisRepo` is
5619
+ * true when that is the repo the read declared, false when it is another repo,
5620
+ * and absent when the read declared no repo. The field is absent when Mossbear
5621
+ * records no publishing repo, which is not a claim that the artifact is
5622
+ * Mossbear-owned.
5623
+ */
5624
+ readonly publishedFrom: v.OptionalSchema<v.ObjectSchema<{
5625
+ readonly repository: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 200, undefined>, v.CheckAction<string, "repository must be trimmed and hold no control characters">]>, undefined>;
5626
+ readonly projectId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
5627
+ readonly branch: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 255, undefined>]>, undefined>;
5628
+ readonly thisRepo: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
5629
+ }, undefined>, undefined>;
4951
5630
  /** The author's display name as the workspace shows it, or null. Never an email. */
4952
5631
  readonly authorName: v.NullableSchema<v.StringSchema<undefined>, undefined>;
4953
5632
  /**
@@ -5033,6 +5712,13 @@ export declare const ReadArtifactResponseSchema: v.ObjectSchema<{
5033
5712
  prediction: string | null;
5034
5713
  } | undefined;
5035
5714
  approved?: boolean | undefined;
5715
+ findingState?: "ready" | "waiting" | undefined;
5716
+ publishedFrom?: {
5717
+ repository?: string | undefined;
5718
+ projectId: string;
5719
+ branch: string | null;
5720
+ thisRepo?: boolean | undefined;
5721
+ } | undefined;
5036
5722
  authorName: string | null;
5037
5723
  authorKind?: "person" | "agent" | "mossbear" | undefined;
5038
5724
  createdAt: string;
@@ -5053,6 +5739,8 @@ export declare const ReadArtifactResponseSchema: v.ObjectSchema<{
5053
5739
  readonly current: v.BooleanSchema<undefined>;
5054
5740
  readonly contentHash: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>]>, undefined>;
5055
5741
  }, undefined>;
5742
+ /** The live head's token, even when a different historical revision is selected. */
5743
+ readonly headBodyToken: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>]>, undefined>;
5056
5744
  /** Delimiters for comment bodies, present when any comment is returned. */
5057
5745
  readonly untrusted: v.OptionalSchema<v.NullableSchema<v.ObjectSchema<{
5058
5746
  readonly token: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
@@ -5137,6 +5825,8 @@ export declare const CreateArtifactResponseSchema: v.ObjectSchema<{
5137
5825
  }[], 8, undefined>]>, undefined>;
5138
5826
  /** Present iff git owns this artifact. */
5139
5827
  readonly gitSource: v.OptionalSchema<v.NullableSchema<v.ObjectSchema<{
5828
+ /** Unverified display label, never an ownership key or a remote URL. */
5829
+ readonly repository: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 200, undefined>, v.CheckAction<string, "repository must be trimmed and hold no control characters">]>, undefined>;
5140
5830
  /**
5141
5831
  * The committed `project.id` of the source repository — the same id space as
5142
5832
  * an item's delivery-scoping `projectId` below, but a different fact: that one
@@ -5191,6 +5881,31 @@ export declare const CreateArtifactResponseSchema: v.ObjectSchema<{
5191
5881
  * strips this field never receives a draft it would print as a request.
5192
5882
  */
5193
5883
  readonly approved: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
5884
+ /**
5885
+ * Whether an open Mossbear finding is the agent's to act on. `ready` means the
5886
+ * person accepted it, or its evidence spans enough separate days to need no
5887
+ * Accept. `waiting` means it waits on the person: show it to the user and
5888
+ * change nothing unless they say so. Present only on an open Mossbear comment.
5889
+ * A server that predates the field omits it, and a reader then falls back to
5890
+ * `approved`. This is a new name rather than a new meaning for `state`,
5891
+ * which already says open or resolved.
5892
+ */
5893
+ readonly findingState: v.OptionalSchema<v.PicklistSchema<["ready", "waiting"], undefined>, undefined>;
5894
+ /**
5895
+ * Where the artifact is published from, when Mossbear records one: the
5896
+ * committed `project.id` of the repository whose commits own it, and the
5897
+ * branch it was published from (null when none was recorded). `thisRepo` is
5898
+ * true when that is the repo the read declared, false when it is another repo,
5899
+ * and absent when the read declared no repo. The field is absent when Mossbear
5900
+ * records no publishing repo, which is not a claim that the artifact is
5901
+ * Mossbear-owned.
5902
+ */
5903
+ readonly publishedFrom: v.OptionalSchema<v.ObjectSchema<{
5904
+ readonly repository: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 200, undefined>, v.CheckAction<string, "repository must be trimmed and hold no control characters">]>, undefined>;
5905
+ readonly projectId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
5906
+ readonly branch: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 255, undefined>]>, undefined>;
5907
+ readonly thisRepo: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
5908
+ }, undefined>, undefined>;
5194
5909
  /** The author's display name as the workspace shows it, or null. Never an email. */
5195
5910
  readonly authorName: v.NullableSchema<v.StringSchema<undefined>, undefined>;
5196
5911
  /**
@@ -5276,6 +5991,13 @@ export declare const CreateArtifactResponseSchema: v.ObjectSchema<{
5276
5991
  prediction: string | null;
5277
5992
  } | undefined;
5278
5993
  approved?: boolean | undefined;
5994
+ findingState?: "ready" | "waiting" | undefined;
5995
+ publishedFrom?: {
5996
+ repository?: string | undefined;
5997
+ projectId: string;
5998
+ branch: string | null;
5999
+ thisRepo?: boolean | undefined;
6000
+ } | undefined;
5279
6001
  authorName: string | null;
5280
6002
  authorKind?: "person" | "agent" | "mossbear" | undefined;
5281
6003
  createdAt: string;
@@ -5344,6 +6066,315 @@ export declare const UpdateArtifactResponseSchema: v.ObjectSchema<{
5344
6066
  }[], 8, undefined>]>, undefined>;
5345
6067
  /** Present iff git owns this artifact. */
5346
6068
  readonly gitSource: v.OptionalSchema<v.NullableSchema<v.ObjectSchema<{
6069
+ /** Unverified display label, never an ownership key or a remote URL. */
6070
+ readonly repository: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 200, undefined>, v.CheckAction<string, "repository must be trimmed and hold no control characters">]>, undefined>;
6071
+ /**
6072
+ * The committed `project.id` of the source repository — the same id space as
6073
+ * an item's delivery-scoping `projectId` below, but a different fact: that one
6074
+ * says which repo an item is materialized into and is stamped onto
6075
+ * Mossbear-owned rows too, this one says who may edit it.
6076
+ */
6077
+ readonly projectId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 128, undefined>, v.RegexAction<string, "projectId must contain only letters, digits, underscore, dot or hyphen">]>;
6078
+ readonly commitSha: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "commitSha must be 40 or 64 lowercase hex characters">]>;
6079
+ /**
6080
+ * The branch the publishing commit was on. **The one optional member**: a
6081
+ * detached HEAD has none to record. Publishers read it back to tell a copy
6082
+ * from another branch, whose commit a squash merge may have discarded, from
6083
+ * one of the published branch itself.
6084
+ */
6085
+ readonly branch: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 255, undefined>]>, undefined>;
6086
+ }, undefined>, undefined>, undefined>;
6087
+ /** Absent, not empty, when there are none. Absence is not a verdict. */
6088
+ readonly comments: v.OptionalSchema<v.SchemaWithPipe<readonly [v.ArraySchema<v.ObjectSchema<{
6089
+ readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
6090
+ readonly state: v.OptionalSchema<v.PicklistSchema<["open", "resolved"], undefined>, undefined>;
6091
+ /** Current source location of an anchored passage, or its lost quote. */
6092
+ readonly passage: v.OptionalSchema<v.ObjectSchema<{
6093
+ readonly quote: v.StringSchema<undefined>;
6094
+ readonly status: v.PicklistSchema<["located", "changed", "orphaned"], undefined>;
6095
+ readonly lines: v.NullableSchema<v.ObjectSchema<{
6096
+ readonly start: v.NumberSchema<undefined>;
6097
+ readonly end: v.NumberSchema<undefined>;
6098
+ }, undefined>, undefined>;
6099
+ }, undefined>, undefined>;
6100
+ /** The comment's text, already wrapped in the response's untrusted markers. */
6101
+ readonly body: v.StringSchema<undefined>;
6102
+ /**
6103
+ * What a comment Mossbear wrote is: a finding about the item, never an edit.
6104
+ * Present only on a Mossbear comment. The comment's `body` begins with the
6105
+ * claim (what goes wrong); this carries what the claim rests on.
6106
+ */
6107
+ readonly finding: v.OptionalSchema<v.ObjectSchema<{
6108
+ readonly tier: v.PicklistSchema<["observed", "usage", "practice"], undefined>;
6109
+ /** How the finding is known, in one line: "Seen in 3 sessions (2026-09-15 – 2026-10-03)". */
6110
+ readonly tierLine: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 300, undefined>]>;
6111
+ /** What the drafter did not read, fixed per tier. */
6112
+ readonly blindSpot: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 300, undefined>]>;
6113
+ /** What should change in later sessions if the finding is fixed, wrapped in the untrusted markers. */
6114
+ readonly prediction: v.NullableSchema<v.StringSchema<undefined>, undefined>;
6115
+ }, undefined>, undefined>;
6116
+ /**
6117
+ * Whether the person approved a comment Mossbear drafted. Present on every
6118
+ * Mossbear comment and absent on a person's or an agent's, which are
6119
+ * requests as written. `false` is a draft nobody has read yet: a reader shows
6120
+ * it to the user and acts only on their go-ahead. Only a client that reports
6121
+ * a version able to mark drafts is ever listed one, so an older reader that
6122
+ * strips this field never receives a draft it would print as a request.
6123
+ */
6124
+ readonly approved: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
6125
+ /**
6126
+ * Whether an open Mossbear finding is the agent's to act on. `ready` means the
6127
+ * person accepted it, or its evidence spans enough separate days to need no
6128
+ * Accept. `waiting` means it waits on the person: show it to the user and
6129
+ * change nothing unless they say so. Present only on an open Mossbear comment.
6130
+ * A server that predates the field omits it, and a reader then falls back to
6131
+ * `approved`. This is a new name rather than a new meaning for `state`,
6132
+ * which already says open or resolved.
6133
+ */
6134
+ readonly findingState: v.OptionalSchema<v.PicklistSchema<["ready", "waiting"], undefined>, undefined>;
6135
+ /**
6136
+ * Where the artifact is published from, when Mossbear records one: the
6137
+ * committed `project.id` of the repository whose commits own it, and the
6138
+ * branch it was published from (null when none was recorded). `thisRepo` is
6139
+ * true when that is the repo the read declared, false when it is another repo,
6140
+ * and absent when the read declared no repo. The field is absent when Mossbear
6141
+ * records no publishing repo, which is not a claim that the artifact is
6142
+ * Mossbear-owned.
6143
+ */
6144
+ readonly publishedFrom: v.OptionalSchema<v.ObjectSchema<{
6145
+ readonly repository: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 200, undefined>, v.CheckAction<string, "repository must be trimmed and hold no control characters">]>, undefined>;
6146
+ readonly projectId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
6147
+ readonly branch: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 255, undefined>]>, undefined>;
6148
+ readonly thisRepo: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
6149
+ }, undefined>, undefined>;
6150
+ /** The author's display name as the workspace shows it, or null. Never an email. */
6151
+ readonly authorName: v.NullableSchema<v.StringSchema<undefined>, undefined>;
6152
+ /**
6153
+ * Who wrote it. Optional because a server that predates the field omits it;
6154
+ * a reader that meets a reply without it cannot tell whose it is, and a
6155
+ * server never sends a reply to a client too old to read this.
6156
+ */
6157
+ readonly authorKind: v.OptionalSchema<v.PicklistSchema<["person", "agent", "mossbear"], undefined>, undefined>;
6158
+ /** ISO timestamp, machine format. */
6159
+ readonly createdAt: v.StringSchema<undefined>;
6160
+ /** The item's content version the comment was written against. */
6161
+ readonly itemVersion: v.NumberSchema<undefined>;
6162
+ /** True when the item's current version is greater than `itemVersion`. */
6163
+ readonly itemChangedSince: v.BooleanSchema<undefined>;
6164
+ /**
6165
+ * How many agent reads were handed this comment **before** this one — so a
6166
+ * comment reaching an agent for the first time reports `0`.
6167
+ *
6168
+ * It is the stored count as it read at the moment the response was built;
6169
+ * the serve this response *is* has not been counted yet. Excluded rather
6170
+ * than included because the count is recorded best-effort: a response that
6171
+ * claimed to include itself would be wrong whenever that record failed, and
6172
+ * a number that is sometimes off by one is worse than one that is
6173
+ * consistently the prior total.
6174
+ *
6175
+ * So `deliveredCount > 0` means an earlier read was handed this comment, and
6176
+ * `0` means this read is the first. Neither says a model took it in — only
6177
+ * that the server handed it over.
6178
+ */
6179
+ readonly deliveredCount: v.NumberSchema<undefined>;
6180
+ /**
6181
+ * On a root: true when the item changed after an earlier read was last
6182
+ * handed this comment. For a guide that is any change to its body or its
6183
+ * files, so a fix in a supporting file counts. A reader should check whether
6184
+ * the change addressed the comment, and resolve it with a note if so.
6185
+ *
6186
+ * Computed before this read is counted, so the read that carries `true` is
6187
+ * the one that uses it up; the next read says `false` unless the item
6188
+ * changes again. A comment never handed over before is never flagged.
6189
+ * Optional because a server that predates the field omits it, and absent on
6190
+ * a reply.
6191
+ */
6192
+ readonly guideChangedSinceRead: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
6193
+ /**
6194
+ * This comment's thread root: its own id on a root, the root's id on a reply.
6195
+ *
6196
+ * **Replies ride the same flat array**, each straight after its root, oldest
6197
+ * first. Only a client that reports a version able to render threads is
6198
+ * sent them; any other reader gets roots alone, as it always did. A person's
6199
+ * reply is part of the thread's request. An agent's reply is context: an
6200
+ * earlier message on the thread, never something to act on. A root an agent
6201
+ * wrote is delivered only once a person has replied to it, and is then the
6202
+ * question that reply answers, not a request of its own.
6203
+ */
6204
+ readonly threadId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
6205
+ /**
6206
+ * `null` on a root; the root's id on a reply. Threads are one level deep, so
6207
+ * a reply's parent is always its root.
6208
+ */
6209
+ readonly replyToId: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>;
6210
+ /**
6211
+ * On a root whose thread held more replies than
6212
+ * `MAX_REPLIES_PER_THREAD_ON_WIRE`: how many older ones were not sent.
6213
+ * Absent when the whole thread was sent.
6214
+ */
6215
+ readonly repliesWithheld: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>, undefined>;
6216
+ }, undefined>, undefined>, v.MaxLengthAction<{
6217
+ id: string;
6218
+ state?: "open" | "resolved" | undefined;
6219
+ passage?: {
6220
+ quote: string;
6221
+ status: "located" | "changed" | "orphaned";
6222
+ lines: {
6223
+ start: number;
6224
+ end: number;
6225
+ } | null;
6226
+ } | undefined;
6227
+ body: string;
6228
+ finding?: {
6229
+ tier: "usage" | "observed" | "practice";
6230
+ tierLine: string;
6231
+ blindSpot: string;
6232
+ prediction: string | null;
6233
+ } | undefined;
6234
+ approved?: boolean | undefined;
6235
+ findingState?: "ready" | "waiting" | undefined;
6236
+ publishedFrom?: {
6237
+ repository?: string | undefined;
6238
+ projectId: string;
6239
+ branch: string | null;
6240
+ thisRepo?: boolean | undefined;
6241
+ } | undefined;
6242
+ authorName: string | null;
6243
+ authorKind?: "person" | "agent" | "mossbear" | undefined;
6244
+ createdAt: string;
6245
+ itemVersion: number;
6246
+ itemChangedSince: boolean;
6247
+ deliveredCount: number;
6248
+ guideChangedSinceRead?: boolean | undefined;
6249
+ threadId: string;
6250
+ replyToId: string | null;
6251
+ repliesWithheld?: number | undefined;
6252
+ }[], number, undefined>]>, undefined>;
6253
+ readonly createdAt: v.StringSchema<undefined>;
6254
+ readonly updatedAt: v.StringSchema<undefined>;
6255
+ }, undefined>;
6256
+ }, undefined>;
6257
+ /** Most artifacts one page of `GET /api/v1/artifacts` returns, and the default. */
6258
+ export declare const MAX_LIST_ARTIFACTS_LIMIT = 500;
6259
+ export declare const DEFAULT_LIST_ARTIFACTS_LIMIT = 100;
6260
+ /**
6261
+ * `GET /api/v1/artifacts`: the query string, as an object of its values.
6262
+ *
6263
+ * Every filter narrows; none is required. `inbox=true` is the Inbox: the
6264
+ * caller's own captures that are not done, not deleted and not filed, so it
6265
+ * cannot be combined with `bundle`. `bundle` is a bundle id. `kind` is a
6266
+ * comma-separated list of {@link ARTIFACT_KINDS}. `since` is an ISO timestamp
6267
+ * compared with when the artifact was created, which is also the order: newest
6268
+ * first. `cursor` is the previous page's `nextCursor`, opaque to the caller.
6269
+ *
6270
+ * There is no text query: finding by text is `GET /api/v1/search`.
6271
+ *
6272
+ * `comments=none` asks to be handed no comments, and not to be counted as
6273
+ * having received any, for a caller that will not show them.
6274
+ */
6275
+ export declare const ListArtifactsQuerySchema: v.SchemaWithPipe<readonly [v.ObjectSchema<{
6276
+ readonly inbox: v.OptionalSchema<v.PicklistSchema<["true", "false"], "inbox must be true or false">, undefined>;
6277
+ readonly bundle: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 128, undefined>]>, undefined>;
6278
+ readonly kind: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TransformAction<string, string[]>, v.ArraySchema<v.PicklistSchema<readonly ["markdown", "html", "code", "photo", "file", "guide"], `kind must be one of ${string}`>, undefined>, v.MinLengthAction<("markdown" | "guide" | "html" | "code" | "photo" | "file")[], 1, undefined>]>, undefined>;
6279
+ readonly since: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.CheckAction<string, "since must be an ISO timestamp">]>, undefined>;
6280
+ readonly limit: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "limit must be a whole number from 1 to 500">, v.TransformAction<any, number>, v.MinValueAction<number, 1, "limit must be a whole number from 1 to 500">, v.MaxValueAction<number, 500, "limit must be a whole number from 1 to 500">]>, string>;
6281
+ readonly cursor: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 512, undefined>]>, undefined>;
6282
+ readonly comments: v.OptionalSchema<v.LiteralSchema<"none", undefined>, undefined>;
6283
+ /** Omit bodies and comments without fetching external source bytes. */
6284
+ readonly view: v.OptionalSchema<v.LiteralSchema<"metadata", undefined>, undefined>;
6285
+ /** The CLI release asking, so thread replies reach only one that renders them. */
6286
+ readonly cli: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 64, undefined>]>, undefined>;
6287
+ }, undefined>, v.CheckAction<{
6288
+ inbox?: "true" | "false" | undefined;
6289
+ bundle?: string | undefined;
6290
+ kind?: ("markdown" | "guide" | "html" | "code" | "photo" | "file")[] | undefined;
6291
+ since?: string | undefined;
6292
+ limit: number;
6293
+ cursor?: string | undefined;
6294
+ comments?: "none" | undefined;
6295
+ view?: "metadata" | undefined;
6296
+ cli?: string | undefined;
6297
+ }, "The inbox holds only unfiled captures, so inbox and bundle cannot be combined.">, v.TransformAction<{
6298
+ inbox?: "true" | "false" | undefined;
6299
+ bundle?: string | undefined;
6300
+ kind?: ("markdown" | "guide" | "html" | "code" | "photo" | "file")[] | undefined;
6301
+ since?: string | undefined;
6302
+ limit: number;
6303
+ cursor?: string | undefined;
6304
+ comments?: "none" | undefined;
6305
+ view?: "metadata" | undefined;
6306
+ cli?: string | undefined;
6307
+ }, {
6308
+ inbox: boolean;
6309
+ bundle?: string | undefined;
6310
+ kind?: ("markdown" | "guide" | "html" | "code" | "photo" | "file")[] | undefined;
6311
+ since?: string | undefined;
6312
+ limit: number;
6313
+ cursor?: string | undefined;
6314
+ comments?: "none" | undefined;
6315
+ view?: "metadata" | undefined;
6316
+ cli?: string | undefined;
6317
+ }>]>;
6318
+ export type ListArtifactsQuery = v.InferOutput<typeof ListArtifactsQuerySchema>;
6319
+ /**
6320
+ * One page of the artifact listing, newest first. `nextCursor` is null on the
6321
+ * last page. `untrusted` delimits comment bodies, as on a read.
6322
+ */
6323
+ export declare const ListArtifactsResponseSchema: v.ObjectSchema<{
6324
+ readonly artifacts: v.ArraySchema<v.ObjectSchema<{
6325
+ readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
6326
+ readonly name: v.StringSchema<undefined>;
6327
+ readonly role: v.PicklistSchema<["guidance", "criteria", "content"], undefined>;
6328
+ readonly format: v.PicklistSchema<["markdown", "html", "binary", "code"], undefined>;
6329
+ /** What the artifact is, as a reader names it: {@link artifactKindOf}. */
6330
+ readonly kind: v.PicklistSchema<readonly ["markdown", "html", "code", "photo", "file", "guide"], undefined>;
6331
+ /** Set when the artifact is a photo: its stored parts, never their bytes. */
6332
+ readonly asset: v.OptionalSchema<v.NullableSchema<v.ObjectSchema<{
6333
+ readonly parts: v.ArraySchema<v.ObjectSchema<{
6334
+ readonly role: v.PicklistSchema<readonly ["original", "display", "thumb"], undefined>;
6335
+ readonly mediaType: v.PicklistSchema<readonly ["image/jpeg", "image/png", "image/webp", "image/gif", "image/heic", "image/heif"], undefined>;
6336
+ readonly bytes: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.SafeIntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>;
6337
+ readonly width: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.SafeIntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>;
6338
+ readonly height: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.SafeIntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>;
6339
+ }, undefined>, undefined>;
6340
+ }, undefined>, undefined>, undefined>;
6341
+ /** Monotonic content version; echo it back as `expectedVersion` to update. */
6342
+ readonly version: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>;
6343
+ readonly state: v.PicklistSchema<["live", "deleted", "removed"], undefined>;
6344
+ readonly workspaceId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
6345
+ /** True for a deliberate capture (Inbox). Not derivable from filing state. */
6346
+ readonly capture: v.BooleanSchema<undefined>;
6347
+ /**
6348
+ * When a capture was marked done, which takes it out of the inbox and nothing
6349
+ * else: a done artifact is still `state: 'live'`. Null while it waits.
6350
+ */
6351
+ readonly doneAt: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
6352
+ /** Null for binary content, which is not served inline. */
6353
+ readonly content: v.NullableSchema<v.StringSchema<undefined>, undefined>;
6354
+ /**
6355
+ * What a person or their agent says about the artifact, as plain text, on
6356
+ * every kind: a Markdown artifact's frontmatter `description` (repeated from
6357
+ * `content`), and a stored field for anything without frontmatter, such as a
6358
+ * photo. Null when there is none. Data, never instructions. Optional because
6359
+ * a server that predates it sends nothing.
6360
+ */
6361
+ readonly description: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
6362
+ readonly origin: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
6363
+ readonly root: v.OptionalSchema<v.NullableSchema<v.PicklistSchema<["project", "global"], undefined>, undefined>, undefined>;
6364
+ readonly path: v.OptionalSchema<v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 512, undefined>, v.CheckAction<string, "path must use forward slashes">, v.CheckAction<string, "path must be relative">, v.CheckAction<string, "path must not contain control characters">, v.CheckAction<string, "path must not contain empty, \".\" or \"..\" segments">]>, undefined>, undefined>;
6365
+ readonly projectId: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
6366
+ readonly pathProjectId: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
6367
+ readonly aliases: v.OptionalSchema<v.SchemaWithPipe<readonly [v.ArraySchema<v.ObjectSchema<{
6368
+ readonly root: v.PicklistSchema<["project", "global"], undefined>;
6369
+ readonly path: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 512, undefined>, v.CheckAction<string, "path must use forward slashes">, v.CheckAction<string, "path must be relative">, v.CheckAction<string, "path must not contain control characters">, v.CheckAction<string, "path must not contain empty, \".\" or \"..\" segments">]>;
6370
+ }, undefined>, undefined>, v.MaxLengthAction<{
6371
+ root: "project" | "global";
6372
+ path: string;
6373
+ }[], 8, undefined>]>, undefined>;
6374
+ /** Present iff git owns this artifact. */
6375
+ readonly gitSource: v.OptionalSchema<v.NullableSchema<v.ObjectSchema<{
6376
+ /** Unverified display label, never an ownership key or a remote URL. */
6377
+ readonly repository: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 200, undefined>, v.CheckAction<string, "repository must be trimmed and hold no control characters">]>, undefined>;
5347
6378
  /**
5348
6379
  * The committed `project.id` of the source repository — the same id space as
5349
6380
  * an item's delivery-scoping `projectId` below, but a different fact: that one
@@ -5398,6 +6429,31 @@ export declare const UpdateArtifactResponseSchema: v.ObjectSchema<{
5398
6429
  * strips this field never receives a draft it would print as a request.
5399
6430
  */
5400
6431
  readonly approved: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
6432
+ /**
6433
+ * Whether an open Mossbear finding is the agent's to act on. `ready` means the
6434
+ * person accepted it, or its evidence spans enough separate days to need no
6435
+ * Accept. `waiting` means it waits on the person: show it to the user and
6436
+ * change nothing unless they say so. Present only on an open Mossbear comment.
6437
+ * A server that predates the field omits it, and a reader then falls back to
6438
+ * `approved`. This is a new name rather than a new meaning for `state`,
6439
+ * which already says open or resolved.
6440
+ */
6441
+ readonly findingState: v.OptionalSchema<v.PicklistSchema<["ready", "waiting"], undefined>, undefined>;
6442
+ /**
6443
+ * Where the artifact is published from, when Mossbear records one: the
6444
+ * committed `project.id` of the repository whose commits own it, and the
6445
+ * branch it was published from (null when none was recorded). `thisRepo` is
6446
+ * true when that is the repo the read declared, false when it is another repo,
6447
+ * and absent when the read declared no repo. The field is absent when Mossbear
6448
+ * records no publishing repo, which is not a claim that the artifact is
6449
+ * Mossbear-owned.
6450
+ */
6451
+ readonly publishedFrom: v.OptionalSchema<v.ObjectSchema<{
6452
+ readonly repository: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 200, undefined>, v.CheckAction<string, "repository must be trimmed and hold no control characters">]>, undefined>;
6453
+ readonly projectId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
6454
+ readonly branch: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 255, undefined>]>, undefined>;
6455
+ readonly thisRepo: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
6456
+ }, undefined>, undefined>;
5401
6457
  /** The author's display name as the workspace shows it, or null. Never an email. */
5402
6458
  readonly authorName: v.NullableSchema<v.StringSchema<undefined>, undefined>;
5403
6459
  /**
@@ -5483,6 +6539,13 @@ export declare const UpdateArtifactResponseSchema: v.ObjectSchema<{
5483
6539
  prediction: string | null;
5484
6540
  } | undefined;
5485
6541
  approved?: boolean | undefined;
6542
+ findingState?: "ready" | "waiting" | undefined;
6543
+ publishedFrom?: {
6544
+ repository?: string | undefined;
6545
+ projectId: string;
6546
+ branch: string | null;
6547
+ thisRepo?: boolean | undefined;
6548
+ } | undefined;
5486
6549
  authorName: string | null;
5487
6550
  authorKind?: "person" | "agent" | "mossbear" | undefined;
5488
6551
  createdAt: string;
@@ -5496,71 +6559,20 @@ export declare const UpdateArtifactResponseSchema: v.ObjectSchema<{
5496
6559
  }[], number, undefined>]>, undefined>;
5497
6560
  readonly createdAt: v.StringSchema<undefined>;
5498
6561
  readonly updatedAt: v.StringSchema<undefined>;
5499
- }, undefined>;
6562
+ }, undefined>, undefined>;
6563
+ readonly nextCursor: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>;
6564
+ readonly untrusted: v.OptionalSchema<v.NullableSchema<v.ObjectSchema<{
6565
+ readonly token: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
6566
+ readonly startMarker: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
6567
+ readonly endMarker: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
6568
+ readonly note: v.StringSchema<undefined>;
6569
+ }, undefined>, undefined>, undefined>;
5500
6570
  }, undefined>;
5501
- /** Most artifacts one page of `GET /api/v1/artifacts` returns, and the default. */
5502
- export declare const MAX_LIST_ARTIFACTS_LIMIT = 500;
5503
- export declare const DEFAULT_LIST_ARTIFACTS_LIMIT = 100;
5504
- /**
5505
- * `GET /api/v1/artifacts`: the query string, as an object of its values.
5506
- *
5507
- * Every filter narrows; none is required. `inbox=true` is the Inbox: the
5508
- * caller's own captures that are not done, not deleted and not filed, so it
5509
- * cannot be combined with `bundle`. `bundle` is a bundle id. `kind` is a
5510
- * comma-separated list of {@link ARTIFACT_KINDS}. `since` is an ISO timestamp
5511
- * compared with when the artifact was created, which is also the order: newest
5512
- * first. `cursor` is the previous page's `nextCursor`, opaque to the caller.
5513
- *
5514
- * There is no text query: finding by text is `GET /api/v1/search`.
5515
- *
5516
- * `comments=none` asks to be handed no comments, and not to be counted as
5517
- * having received any, for a caller that will not show them.
5518
- */
5519
- export declare const ListArtifactsQuerySchema: v.SchemaWithPipe<readonly [v.ObjectSchema<{
5520
- readonly inbox: v.OptionalSchema<v.PicklistSchema<["true", "false"], "inbox must be true or false">, undefined>;
5521
- readonly bundle: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 128, undefined>]>, undefined>;
5522
- readonly kind: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TransformAction<string, string[]>, v.ArraySchema<v.PicklistSchema<readonly ["markdown", "html", "code", "photo", "file", "guide"], `kind must be one of ${string}`>, undefined>, v.MinLengthAction<("markdown" | "guide" | "html" | "code" | "photo" | "file")[], 1, undefined>]>, undefined>;
5523
- readonly since: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.CheckAction<string, "since must be an ISO timestamp">]>, undefined>;
5524
- readonly limit: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "limit must be a whole number from 1 to 500">, v.TransformAction<any, number>, v.MinValueAction<number, 1, "limit must be a whole number from 1 to 500">, v.MaxValueAction<number, 500, "limit must be a whole number from 1 to 500">]>, string>;
5525
- readonly cursor: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 512, undefined>]>, undefined>;
5526
- readonly comments: v.OptionalSchema<v.LiteralSchema<"none", undefined>, undefined>;
5527
- /** The CLI release asking, so thread replies reach only one that renders them. */
5528
- readonly cli: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 64, undefined>]>, undefined>;
5529
- }, undefined>, v.CheckAction<{
5530
- inbox?: "true" | "false" | undefined;
5531
- bundle?: string | undefined;
5532
- kind?: ("markdown" | "guide" | "html" | "code" | "photo" | "file")[] | undefined;
5533
- since?: string | undefined;
5534
- limit: number;
5535
- cursor?: string | undefined;
5536
- comments?: "none" | undefined;
5537
- cli?: string | undefined;
5538
- }, "The inbox holds only unfiled captures, so inbox and bundle cannot be combined.">, v.TransformAction<{
5539
- inbox?: "true" | "false" | undefined;
5540
- bundle?: string | undefined;
5541
- kind?: ("markdown" | "guide" | "html" | "code" | "photo" | "file")[] | undefined;
5542
- since?: string | undefined;
5543
- limit: number;
5544
- cursor?: string | undefined;
5545
- comments?: "none" | undefined;
5546
- cli?: string | undefined;
5547
- }, {
5548
- inbox: boolean;
5549
- bundle?: string | undefined;
5550
- kind?: ("markdown" | "guide" | "html" | "code" | "photo" | "file")[] | undefined;
5551
- since?: string | undefined;
5552
- limit: number;
5553
- cursor?: string | undefined;
5554
- comments?: "none" | undefined;
5555
- cli?: string | undefined;
5556
- }>]>;
5557
- export type ListArtifactsQuery = v.InferOutput<typeof ListArtifactsQuerySchema>;
5558
- /**
5559
- * One page of the artifact listing, newest first. `nextCursor` is null on the
5560
- * last page. `untrusted` delimits comment bodies, as on a read.
5561
- */
5562
- export declare const ListArtifactsResponseSchema: v.ObjectSchema<{
5563
- readonly artifacts: v.ArraySchema<v.ObjectSchema<{
6571
+ export type ListArtifactsResponse = v.InferOutput<typeof ListArtifactsResponseSchema>;
6572
+ /** Explicit projection; missing bodies must not be mistaken for empty content. */
6573
+ export declare const ListArtifactMetadataResponseSchema: v.ObjectSchema<{
6574
+ readonly projection: v.LiteralSchema<"metadata", undefined>;
6575
+ readonly artifacts: v.ArraySchema<v.StrictObjectSchema<Omit<{
5564
6576
  readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
5565
6577
  readonly name: v.StringSchema<undefined>;
5566
6578
  readonly role: v.PicklistSchema<["guidance", "criteria", "content"], undefined>;
@@ -5612,6 +6624,8 @@ export declare const ListArtifactsResponseSchema: v.ObjectSchema<{
5612
6624
  }[], 8, undefined>]>, undefined>;
5613
6625
  /** Present iff git owns this artifact. */
5614
6626
  readonly gitSource: v.OptionalSchema<v.NullableSchema<v.ObjectSchema<{
6627
+ /** Unverified display label, never an ownership key or a remote URL. */
6628
+ readonly repository: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 200, undefined>, v.CheckAction<string, "repository must be trimmed and hold no control characters">]>, undefined>;
5615
6629
  /**
5616
6630
  * The committed `project.id` of the source repository — the same id space as
5617
6631
  * an item's delivery-scoping `projectId` below, but a different fact: that one
@@ -5666,6 +6680,31 @@ export declare const ListArtifactsResponseSchema: v.ObjectSchema<{
5666
6680
  * strips this field never receives a draft it would print as a request.
5667
6681
  */
5668
6682
  readonly approved: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
6683
+ /**
6684
+ * Whether an open Mossbear finding is the agent's to act on. `ready` means the
6685
+ * person accepted it, or its evidence spans enough separate days to need no
6686
+ * Accept. `waiting` means it waits on the person: show it to the user and
6687
+ * change nothing unless they say so. Present only on an open Mossbear comment.
6688
+ * A server that predates the field omits it, and a reader then falls back to
6689
+ * `approved`. This is a new name rather than a new meaning for `state`,
6690
+ * which already says open or resolved.
6691
+ */
6692
+ readonly findingState: v.OptionalSchema<v.PicklistSchema<["ready", "waiting"], undefined>, undefined>;
6693
+ /**
6694
+ * Where the artifact is published from, when Mossbear records one: the
6695
+ * committed `project.id` of the repository whose commits own it, and the
6696
+ * branch it was published from (null when none was recorded). `thisRepo` is
6697
+ * true when that is the repo the read declared, false when it is another repo,
6698
+ * and absent when the read declared no repo. The field is absent when Mossbear
6699
+ * records no publishing repo, which is not a claim that the artifact is
6700
+ * Mossbear-owned.
6701
+ */
6702
+ readonly publishedFrom: v.OptionalSchema<v.ObjectSchema<{
6703
+ readonly repository: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 200, undefined>, v.CheckAction<string, "repository must be trimmed and hold no control characters">]>, undefined>;
6704
+ readonly projectId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
6705
+ readonly branch: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 255, undefined>]>, undefined>;
6706
+ readonly thisRepo: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
6707
+ }, undefined>, undefined>;
5669
6708
  /** The author's display name as the workspace shows it, or null. Never an email. */
5670
6709
  readonly authorName: v.NullableSchema<v.StringSchema<undefined>, undefined>;
5671
6710
  /**
@@ -5751,6 +6790,13 @@ export declare const ListArtifactsResponseSchema: v.ObjectSchema<{
5751
6790
  prediction: string | null;
5752
6791
  } | undefined;
5753
6792
  approved?: boolean | undefined;
6793
+ findingState?: "ready" | "waiting" | undefined;
6794
+ publishedFrom?: {
6795
+ repository?: string | undefined;
6796
+ projectId: string;
6797
+ branch: string | null;
6798
+ thisRepo?: boolean | undefined;
6799
+ } | undefined;
5754
6800
  authorName: string | null;
5755
6801
  authorKind?: "person" | "agent" | "mossbear" | undefined;
5756
6802
  createdAt: string;
@@ -5764,16 +6810,172 @@ export declare const ListArtifactsResponseSchema: v.ObjectSchema<{
5764
6810
  }[], number, undefined>]>, undefined>;
5765
6811
  readonly createdAt: v.StringSchema<undefined>;
5766
6812
  readonly updatedAt: v.StringSchema<undefined>;
5767
- }, undefined>, undefined>;
6813
+ }, "content" | "comments">, undefined>, undefined>;
5768
6814
  readonly nextCursor: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>;
5769
- readonly untrusted: v.OptionalSchema<v.NullableSchema<v.ObjectSchema<{
5770
- readonly token: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
5771
- readonly startMarker: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
5772
- readonly endMarker: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
5773
- readonly note: v.StringSchema<undefined>;
5774
- }, undefined>, undefined>, undefined>;
5775
6815
  }, undefined>;
5776
- export type ListArtifactsResponse = v.InferOutput<typeof ListArtifactsResponseSchema>;
6816
+ export type ListArtifactMetadataResponse = v.InferOutput<typeof ListArtifactMetadataResponseSchema>;
6817
+ /** Maximum heads in a reconciliation manifest; overflow is explicitly incomplete. */
6818
+ export declare const MAX_ARTIFACT_MANIFEST_HEADS = 10000;
6819
+ export declare const ArtifactManifestQuerySchema: v.StrictObjectSchema<{
6820
+ readonly bundle: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 128, undefined>]>, undefined>;
6821
+ }, undefined>;
6822
+ export type ArtifactManifestQuery = v.InferOutput<typeof ArtifactManifestQuerySchema>;
6823
+ export declare const ArtifactManifestScopeSchema: v.StrictObjectSchema<{
6824
+ readonly userId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
6825
+ readonly bundleId: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>;
6826
+ readonly principalId: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>;
6827
+ }, undefined>;
6828
+ export type ArtifactManifestScope = v.InferOutput<typeof ArtifactManifestScopeSchema>;
6829
+ export declare const ArtifactManifestHeadSchema: v.StrictObjectSchema<{
6830
+ readonly bodyToken: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>]>;
6831
+ readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
6832
+ readonly version: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>, v.MaxValueAction<number, 2147483647, undefined>]>;
6833
+ }, undefined>;
6834
+ /** Bounded body hydration, separate from metadata/comment snapshots. */
6835
+ export declare const MAX_ARTIFACT_BODY_BATCH_HEADS = 50;
6836
+ export declare const MAX_ARTIFACT_BODY_BATCH_CONTENT_BYTES: number;
6837
+ export declare const MAX_ARTIFACT_BODY_BATCH_REQUEST_BYTES: number;
6838
+ export declare const ArtifactBodyBatchRequestSchema: v.StrictObjectSchema<{
6839
+ readonly bundle: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 128, undefined>]>, undefined>;
6840
+ readonly heads: v.SchemaWithPipe<readonly [v.ArraySchema<v.StrictObjectSchema<{
6841
+ readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 128, undefined>]>;
6842
+ readonly bodyToken: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>]>;
6843
+ readonly version: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>, v.MaxValueAction<number, 2147483647, undefined>]>;
6844
+ }, undefined>, undefined>, v.MinLengthAction<{
6845
+ id: string;
6846
+ bodyToken: string;
6847
+ version: number;
6848
+ }[], 1, undefined>, v.MaxLengthAction<{
6849
+ id: string;
6850
+ bodyToken: string;
6851
+ version: number;
6852
+ }[], 50, undefined>, v.CheckAction<{
6853
+ id: string;
6854
+ bodyToken: string;
6855
+ version: number;
6856
+ }[], "Duplicate artifact IDs">]>;
6857
+ }, undefined>;
6858
+ export type ArtifactBodyBatchRequest = v.InferOutput<typeof ArtifactBodyBatchRequestSchema>;
6859
+ export declare const ArtifactBodyBatchResultSchema: v.VariantSchema<"status", [v.StrictObjectSchema<{
6860
+ readonly status: v.LiteralSchema<"ok", undefined>;
6861
+ readonly content: v.NullableSchema<v.StringSchema<undefined>, undefined>;
6862
+ readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 128, undefined>]>;
6863
+ readonly bodyToken: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>]>;
6864
+ readonly version: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>, v.MaxValueAction<number, 2147483647, undefined>]>;
6865
+ }, undefined>, ...v.StrictObjectSchema<{
6866
+ readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 128, undefined>]>;
6867
+ readonly status: v.LiteralSchema<"unavailable" | "changed" | "deferred" | "oversized", undefined>;
6868
+ }, undefined>[]], undefined>;
6869
+ export type ArtifactBodyBatchResult = v.InferOutput<typeof ArtifactBodyBatchResultSchema>;
6870
+ export declare const ArtifactBodyBatchResponseSchema: v.SchemaWithPipe<readonly [v.StrictObjectSchema<{
6871
+ readonly scope: v.StrictObjectSchema<{
6872
+ readonly userId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
6873
+ readonly bundleId: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>;
6874
+ readonly principalId: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>;
6875
+ }, undefined>;
6876
+ readonly results: v.SchemaWithPipe<readonly [v.ArraySchema<v.VariantSchema<"status", [v.StrictObjectSchema<{
6877
+ readonly status: v.LiteralSchema<"ok", undefined>;
6878
+ readonly content: v.NullableSchema<v.StringSchema<undefined>, undefined>;
6879
+ readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 128, undefined>]>;
6880
+ readonly bodyToken: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>]>;
6881
+ readonly version: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>, v.MaxValueAction<number, 2147483647, undefined>]>;
6882
+ }, undefined>, ...v.StrictObjectSchema<{
6883
+ readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 128, undefined>]>;
6884
+ readonly status: v.LiteralSchema<"unavailable" | "changed" | "deferred" | "oversized", undefined>;
6885
+ }, undefined>[]], undefined>, undefined>, v.MinLengthAction<({
6886
+ status: "ok";
6887
+ content: string | null;
6888
+ id: string;
6889
+ bodyToken: string;
6890
+ version: number;
6891
+ } | {
6892
+ id: string;
6893
+ status: "unavailable" | "changed" | "deferred" | "oversized";
6894
+ })[], 1, undefined>, v.MaxLengthAction<({
6895
+ status: "ok";
6896
+ content: string | null;
6897
+ id: string;
6898
+ bodyToken: string;
6899
+ version: number;
6900
+ } | {
6901
+ id: string;
6902
+ status: "unavailable" | "changed" | "deferred" | "oversized";
6903
+ })[], 50, undefined>, v.CheckAction<({
6904
+ status: "ok";
6905
+ content: string | null;
6906
+ id: string;
6907
+ bodyToken: string;
6908
+ version: number;
6909
+ } | {
6910
+ id: string;
6911
+ status: "unavailable" | "changed" | "deferred" | "oversized";
6912
+ })[], "Duplicate artifact IDs">]>;
6913
+ }, undefined>, v.CheckAction<{
6914
+ scope: {
6915
+ userId: string;
6916
+ bundleId: string | null;
6917
+ principalId: string | null;
6918
+ };
6919
+ results: ({
6920
+ status: "ok";
6921
+ content: string | null;
6922
+ id: string;
6923
+ bodyToken: string;
6924
+ version: number;
6925
+ } | {
6926
+ id: string;
6927
+ status: "unavailable" | "changed" | "deferred" | "oversized";
6928
+ })[];
6929
+ }, "Body batch content budget exceeded">]>;
6930
+ export type ArtifactBodyBatchResponse = v.InferOutput<typeof ArtifactBodyBatchResponseSchema>;
6931
+ /**
6932
+ * Only a complete manifest identifies the whole authorized head set. A client
6933
+ * must still hydrate those exact versions and body tokens before marking its cache complete.
6934
+ */
6935
+ export declare const ArtifactManifestResponseSchema: v.VariantSchema<"complete", [v.StrictObjectSchema<{
6936
+ readonly scope: v.StrictObjectSchema<{
6937
+ readonly userId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
6938
+ readonly bundleId: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>;
6939
+ readonly principalId: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>;
6940
+ }, undefined>;
6941
+ readonly complete: v.LiteralSchema<true, undefined>;
6942
+ readonly fingerprint: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>]>;
6943
+ readonly artifacts: v.SchemaWithPipe<readonly [v.ArraySchema<v.StrictObjectSchema<{
6944
+ readonly bodyToken: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>]>;
6945
+ readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
6946
+ readonly version: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>, v.MaxValueAction<number, 2147483647, undefined>]>;
6947
+ }, undefined>, undefined>, v.MaxLengthAction<{
6948
+ bodyToken: string;
6949
+ id: string;
6950
+ version: number;
6951
+ }[], 10000, undefined>, v.CheckAction<{
6952
+ bodyToken: string;
6953
+ id: string;
6954
+ version: number;
6955
+ }[], "Duplicate artifact IDs">]>;
6956
+ }, undefined>, v.StrictObjectSchema<{
6957
+ readonly scope: v.StrictObjectSchema<{
6958
+ readonly userId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
6959
+ readonly bundleId: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>;
6960
+ readonly principalId: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>;
6961
+ }, undefined>;
6962
+ readonly complete: v.LiteralSchema<false, undefined>;
6963
+ readonly fingerprint: v.NullSchema<undefined>;
6964
+ readonly artifacts: v.SchemaWithPipe<readonly [v.ArraySchema<v.StrictObjectSchema<{
6965
+ readonly bodyToken: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>]>;
6966
+ readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
6967
+ readonly version: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>, v.MaxValueAction<number, 2147483647, undefined>]>;
6968
+ }, undefined>, undefined>, v.MaxLengthAction<{
6969
+ bodyToken: string;
6970
+ id: string;
6971
+ version: number;
6972
+ }[], 10000, undefined>, v.CheckAction<{
6973
+ bodyToken: string;
6974
+ id: string;
6975
+ version: number;
6976
+ }[], "Duplicate artifact IDs">]>;
6977
+ }, undefined>], undefined>;
6978
+ export type ArtifactManifestResponse = v.InferOutput<typeof ArtifactManifestResponseSchema>;
5777
6979
  /**
5778
6980
  * `POST /api/v1/artifacts/:id/done`: `true` marks a capture done, which takes it
5779
6981
  * out of the inbox and nothing else; `false` moves it back to the inbox.
@@ -5835,6 +7037,8 @@ export declare const MarkDoneResponseSchema: v.ObjectSchema<{
5835
7037
  }[], 8, undefined>]>, undefined>;
5836
7038
  /** Present iff git owns this artifact. */
5837
7039
  readonly gitSource: v.OptionalSchema<v.NullableSchema<v.ObjectSchema<{
7040
+ /** Unverified display label, never an ownership key or a remote URL. */
7041
+ readonly repository: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 200, undefined>, v.CheckAction<string, "repository must be trimmed and hold no control characters">]>, undefined>;
5838
7042
  /**
5839
7043
  * The committed `project.id` of the source repository — the same id space as
5840
7044
  * an item's delivery-scoping `projectId` below, but a different fact: that one
@@ -5889,6 +7093,31 @@ export declare const MarkDoneResponseSchema: v.ObjectSchema<{
5889
7093
  * strips this field never receives a draft it would print as a request.
5890
7094
  */
5891
7095
  readonly approved: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
7096
+ /**
7097
+ * Whether an open Mossbear finding is the agent's to act on. `ready` means the
7098
+ * person accepted it, or its evidence spans enough separate days to need no
7099
+ * Accept. `waiting` means it waits on the person: show it to the user and
7100
+ * change nothing unless they say so. Present only on an open Mossbear comment.
7101
+ * A server that predates the field omits it, and a reader then falls back to
7102
+ * `approved`. This is a new name rather than a new meaning for `state`,
7103
+ * which already says open or resolved.
7104
+ */
7105
+ readonly findingState: v.OptionalSchema<v.PicklistSchema<["ready", "waiting"], undefined>, undefined>;
7106
+ /**
7107
+ * Where the artifact is published from, when Mossbear records one: the
7108
+ * committed `project.id` of the repository whose commits own it, and the
7109
+ * branch it was published from (null when none was recorded). `thisRepo` is
7110
+ * true when that is the repo the read declared, false when it is another repo,
7111
+ * and absent when the read declared no repo. The field is absent when Mossbear
7112
+ * records no publishing repo, which is not a claim that the artifact is
7113
+ * Mossbear-owned.
7114
+ */
7115
+ readonly publishedFrom: v.OptionalSchema<v.ObjectSchema<{
7116
+ readonly repository: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 200, undefined>, v.CheckAction<string, "repository must be trimmed and hold no control characters">]>, undefined>;
7117
+ readonly projectId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
7118
+ readonly branch: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 255, undefined>]>, undefined>;
7119
+ readonly thisRepo: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
7120
+ }, undefined>, undefined>;
5892
7121
  /** The author's display name as the workspace shows it, or null. Never an email. */
5893
7122
  readonly authorName: v.NullableSchema<v.StringSchema<undefined>, undefined>;
5894
7123
  /**
@@ -5974,6 +7203,13 @@ export declare const MarkDoneResponseSchema: v.ObjectSchema<{
5974
7203
  prediction: string | null;
5975
7204
  } | undefined;
5976
7205
  approved?: boolean | undefined;
7206
+ findingState?: "ready" | "waiting" | undefined;
7207
+ publishedFrom?: {
7208
+ repository?: string | undefined;
7209
+ projectId: string;
7210
+ branch: string | null;
7211
+ thisRepo?: boolean | undefined;
7212
+ } | undefined;
5977
7213
  authorName: string | null;
5978
7214
  authorKind?: "person" | "agent" | "mossbear" | undefined;
5979
7215
  createdAt: string;
@@ -6044,6 +7280,8 @@ export declare const DeleteArtifactResponseSchema: v.ObjectSchema<{
6044
7280
  }[], 8, undefined>]>, undefined>;
6045
7281
  /** Present iff git owns this artifact. */
6046
7282
  readonly gitSource: v.OptionalSchema<v.NullableSchema<v.ObjectSchema<{
7283
+ /** Unverified display label, never an ownership key or a remote URL. */
7284
+ readonly repository: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 200, undefined>, v.CheckAction<string, "repository must be trimmed and hold no control characters">]>, undefined>;
6047
7285
  /**
6048
7286
  * The committed `project.id` of the source repository — the same id space as
6049
7287
  * an item's delivery-scoping `projectId` below, but a different fact: that one
@@ -6098,6 +7336,31 @@ export declare const DeleteArtifactResponseSchema: v.ObjectSchema<{
6098
7336
  * strips this field never receives a draft it would print as a request.
6099
7337
  */
6100
7338
  readonly approved: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
7339
+ /**
7340
+ * Whether an open Mossbear finding is the agent's to act on. `ready` means the
7341
+ * person accepted it, or its evidence spans enough separate days to need no
7342
+ * Accept. `waiting` means it waits on the person: show it to the user and
7343
+ * change nothing unless they say so. Present only on an open Mossbear comment.
7344
+ * A server that predates the field omits it, and a reader then falls back to
7345
+ * `approved`. This is a new name rather than a new meaning for `state`,
7346
+ * which already says open or resolved.
7347
+ */
7348
+ readonly findingState: v.OptionalSchema<v.PicklistSchema<["ready", "waiting"], undefined>, undefined>;
7349
+ /**
7350
+ * Where the artifact is published from, when Mossbear records one: the
7351
+ * committed `project.id` of the repository whose commits own it, and the
7352
+ * branch it was published from (null when none was recorded). `thisRepo` is
7353
+ * true when that is the repo the read declared, false when it is another repo,
7354
+ * and absent when the read declared no repo. The field is absent when Mossbear
7355
+ * records no publishing repo, which is not a claim that the artifact is
7356
+ * Mossbear-owned.
7357
+ */
7358
+ readonly publishedFrom: v.OptionalSchema<v.ObjectSchema<{
7359
+ readonly repository: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 200, undefined>, v.CheckAction<string, "repository must be trimmed and hold no control characters">]>, undefined>;
7360
+ readonly projectId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
7361
+ readonly branch: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 255, undefined>]>, undefined>;
7362
+ readonly thisRepo: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
7363
+ }, undefined>, undefined>;
6101
7364
  /** The author's display name as the workspace shows it, or null. Never an email. */
6102
7365
  readonly authorName: v.NullableSchema<v.StringSchema<undefined>, undefined>;
6103
7366
  /**
@@ -6183,6 +7446,13 @@ export declare const DeleteArtifactResponseSchema: v.ObjectSchema<{
6183
7446
  prediction: string | null;
6184
7447
  } | undefined;
6185
7448
  approved?: boolean | undefined;
7449
+ findingState?: "ready" | "waiting" | undefined;
7450
+ publishedFrom?: {
7451
+ repository?: string | undefined;
7452
+ projectId: string;
7453
+ branch: string | null;
7454
+ thisRepo?: boolean | undefined;
7455
+ } | undefined;
6186
7456
  authorName: string | null;
6187
7457
  authorKind?: "person" | "agent" | "mossbear" | undefined;
6188
7458
  createdAt: string;
@@ -6252,6 +7522,8 @@ export declare const WithdrawArtifactResponseSchema: v.ObjectSchema<{
6252
7522
  }[], 8, undefined>]>, undefined>;
6253
7523
  /** Present iff git owns this artifact. */
6254
7524
  readonly gitSource: v.OptionalSchema<v.NullableSchema<v.ObjectSchema<{
7525
+ /** Unverified display label, never an ownership key or a remote URL. */
7526
+ readonly repository: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 200, undefined>, v.CheckAction<string, "repository must be trimmed and hold no control characters">]>, undefined>;
6255
7527
  /**
6256
7528
  * The committed `project.id` of the source repository — the same id space as
6257
7529
  * an item's delivery-scoping `projectId` below, but a different fact: that one
@@ -6306,6 +7578,31 @@ export declare const WithdrawArtifactResponseSchema: v.ObjectSchema<{
6306
7578
  * strips this field never receives a draft it would print as a request.
6307
7579
  */
6308
7580
  readonly approved: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
7581
+ /**
7582
+ * Whether an open Mossbear finding is the agent's to act on. `ready` means the
7583
+ * person accepted it, or its evidence spans enough separate days to need no
7584
+ * Accept. `waiting` means it waits on the person: show it to the user and
7585
+ * change nothing unless they say so. Present only on an open Mossbear comment.
7586
+ * A server that predates the field omits it, and a reader then falls back to
7587
+ * `approved`. This is a new name rather than a new meaning for `state`,
7588
+ * which already says open or resolved.
7589
+ */
7590
+ readonly findingState: v.OptionalSchema<v.PicklistSchema<["ready", "waiting"], undefined>, undefined>;
7591
+ /**
7592
+ * Where the artifact is published from, when Mossbear records one: the
7593
+ * committed `project.id` of the repository whose commits own it, and the
7594
+ * branch it was published from (null when none was recorded). `thisRepo` is
7595
+ * true when that is the repo the read declared, false when it is another repo,
7596
+ * and absent when the read declared no repo. The field is absent when Mossbear
7597
+ * records no publishing repo, which is not a claim that the artifact is
7598
+ * Mossbear-owned.
7599
+ */
7600
+ readonly publishedFrom: v.OptionalSchema<v.ObjectSchema<{
7601
+ readonly repository: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 200, undefined>, v.CheckAction<string, "repository must be trimmed and hold no control characters">]>, undefined>;
7602
+ readonly projectId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
7603
+ readonly branch: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 255, undefined>]>, undefined>;
7604
+ readonly thisRepo: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
7605
+ }, undefined>, undefined>;
6309
7606
  /** The author's display name as the workspace shows it, or null. Never an email. */
6310
7607
  readonly authorName: v.NullableSchema<v.StringSchema<undefined>, undefined>;
6311
7608
  /**
@@ -6391,6 +7688,13 @@ export declare const WithdrawArtifactResponseSchema: v.ObjectSchema<{
6391
7688
  prediction: string | null;
6392
7689
  } | undefined;
6393
7690
  approved?: boolean | undefined;
7691
+ findingState?: "ready" | "waiting" | undefined;
7692
+ publishedFrom?: {
7693
+ repository?: string | undefined;
7694
+ projectId: string;
7695
+ branch: string | null;
7696
+ thisRepo?: boolean | undefined;
7697
+ } | undefined;
6394
7698
  authorName: string | null;
6395
7699
  authorKind?: "person" | "agent" | "mossbear" | undefined;
6396
7700
  createdAt: string;
@@ -6542,8 +7846,8 @@ export declare const ArtifactHistoryResponseSchema: v.ObjectSchema<{
6542
7846
  readonly nextCursor: v.NullableSchema<v.NumberSchema<undefined>, undefined>;
6543
7847
  }, undefined>;
6544
7848
  /**
6545
- * The one refused-stale-write shape, for a direct update and a bundle-scoped one
6546
- * alike. The `code` is what separates a retryable conflict from the other 409s
7849
+ * The refused-stale-write shape for direct and bundle-scoped updates alike.
7850
+ * The `code` separates a retryable conflict from the other 409s
6547
7851
  * (a read-only artifact is permanent). Nothing was written.
6548
7852
  */
6549
7853
  export declare const ArtifactVersionConflictSchema: v.ObjectSchema<{
@@ -6553,6 +7857,16 @@ export declare const ArtifactVersionConflictSchema: v.ObjectSchema<{
6553
7857
  readonly expectedVersion: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>;
6554
7858
  readonly requestId: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
6555
7859
  }, undefined>;
7860
+ /** The requested live body no longer matches its metadata/manifest head. */
7861
+ export declare const ArtifactReadConflictSchema: v.ObjectSchema<{
7862
+ readonly error: v.StringSchema<undefined>;
7863
+ readonly code: v.LiteralSchema<"read-conflict", undefined>;
7864
+ readonly currentVersion: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>;
7865
+ readonly expectedVersion: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>;
7866
+ readonly currentBodyToken: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>]>;
7867
+ readonly expectedBodyToken: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>]>;
7868
+ readonly requestId: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
7869
+ }, undefined>;
6556
7870
  /**
6557
7871
  * Save a draft of an artifact from a git branch. One draft per artifact,
6558
7872
  * author and branch, so a second upload from the same branch replaces the
@@ -6596,6 +7910,40 @@ export declare const UpsertArtifactDraftResponseSchema: v.ObjectSchema<{
6596
7910
  readonly updatedAt: v.StringSchema<undefined>;
6597
7911
  }, undefined>, undefined>;
6598
7912
  }, undefined>;
7913
+ /** Most revisions one retire call may carry; a longer range sends its newest. */
7914
+ export declare const MAX_LANDED_REVISIONS = 200;
7915
+ /**
7916
+ * One revision a published branch held between two publications: the sha256
7917
+ * of its UTF-8 text, as a draft's `contentHash` is, and the committer time of
7918
+ * the commit on the branch that replaced those bytes (the next commit that
7919
+ * touched the path, or the tip).
7920
+ */
7921
+ export declare const LandedRevisionSchema: v.StrictObjectSchema<{
7922
+ readonly hash: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>]>;
7923
+ readonly supersededAt: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, undefined>]>;
7924
+ }, undefined>;
7925
+ /**
7926
+ * Drafts of an artifact whose bytes a published branch held at some commit the
7927
+ * dashboard never received (the ref moved several commits between two
7928
+ * publications). The server cannot check the claim, so it retires only the
7929
+ * caller's own drafts, and only those last saved before the branch moved off
7930
+ * those bytes: a draft of the same bytes saved after is a new proposal.
7931
+ */
7932
+ export declare const RetireArtifactDraftsRequestSchema: v.StrictObjectSchema<{
7933
+ readonly landedRevisions: v.SchemaWithPipe<readonly [v.ArraySchema<v.StrictObjectSchema<{
7934
+ readonly hash: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>]>;
7935
+ readonly supersededAt: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, undefined>]>;
7936
+ }, undefined>, undefined>, v.MinLengthAction<{
7937
+ hash: string;
7938
+ supersededAt: string;
7939
+ }[], 1, undefined>, v.MaxLengthAction<{
7940
+ hash: string;
7941
+ supersededAt: string;
7942
+ }[], 200, undefined>]>;
7943
+ }, undefined>;
7944
+ export declare const RetireArtifactDraftsResponseSchema: v.ObjectSchema<{
7945
+ readonly retired: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
7946
+ }, undefined>;
6599
7947
  /** The caller's own drafts of one artifact, most recently updated first. */
6600
7948
  export declare const ListArtifactDraftsResponseSchema: v.ObjectSchema<{
6601
7949
  readonly drafts: v.ArraySchema<v.ObjectSchema<{
@@ -8252,6 +9600,31 @@ export declare const ArtifactFeedbackResponseSchema: v.ObjectSchema<{
8252
9600
  * strips this field never receives a draft it would print as a request.
8253
9601
  */
8254
9602
  readonly approved: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
9603
+ /**
9604
+ * Whether an open Mossbear finding is the agent's to act on. `ready` means the
9605
+ * person accepted it, or its evidence spans enough separate days to need no
9606
+ * Accept. `waiting` means it waits on the person: show it to the user and
9607
+ * change nothing unless they say so. Present only on an open Mossbear comment.
9608
+ * A server that predates the field omits it, and a reader then falls back to
9609
+ * `approved`. This is a new name rather than a new meaning for `state`,
9610
+ * which already says open or resolved.
9611
+ */
9612
+ readonly findingState: v.OptionalSchema<v.PicklistSchema<["ready", "waiting"], undefined>, undefined>;
9613
+ /**
9614
+ * Where the artifact is published from, when Mossbear records one: the
9615
+ * committed `project.id` of the repository whose commits own it, and the
9616
+ * branch it was published from (null when none was recorded). `thisRepo` is
9617
+ * true when that is the repo the read declared, false when it is another repo,
9618
+ * and absent when the read declared no repo. The field is absent when Mossbear
9619
+ * records no publishing repo, which is not a claim that the artifact is
9620
+ * Mossbear-owned.
9621
+ */
9622
+ readonly publishedFrom: v.OptionalSchema<v.ObjectSchema<{
9623
+ readonly repository: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 200, undefined>, v.CheckAction<string, "repository must be trimmed and hold no control characters">]>, undefined>;
9624
+ readonly projectId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
9625
+ readonly branch: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 255, undefined>]>, undefined>;
9626
+ readonly thisRepo: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
9627
+ }, undefined>, undefined>;
8255
9628
  /** The author's display name as the workspace shows it, or null. Never an email. */
8256
9629
  readonly authorName: v.NullableSchema<v.StringSchema<undefined>, undefined>;
8257
9630
  /**
@@ -8588,6 +9961,31 @@ export declare const ArtifactFeedbackBatchResponseSchema: v.ObjectSchema<{
8588
9961
  * strips this field never receives a draft it would print as a request.
8589
9962
  */
8590
9963
  readonly approved: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
9964
+ /**
9965
+ * Whether an open Mossbear finding is the agent's to act on. `ready` means the
9966
+ * person accepted it, or its evidence spans enough separate days to need no
9967
+ * Accept. `waiting` means it waits on the person: show it to the user and
9968
+ * change nothing unless they say so. Present only on an open Mossbear comment.
9969
+ * A server that predates the field omits it, and a reader then falls back to
9970
+ * `approved`. This is a new name rather than a new meaning for `state`,
9971
+ * which already says open or resolved.
9972
+ */
9973
+ readonly findingState: v.OptionalSchema<v.PicklistSchema<["ready", "waiting"], undefined>, undefined>;
9974
+ /**
9975
+ * Where the artifact is published from, when Mossbear records one: the
9976
+ * committed `project.id` of the repository whose commits own it, and the
9977
+ * branch it was published from (null when none was recorded). `thisRepo` is
9978
+ * true when that is the repo the read declared, false when it is another repo,
9979
+ * and absent when the read declared no repo. The field is absent when Mossbear
9980
+ * records no publishing repo, which is not a claim that the artifact is
9981
+ * Mossbear-owned.
9982
+ */
9983
+ readonly publishedFrom: v.OptionalSchema<v.ObjectSchema<{
9984
+ readonly repository: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 200, undefined>, v.CheckAction<string, "repository must be trimmed and hold no control characters">]>, undefined>;
9985
+ readonly projectId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
9986
+ readonly branch: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 255, undefined>]>, undefined>;
9987
+ readonly thisRepo: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
9988
+ }, undefined>, undefined>;
8591
9989
  /** The author's display name as the workspace shows it, or null. Never an email. */
8592
9990
  readonly authorName: v.NullableSchema<v.StringSchema<undefined>, undefined>;
8593
9991
  /**
@@ -10230,11 +11628,17 @@ export declare function parseGuideMemberFilesResponse(data: unknown): {
10230
11628
  };
10231
11629
  export declare function parseBundleListResponse(data: unknown): {
10232
11630
  bundles: {
11631
+ home?: string | undefined;
11632
+ publisher?: {
11633
+ name: string;
11634
+ handle: string;
11635
+ } | undefined;
11636
+ readOnly?: true | undefined;
10233
11637
  id: string;
10234
11638
  slug: string;
10235
11639
  name: string;
10236
11640
  createdAt: string;
10237
- home?: string | undefined;
11641
+ description?: string | null | undefined;
10238
11642
  }[];
10239
11643
  };
10240
11644
  export declare function parseWorkspaceListResponse(data: unknown): {
@@ -10257,17 +11661,24 @@ export declare function parseRevokeScopedTokenRequest(data: unknown): {
10257
11661
  id: string;
10258
11662
  };
10259
11663
  export declare function parseCreateBundleRequest(data: unknown): {
11664
+ description?: string | null | undefined;
10260
11665
  slug: string;
10261
11666
  name: string;
10262
11667
  workspaceId?: string | undefined;
10263
11668
  };
10264
11669
  export declare function parseCreateBundleResponse(data: unknown): {
10265
11670
  bundle: {
11671
+ home?: string | undefined;
11672
+ publisher?: {
11673
+ name: string;
11674
+ handle: string;
11675
+ } | undefined;
11676
+ readOnly?: true | undefined;
10266
11677
  id: string;
10267
11678
  slug: string;
10268
11679
  name: string;
10269
11680
  createdAt: string;
10270
- home?: string | undefined;
11681
+ description?: string | null | undefined;
10271
11682
  };
10272
11683
  };
10273
11684
  export declare function parseAttachBundleMemberRequest(data: unknown): {
@@ -10300,9 +11711,16 @@ export declare function parseSubscribeBundleResponse(data: unknown): {
10300
11711
  };
10301
11712
  export declare function parseResolveSubscriptionsRequest(data: unknown): {
10302
11713
  repoBundleIds: string[];
11714
+ repoBundleAddresses?: string[] | undefined;
10303
11715
  };
10304
11716
  export declare function parseResolveSubscriptionsResponse(data: unknown): {
10305
11717
  bundles: {
11718
+ address?: string | undefined;
11719
+ publisher?: {
11720
+ name: string;
11721
+ handle: string;
11722
+ } | undefined;
11723
+ readOnly?: true | undefined;
10306
11724
  id: string;
10307
11725
  slug: string;
10308
11726
  name: string;
@@ -10314,6 +11732,9 @@ export declare function parseResolveSubscriptionsResponse(data: unknown): {
10314
11732
  unresolved: {
10315
11733
  id: string;
10316
11734
  }[];
11735
+ unresolvedAddresses?: {
11736
+ address: string;
11737
+ }[] | undefined;
10317
11738
  account?: {
10318
11739
  deliverGlobalSkills: boolean;
10319
11740
  } | undefined;
@@ -10323,14 +11744,21 @@ export declare function parseUpdateBundleRequest(data: unknown): {
10323
11744
  name?: string | undefined;
10324
11745
  home?: string | null | undefined;
10325
11746
  columns?: string[] | null | undefined;
11747
+ description?: string | null | undefined;
10326
11748
  };
10327
11749
  export declare function parseUpdateBundleResponse(data: unknown): {
10328
11750
  bundle: {
11751
+ home?: string | undefined;
11752
+ publisher?: {
11753
+ name: string;
11754
+ handle: string;
11755
+ } | undefined;
11756
+ readOnly?: true | undefined;
10329
11757
  id: string;
10330
11758
  slug: string;
10331
11759
  name: string;
10332
11760
  createdAt: string;
10333
- home?: string | undefined;
11761
+ description?: string | null | undefined;
10334
11762
  };
10335
11763
  };
10336
11764
  export declare function parseDeleteBundleResponse(data: unknown): {
@@ -10386,6 +11814,13 @@ export declare function parseContextItemsResponse(data: unknown): {
10386
11814
  prediction: string | null;
10387
11815
  } | undefined;
10388
11816
  approved?: boolean | undefined;
11817
+ findingState?: "ready" | "waiting" | undefined;
11818
+ publishedFrom?: {
11819
+ repository?: string | undefined;
11820
+ projectId: string;
11821
+ branch: string | null;
11822
+ thisRepo?: boolean | undefined;
11823
+ } | undefined;
10389
11824
  authorName: string | null;
10390
11825
  authorKind?: "person" | "agent" | "mossbear" | undefined;
10391
11826
  createdAt: string;
@@ -10399,6 +11834,7 @@ export declare function parseContextItemsResponse(data: unknown): {
10399
11834
  }[] | undefined;
10400
11835
  updatedAt: string;
10401
11836
  gitSource?: {
11837
+ repository?: string | undefined;
10402
11838
  projectId: string;
10403
11839
  commitSha: string;
10404
11840
  branch?: string | undefined;
@@ -10465,6 +11901,13 @@ export declare function parseBundleArtifactsResponse(data: unknown): {
10465
11901
  prediction: string | null;
10466
11902
  } | undefined;
10467
11903
  approved?: boolean | undefined;
11904
+ findingState?: "ready" | "waiting" | undefined;
11905
+ publishedFrom?: {
11906
+ repository?: string | undefined;
11907
+ projectId: string;
11908
+ branch: string | null;
11909
+ thisRepo?: boolean | undefined;
11910
+ } | undefined;
10468
11911
  authorName: string | null;
10469
11912
  authorKind?: "person" | "agent" | "mossbear" | undefined;
10470
11913
  createdAt: string;
@@ -10478,6 +11921,7 @@ export declare function parseBundleArtifactsResponse(data: unknown): {
10478
11921
  }[] | undefined;
10479
11922
  updatedAt: string;
10480
11923
  gitSource?: {
11924
+ repository?: string | undefined;
10481
11925
  projectId: string;
10482
11926
  commitSha: string;
10483
11927
  branch?: string | undefined;
@@ -10813,6 +12257,13 @@ export declare function parseItemCommentsResponse(data: unknown): {
10813
12257
  prediction: string | null;
10814
12258
  } | undefined;
10815
12259
  approved?: boolean | undefined;
12260
+ findingState?: "ready" | "waiting" | undefined;
12261
+ publishedFrom?: {
12262
+ repository?: string | undefined;
12263
+ projectId: string;
12264
+ branch: string | null;
12265
+ thisRepo?: boolean | undefined;
12266
+ } | undefined;
10816
12267
  authorName: string | null;
10817
12268
  authorKind?: "person" | "agent" | "mossbear" | undefined;
10818
12269
  createdAt: string;