@aventurevc/api-schemas 0.8.261 → 0.8.262

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.
Files changed (49) hide show
  1. package/dist/entity/analysis-citation.d.ts +1 -0
  2. package/dist/entity/analysis-citation.js +1 -0
  3. package/dist/entity/analysis-figure.d.ts +1 -0
  4. package/dist/entity/analysis-figure.js +1 -0
  5. package/dist/entity/analysis-paragraph.d.ts +1 -0
  6. package/dist/entity/analysis-paragraph.js +1 -0
  7. package/dist/entity/analysis-section-mutation.d.ts +156 -0
  8. package/dist/entity/analysis-section-mutation.js +34 -0
  9. package/dist/entity/analysis-section-origin.d.ts +1 -0
  10. package/dist/entity/analysis-section-origin.js +1 -0
  11. package/dist/federated/search.d.ts +8 -0
  12. package/dist/link/search.d.ts +8 -0
  13. package/dist/natural/search-result.d.ts +8 -0
  14. package/dist/openapi-component-manifest.js +35 -0
  15. package/dist/research/finding.d.ts +3 -0
  16. package/dist/research/finding.js +3 -0
  17. package/dist/search/answer-paragraph.d.ts +7 -0
  18. package/dist/search/answer-paragraph.js +3 -0
  19. package/dist/search/answer-web-source.d.ts +27 -0
  20. package/dist/search/answer-web-source.js +25 -0
  21. package/dist/search/answer.d.ts +8 -0
  22. package/dist/shared/search.d.ts +8 -0
  23. package/dist/writer/analysis-section.d.ts +28 -0
  24. package/dist/writer/analysis-section.js +21 -0
  25. package/dist/writer/brief.d.ts +102 -0
  26. package/dist/writer/brief.js +29 -0
  27. package/dist/writer/change-signal.d.ts +22 -0
  28. package/dist/writer/change-signal.js +20 -0
  29. package/dist/writer/claim-surface.d.ts +2 -0
  30. package/dist/writer/claim-surface.js +2 -0
  31. package/dist/writer/gap-reason.d.ts +26 -0
  32. package/dist/writer/gap-reason.js +20 -0
  33. package/dist/writer/gap.d.ts +35 -0
  34. package/dist/writer/gap.js +23 -0
  35. package/dist/writer/judgment.d.ts +23 -0
  36. package/dist/writer/judgment.js +21 -0
  37. package/dist/writer/meta-analysis.d.ts +62 -0
  38. package/dist/writer/meta-analysis.js +34 -0
  39. package/dist/writer/paragraph-analysis.d.ts +17 -0
  40. package/dist/writer/paragraph-analysis.js +19 -0
  41. package/dist/writer/paragraph.d.ts +40 -0
  42. package/dist/writer/paragraph.js +24 -0
  43. package/dist/writer/positioning-element.d.ts +29 -0
  44. package/dist/writer/positioning-element.js +22 -0
  45. package/dist/writer/positioning.d.ts +37 -0
  46. package/dist/writer/positioning.js +23 -0
  47. package/dist/writer/scope.d.ts +23 -0
  48. package/dist/writer/scope.js +22 -0
  49. package/package.json +1 -1
@@ -14,6 +14,7 @@ export interface EntityAnalysisCitationSchemaInput extends z.input<typeof Entity
14
14
  * @endpoint GET /v1/research/runs/{runId}/draft
15
15
  * @endpoint PUT /v1/research-runs/{runId}/draft/sections/{sectionKey}
16
16
  * @endpoint PUT /v1/research/runs/{runId}/draft/sections/{sectionKey}
17
+ * @usedBySchema EntityAnalysisSectionMutationSchema
17
18
  * @usedBySchema EntityAnalysisSectionSchema
18
19
  * @contractShape entity.analysis-citation
19
20
  * @contractRole canonical
@@ -14,6 +14,7 @@ const EntityAnalysisCitationSchemaDefinition = z.object({
14
14
  * @endpoint GET /v1/research/runs/{runId}/draft
15
15
  * @endpoint PUT /v1/research-runs/{runId}/draft/sections/{sectionKey}
16
16
  * @endpoint PUT /v1/research/runs/{runId}/draft/sections/{sectionKey}
17
+ * @usedBySchema EntityAnalysisSectionMutationSchema
17
18
  * @usedBySchema EntityAnalysisSectionSchema
18
19
  * @contractShape entity.analysis-citation
19
20
  * @contractRole canonical
@@ -40,6 +40,7 @@ export interface EntityAnalysisFigureSchemaInput extends z.input<typeof EntityAn
40
40
  * @endpoint GET /v1/research/runs/{runId}/draft
41
41
  * @endpoint PUT /v1/research-runs/{runId}/draft/sections/{sectionKey}
42
42
  * @endpoint PUT /v1/research/runs/{runId}/draft/sections/{sectionKey}
43
+ * @usedBySchema EntityAnalysisSectionMutationSchema
43
44
  * @usedBySchema EntityAnalysisSectionSchema
44
45
  * @contractShape entity.analysis-figure
45
46
  * @contractRole canonical
@@ -20,6 +20,7 @@ const EntityAnalysisFigureSchemaDefinition = z.object({
20
20
  * @endpoint GET /v1/research/runs/{runId}/draft
21
21
  * @endpoint PUT /v1/research-runs/{runId}/draft/sections/{sectionKey}
22
22
  * @endpoint PUT /v1/research/runs/{runId}/draft/sections/{sectionKey}
23
+ * @usedBySchema EntityAnalysisSectionMutationSchema
23
24
  * @usedBySchema EntityAnalysisSectionSchema
24
25
  * @contractShape entity.analysis-figure
25
26
  * @contractRole canonical
@@ -14,6 +14,7 @@ export interface EntityAnalysisParagraphSchemaInput extends z.input<typeof Entit
14
14
  * @endpoint GET /v1/research/runs/{runId}/draft
15
15
  * @endpoint PUT /v1/research-runs/{runId}/draft/sections/{sectionKey}
16
16
  * @endpoint PUT /v1/research/runs/{runId}/draft/sections/{sectionKey}
17
+ * @usedBySchema EntityAnalysisSectionMutationSchema
17
18
  * @usedBySchema EntityAnalysisSectionSchema
18
19
  * @contractShape entity.analysis-paragraph
19
20
  * @contractRole canonical
@@ -14,6 +14,7 @@ const EntityAnalysisParagraphSchemaDefinition = z.object({
14
14
  * @endpoint GET /v1/research/runs/{runId}/draft
15
15
  * @endpoint PUT /v1/research-runs/{runId}/draft/sections/{sectionKey}
16
16
  * @endpoint PUT /v1/research/runs/{runId}/draft/sections/{sectionKey}
17
+ * @usedBySchema EntityAnalysisSectionMutationSchema
17
18
  * @usedBySchema EntityAnalysisSectionSchema
18
19
  * @contractShape entity.analysis-paragraph
19
20
  * @contractRole canonical
@@ -0,0 +1,156 @@
1
+ import { z } from "zod/v4";
2
+ declare const EntityAnalysisSectionMutationSchemaDefinition: z.ZodObject<{
3
+ citation: z.ZodArray<z.ZodType<{
4
+ quote: string;
5
+ sourceDocumentId: string;
6
+ }, import("./analysis-citation.ts").EntityAnalysisCitationSchemaInput, z.core.$ZodTypeInternals<{
7
+ quote: string;
8
+ sourceDocumentId: string;
9
+ }, import("./analysis-citation.ts").EntityAnalysisCitationSchemaInput>>>;
10
+ figure: z.ZodOptional<z.ZodArray<z.ZodType<{
11
+ column?: string[] | undefined;
12
+ entry: {
13
+ cell: {
14
+ citation: number;
15
+ excerpt: string;
16
+ }[];
17
+ label: string;
18
+ }[];
19
+ title: string;
20
+ type: string;
21
+ }, import("./analysis-figure.ts").EntityAnalysisFigureSchemaInput, z.core.$ZodTypeInternals<{
22
+ column?: string[] | undefined;
23
+ entry: {
24
+ cell: {
25
+ citation: number;
26
+ excerpt: string;
27
+ }[];
28
+ label: string;
29
+ }[];
30
+ title: string;
31
+ type: string;
32
+ }, import("./analysis-figure.ts").EntityAnalysisFigureSchemaInput>>>>;
33
+ key: z.ZodString;
34
+ origin: z.ZodUnion<readonly [z.ZodEnum<{
35
+ AGENT: "AGENT";
36
+ USER: "USER";
37
+ }>, z.ZodString]> & {
38
+ enum: {
39
+ AGENT: "AGENT";
40
+ USER: "USER";
41
+ };
42
+ };
43
+ paragraph: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodType<{
44
+ label?: string | null | undefined;
45
+ text: string;
46
+ }, import("./analysis-paragraph.ts").EntityAnalysisParagraphSchemaInput, z.core.$ZodTypeInternals<{
47
+ label?: string | null | undefined;
48
+ text: string;
49
+ }, import("./analysis-paragraph.ts").EntityAnalysisParagraphSchemaInput>>>>>;
50
+ title: z.ZodString;
51
+ writerBrief: z.ZodOptional<z.ZodNullable<z.ZodObject<{
52
+ claim: z.ZodArray<z.ZodType<{
53
+ gateId?: string | null | undefined;
54
+ quote: string;
55
+ sourceUrl: string;
56
+ statement: string;
57
+ writerSurface?: string | null | undefined;
58
+ }, import("../research/finding.ts").ResearchFindingSchemaInput, z.core.$ZodTypeInternals<{
59
+ gateId?: string | null | undefined;
60
+ quote: string;
61
+ sourceUrl: string;
62
+ statement: string;
63
+ writerSurface?: string | null | undefined;
64
+ }, import("../research/finding.ts").ResearchFindingSchemaInput>>>;
65
+ metaAnalysis: z.ZodOptional<z.ZodObject<{
66
+ answer: z.ZodType<{
67
+ claim: number[];
68
+ statement: string;
69
+ }, import("../writer/judgment.ts").WriterJudgmentSchemaInput, z.core.$ZodTypeInternals<{
70
+ claim: number[];
71
+ statement: string;
72
+ }, import("../writer/judgment.ts").WriterJudgmentSchemaInput>>;
73
+ asOfDate: z.ZodISODate;
74
+ changeSignal: z.ZodArray<z.ZodType<{
75
+ claim: number[];
76
+ statement: string;
77
+ }, import("../writer/change-signal.ts").WriterChangeSignalSchemaInput, z.core.$ZodTypeInternals<{
78
+ claim: number[];
79
+ statement: string;
80
+ }, import("../writer/change-signal.ts").WriterChangeSignalSchemaInput>>>;
81
+ gap: z.ZodArray<z.ZodType<{
82
+ claim: number[];
83
+ reason: string;
84
+ statement: string;
85
+ }, import("../writer/gap.ts").WriterGapSchemaInput, z.core.$ZodTypeInternals<{
86
+ claim: number[];
87
+ reason: string;
88
+ statement: string;
89
+ }, import("../writer/gap.ts").WriterGapSchemaInput>>>;
90
+ question: z.ZodString;
91
+ scope: z.ZodType<{
92
+ boundary: string;
93
+ geography?: string | null | undefined;
94
+ period?: string | null | undefined;
95
+ }, import("../writer/scope.ts").WriterScopeSchemaInput, z.core.$ZodTypeInternals<{
96
+ boundary: string;
97
+ geography?: string | null | undefined;
98
+ period?: string | null | undefined;
99
+ }, import("../writer/scope.ts").WriterScopeSchemaInput>>;
100
+ section: z.ZodArray<z.ZodType<{
101
+ judgment: {
102
+ claim: number[];
103
+ statement: string;
104
+ };
105
+ label: string;
106
+ }, import("../writer/analysis-section.ts").WriterAnalysisSectionSchemaInput, z.core.$ZodTypeInternals<{
107
+ judgment: {
108
+ claim: number[];
109
+ statement: string;
110
+ };
111
+ label: string;
112
+ }, import("../writer/analysis-section.ts").WriterAnalysisSectionSchemaInput>>>;
113
+ }, z.core.$strip>>;
114
+ outputClaim: z.ZodOptional<z.ZodArray<z.ZodInt>>;
115
+ paragraph: z.ZodArray<z.ZodType<{
116
+ analysis?: {
117
+ answer: boolean;
118
+ section: string[];
119
+ } | undefined;
120
+ claim: number[];
121
+ positioning?: string[] | undefined;
122
+ }, import("../writer/paragraph.ts").WriterParagraphSchemaInput, z.core.$ZodTypeInternals<{
123
+ analysis?: {
124
+ answer: boolean;
125
+ section: string[];
126
+ } | undefined;
127
+ claim: number[];
128
+ positioning?: string[] | undefined;
129
+ }, import("../writer/paragraph.ts").WriterParagraphSchemaInput>>>;
130
+ positioning: z.ZodArray<z.ZodType<{
131
+ claim: number[];
132
+ element: string;
133
+ statement: string;
134
+ }, import("../writer/positioning.ts").WriterPositioningSchemaInput, z.core.$ZodTypeInternals<{
135
+ claim: number[];
136
+ element: string;
137
+ statement: string;
138
+ }, import("../writer/positioning.ts").WriterPositioningSchemaInput>>>;
139
+ }, z.core.$strip>>>;
140
+ }, z.core.$strip>;
141
+ type EntityAnalysisSectionMutationDefinition = z.infer<typeof EntityAnalysisSectionMutationSchemaDefinition>;
142
+ export interface EntityAnalysisSectionMutationSchemaInput extends z.input<typeof EntityAnalysisSectionMutationSchemaDefinition> {
143
+ }
144
+ /**
145
+ * Replace a private analysis section with paragraphs or a finished writer brief.
146
+ *
147
+ * @openapiSchema EntityAnalysisSectionMutation
148
+ * @endpoint PUT /v1/research-runs/{runId}/draft/sections/{sectionKey}
149
+ * @endpoint PUT /v1/research/runs/{runId}/draft/sections/{sectionKey}
150
+ * @contractShape entity.analysis-section-mutation
151
+ * @contractRole canonical
152
+ */
153
+ export declare const EntityAnalysisSectionMutationSchema: z.ZodType<EntityAnalysisSectionMutationDefinition, EntityAnalysisSectionMutationSchemaInput>;
154
+ export type EntityAnalysisSectionMutation = z.infer<typeof EntityAnalysisSectionMutationSchema>;
155
+ export {};
156
+ //# sourceMappingURL=analysis-section-mutation.d.ts.map
@@ -0,0 +1,34 @@
1
+ // LLM AGENTS MAY NOT EDIT THIS FILE UNDER ANY CIRCUMSTANCES. DO NOT EDIT - generated from Kotlin data classes via OpenAPI. Edit the backend owner and run: make docs-openapi && make docs-zod
2
+ import { z } from "zod/v4";
3
+ import { EntityAnalysisCitationSchema } from "./analysis-citation.js";
4
+ import { EntityAnalysisFigureSchema } from "./analysis-figure.js";
5
+ import { EntityAnalysisParagraphSchema } from "./analysis-paragraph.js";
6
+ import { EntityAnalysisSectionOriginSchema } from "./analysis-section-origin.js";
7
+ import { WriterBriefSchema } from "../writer/brief.js";
8
+ const EntityAnalysisSectionMutationSchemaDefinition = z.object({
9
+ /** Stored source documents and verbatim evidence quotes. */
10
+ citation: z.array(EntityAnalysisCitationSchema),
11
+ /** At most two figures grounded in the section's quotes; omit for no figures. */
12
+ figure: z.array(EntityAnalysisFigureSchema).optional(),
13
+ /** Exact research snippet typeValue, matching the section path key. */
14
+ key: z.string(),
15
+ /** Author hint; the server assigns origin from the credential. */
16
+ origin: EntityAnalysisSectionOriginSchema,
17
+ /** Catalog-ordered paragraphs; omit when supplying writerBrief. */
18
+ paragraph: z.array(EntityAnalysisParagraphSchema).nullish(),
19
+ /** Heading displayed above this section. */
20
+ title: z.string(),
21
+ /** Finished brief for the shared prose writer, supplied instead of paragraph. */
22
+ writerBrief: WriterBriefSchema.nullish(),
23
+ });
24
+ /**
25
+ * Replace a private analysis section with paragraphs or a finished writer brief.
26
+ *
27
+ * @openapiSchema EntityAnalysisSectionMutation
28
+ * @endpoint PUT /v1/research-runs/{runId}/draft/sections/{sectionKey}
29
+ * @endpoint PUT /v1/research/runs/{runId}/draft/sections/{sectionKey}
30
+ * @contractShape entity.analysis-section-mutation
31
+ * @contractRole canonical
32
+ */
33
+ export const EntityAnalysisSectionMutationSchema = EntityAnalysisSectionMutationSchemaDefinition;
34
+ //# sourceMappingURL=analysis-section-mutation.js.map
@@ -7,6 +7,7 @@ import { z } from "zod/v4";
7
7
  * @endpoint GET /v1/research/runs/{runId}/draft
8
8
  * @endpoint PUT /v1/research-runs/{runId}/draft/sections/{sectionKey}
9
9
  * @endpoint PUT /v1/research/runs/{runId}/draft/sections/{sectionKey}
10
+ * @usedBySchema EntityAnalysisSectionMutationSchema
10
11
  * @usedBySchema EntityAnalysisSectionSchema
11
12
  * @contractShape entity.analysis-section-origin
12
13
  * @contractRole canonical
@@ -9,6 +9,7 @@ const EntityAnalysisSectionOriginSchemaKnownMembers = z.enum(["AGENT", "USER"]);
9
9
  * @endpoint GET /v1/research/runs/{runId}/draft
10
10
  * @endpoint PUT /v1/research-runs/{runId}/draft/sections/{sectionKey}
11
11
  * @endpoint PUT /v1/research/runs/{runId}/draft/sections/{sectionKey}
12
+ * @usedBySchema EntityAnalysisSectionMutationSchema
12
13
  * @usedBySchema EntityAnalysisSectionSchema
13
14
  * @contractShape entity.analysis-section-origin
14
15
  * @contractRole canonical
@@ -18,6 +18,10 @@ declare const FederatedSearchSchemaDefinition: z.ZodObject<{
18
18
  }[];
19
19
  text: string;
20
20
  topic?: string | null | undefined;
21
+ webSource?: {
22
+ title: string;
23
+ url: string;
24
+ }[] | undefined;
21
25
  }[];
22
26
  relatedQuery: string[];
23
27
  shareable: boolean;
@@ -2520,6 +2524,10 @@ declare const FederatedSearchSchemaDefinition: z.ZodObject<{
2520
2524
  }[];
2521
2525
  text: string;
2522
2526
  topic?: string | null | undefined;
2527
+ webSource?: {
2528
+ title: string;
2529
+ url: string;
2530
+ }[] | undefined;
2523
2531
  }[];
2524
2532
  relatedQuery: string[];
2525
2533
  shareable: boolean;
@@ -20,6 +20,10 @@ declare const LinkSearchSchemaDefinition: z.ZodObject<{
20
20
  }[];
21
21
  text: string;
22
22
  topic?: string | null | undefined;
23
+ webSource?: {
24
+ title: string;
25
+ url: string;
26
+ }[] | undefined;
23
27
  }[];
24
28
  relatedQuery: string[];
25
29
  shareable: boolean;
@@ -5831,6 +5835,10 @@ declare const LinkSearchSchemaDefinition: z.ZodObject<{
5831
5835
  }[];
5832
5836
  text: string;
5833
5837
  topic?: string | null | undefined;
5838
+ webSource?: {
5839
+ title: string;
5840
+ url: string;
5841
+ }[] | undefined;
5834
5842
  }[];
5835
5843
  relatedQuery: string[];
5836
5844
  shareable: boolean;
@@ -25,6 +25,10 @@ declare const NaturalSearchResultSchemaDefinition: z.ZodObject<{
25
25
  }[];
26
26
  text: string;
27
27
  topic?: string | null | undefined;
28
+ webSource?: {
29
+ title: string;
30
+ url: string;
31
+ }[] | undefined;
28
32
  }, import("../search/answer-paragraph.ts").SearchAnswerParagraphSchemaInput, z.core.$ZodTypeInternals<{
29
33
  citation: {
30
34
  entityId: string;
@@ -33,6 +37,10 @@ declare const NaturalSearchResultSchemaDefinition: z.ZodObject<{
33
37
  }[];
34
38
  text: string;
35
39
  topic?: string | null | undefined;
40
+ webSource?: {
41
+ title: string;
42
+ url: string;
43
+ }[] | undefined;
36
44
  }, import("../search/answer-paragraph.ts").SearchAnswerParagraphSchemaInput>>>;
37
45
  relatedQuery: z.ZodArray<z.ZodString>;
38
46
  shareable: z.ZodBoolean;
@@ -346,6 +346,10 @@ export const OPENAPI_COMPONENT_MANIFEST = Object.freeze({
346
346
  modulePath: "entity/analysis-section",
347
347
  schemaName: "EntityAnalysisSectionSchema",
348
348
  },
349
+ EntityAnalysisSectionMutation: {
350
+ modulePath: "entity/analysis-section-mutation",
351
+ schemaName: "EntityAnalysisSectionMutationSchema",
352
+ },
349
353
  EntityAnalysisSectionOrigin: {
350
354
  modulePath: "entity/analysis-section-origin",
351
355
  schemaName: "EntityAnalysisSectionOriginSchema",
@@ -1046,6 +1050,10 @@ export const OPENAPI_COMPONENT_MANIFEST = Object.freeze({
1046
1050
  modulePath: "search/answer-paragraph",
1047
1051
  schemaName: "SearchAnswerParagraphSchema",
1048
1052
  },
1053
+ SearchAnswerWebSource: {
1054
+ modulePath: "search/answer-web-source",
1055
+ schemaName: "SearchAnswerWebSourceSchema",
1056
+ },
1049
1057
  SearchCacheMode: { modulePath: "search/cache-mode", schemaName: "SearchCacheModeSchema" },
1050
1058
  SearchDiscoveryFiling: {
1051
1059
  modulePath: "search/discovery-filing",
@@ -1198,9 +1206,36 @@ export const OPENAPI_COMPONENT_MANIFEST = Object.freeze({
1198
1206
  WebSearch: { modulePath: "web/search", schemaName: "WebSearchSchema" },
1199
1207
  WebSearchProvider: { modulePath: "web/search-provider", schemaName: "WebSearchProviderSchema" },
1200
1208
  WebSearchRecency: { modulePath: "web/search-recency", schemaName: "WebSearchRecencySchema" },
1209
+ WriterAnalysisSection: {
1210
+ modulePath: "writer/analysis-section",
1211
+ schemaName: "WriterAnalysisSectionSchema",
1212
+ },
1213
+ WriterBrief: { modulePath: "writer/brief", schemaName: "WriterBriefSchema" },
1214
+ WriterChangeSignal: {
1215
+ modulePath: "writer/change-signal",
1216
+ schemaName: "WriterChangeSignalSchema",
1217
+ },
1201
1218
  WriterClaimSurface: {
1202
1219
  modulePath: "writer/claim-surface",
1203
1220
  schemaName: "WriterClaimSurfaceSchema",
1204
1221
  },
1222
+ WriterGap: { modulePath: "writer/gap", schemaName: "WriterGapSchema" },
1223
+ WriterGapReason: { modulePath: "writer/gap-reason", schemaName: "WriterGapReasonSchema" },
1224
+ WriterJudgment: { modulePath: "writer/judgment", schemaName: "WriterJudgmentSchema" },
1225
+ WriterMetaAnalysis: {
1226
+ modulePath: "writer/meta-analysis",
1227
+ schemaName: "WriterMetaAnalysisSchema",
1228
+ },
1229
+ WriterParagraph: { modulePath: "writer/paragraph", schemaName: "WriterParagraphSchema" },
1230
+ WriterParagraphAnalysis: {
1231
+ modulePath: "writer/paragraph-analysis",
1232
+ schemaName: "WriterParagraphAnalysisSchema",
1233
+ },
1234
+ WriterPositioning: { modulePath: "writer/positioning", schemaName: "WriterPositioningSchema" },
1235
+ WriterPositioningElement: {
1236
+ modulePath: "writer/positioning-element",
1237
+ schemaName: "WriterPositioningElementSchema",
1238
+ },
1239
+ WriterScope: { modulePath: "writer/scope", schemaName: "WriterScopeSchema" },
1205
1240
  });
1206
1241
  //# sourceMappingURL=openapi-component-manifest.js.map
@@ -26,8 +26,11 @@ export interface ResearchFindingSchemaInput extends z.input<typeof ResearchFindi
26
26
  * @endpoint POST /v1/entities/{entityId}/enrichments
27
27
  * @endpoint POST /v1/research-runs
28
28
  * @endpoint POST /v1/research/runs
29
+ * @endpoint PUT /v1/research-runs/{runId}/draft/sections/{sectionKey}
30
+ * @endpoint PUT /v1/research/runs/{runId}/draft/sections/{sectionKey}
29
31
  * @usedBySchema EnrichmentPromptSchema
30
32
  * @usedBySchema HarnessRunCreateSchema
33
+ * @usedBySchema WriterBriefSchema
31
34
  * @contractShape research.finding
32
35
  * @contractRole canonical
33
36
  */
@@ -20,8 +20,11 @@ const ResearchFindingSchemaDefinition = z.object({
20
20
  * @endpoint POST /v1/entities/{entityId}/enrichments
21
21
  * @endpoint POST /v1/research-runs
22
22
  * @endpoint POST /v1/research/runs
23
+ * @endpoint PUT /v1/research-runs/{runId}/draft/sections/{sectionKey}
24
+ * @endpoint PUT /v1/research/runs/{runId}/draft/sections/{sectionKey}
23
25
  * @usedBySchema EnrichmentPromptSchema
24
26
  * @usedBySchema HarnessRunCreateSchema
27
+ * @usedBySchema WriterBriefSchema
25
28
  * @contractShape research.finding
26
29
  * @contractRole canonical
27
30
  */
@@ -11,6 +11,13 @@ declare const SearchAnswerParagraphSchemaDefinition: z.ZodObject<{
11
11
  }, import("./answer-citation.ts").SearchAnswerCitationSchemaInput>>>;
12
12
  text: z.ZodString;
13
13
  topic: z.ZodOptional<z.ZodNullable<z.ZodString>>;
14
+ webSource: z.ZodOptional<z.ZodArray<z.ZodType<{
15
+ title: string;
16
+ url: string;
17
+ }, import("./answer-web-source.ts").SearchAnswerWebSourceSchemaInput, z.core.$ZodTypeInternals<{
18
+ title: string;
19
+ url: string;
20
+ }, import("./answer-web-source.ts").SearchAnswerWebSourceSchemaInput>>>>;
14
21
  }, z.core.$strip>;
15
22
  type SearchAnswerParagraphDefinition = z.infer<typeof SearchAnswerParagraphSchemaDefinition>;
16
23
  export interface SearchAnswerParagraphSchemaInput extends z.input<typeof SearchAnswerParagraphSchemaDefinition> {
@@ -1,6 +1,7 @@
1
1
  // LLM AGENTS MAY NOT EDIT THIS FILE UNDER ANY CIRCUMSTANCES. DO NOT EDIT - generated from Kotlin data classes via OpenAPI. Edit the backend owner and run: make docs-openapi && make docs-zod
2
2
  import { z } from "zod/v4";
3
3
  import { SearchAnswerCitationSchema } from "./answer-citation.js";
4
+ import { SearchAnswerWebSourceSchema } from "./answer-web-source.js";
4
5
  const SearchAnswerParagraphSchemaDefinition = z.object({
5
6
  /** Evidence this paragraph rests on, most important first. */
6
7
  citation: z.array(SearchAnswerCitationSchema),
@@ -8,6 +9,8 @@ const SearchAnswerParagraphSchemaDefinition = z.object({
8
9
  text: z.string(),
9
10
  /** Short label naming the category, market, or segment this paragraph covers, such as "Smartphones · North America"; absent on the lead paragraph. */
10
11
  topic: z.string().nullish(),
12
+ /** Web pages this paragraph rests on that no aVenture record owns, such as an encyclopedia article about a company the directory lacks; most important first. Always sent; absent only from answers written before it existed. */
13
+ webSource: z.array(SearchAnswerWebSourceSchema).optional(),
11
14
  });
12
15
  /**
13
16
  * One paragraph of an answer and the evidence it rests on.
@@ -0,0 +1,27 @@
1
+ import { z } from "zod/v4";
2
+ declare const SearchAnswerWebSourceSchemaDefinition: z.ZodObject<{
3
+ title: z.ZodString;
4
+ url: z.ZodString;
5
+ }, z.core.$strip>;
6
+ type SearchAnswerWebSourceDefinition = z.infer<typeof SearchAnswerWebSourceSchemaDefinition>;
7
+ export interface SearchAnswerWebSourceSchemaInput extends z.input<typeof SearchAnswerWebSourceSchemaDefinition> {
8
+ }
9
+ /**
10
+ * A web search result an answer paragraph cites, by its page.
11
+ *
12
+ * @openapiSchema SearchAnswerWebSource
13
+ * @endpoint GET /v1/search/link
14
+ * @endpoint GET /v1/search/link/jobs/{jobId}
15
+ * @endpoint GET /v1/search/shared/{id}
16
+ * @endpoint GET /v1/search/shared/slug/{slug}
17
+ * @endpoint POST /v1/search
18
+ * @endpoint POST /v1/search/natural/entities
19
+ * @endpoint POST /v1/search/shared
20
+ * @usedBySchema SearchAnswerParagraphSchema
21
+ * @contractShape search.answer-web-source
22
+ * @contractRole canonical
23
+ */
24
+ export declare const SearchAnswerWebSourceSchema: z.ZodType<SearchAnswerWebSourceDefinition, SearchAnswerWebSourceSchemaInput>;
25
+ export type SearchAnswerWebSource = z.infer<typeof SearchAnswerWebSourceSchema>;
26
+ export {};
27
+ //# sourceMappingURL=answer-web-source.d.ts.map
@@ -0,0 +1,25 @@
1
+ // LLM AGENTS MAY NOT EDIT THIS FILE UNDER ANY CIRCUMSTANCES. DO NOT EDIT - generated from Kotlin data classes via OpenAPI. Edit the backend owner and run: make docs-openapi && make docs-zod
2
+ import { z } from "zod/v4";
3
+ const SearchAnswerWebSourceSchemaDefinition = z.object({
4
+ /** Title of the cited page as the search result named it. */
5
+ title: z.string(),
6
+ /** Address of the cited page. */
7
+ url: z.string(),
8
+ });
9
+ /**
10
+ * A web search result an answer paragraph cites, by its page.
11
+ *
12
+ * @openapiSchema SearchAnswerWebSource
13
+ * @endpoint GET /v1/search/link
14
+ * @endpoint GET /v1/search/link/jobs/{jobId}
15
+ * @endpoint GET /v1/search/shared/{id}
16
+ * @endpoint GET /v1/search/shared/slug/{slug}
17
+ * @endpoint POST /v1/search
18
+ * @endpoint POST /v1/search/natural/entities
19
+ * @endpoint POST /v1/search/shared
20
+ * @usedBySchema SearchAnswerParagraphSchema
21
+ * @contractShape search.answer-web-source
22
+ * @contractRole canonical
23
+ */
24
+ export const SearchAnswerWebSourceSchema = SearchAnswerWebSourceSchemaDefinition;
25
+ //# sourceMappingURL=answer-web-source.js.map
@@ -39,6 +39,10 @@ export declare const SearchAnswerSchema: z.ZodObject<{
39
39
  }[];
40
40
  text: string;
41
41
  topic?: string | null | undefined;
42
+ webSource?: {
43
+ title: string;
44
+ url: string;
45
+ }[] | undefined;
42
46
  }, import("./answer-paragraph.ts").SearchAnswerParagraphSchemaInput, z.core.$ZodTypeInternals<{
43
47
  citation: {
44
48
  entityId: string;
@@ -47,6 +51,10 @@ export declare const SearchAnswerSchema: z.ZodObject<{
47
51
  }[];
48
52
  text: string;
49
53
  topic?: string | null | undefined;
54
+ webSource?: {
55
+ title: string;
56
+ url: string;
57
+ }[] | undefined;
50
58
  }, import("./answer-paragraph.ts").SearchAnswerParagraphSchemaInput>>>;
51
59
  relatedQuery: z.ZodArray<z.ZodString>;
52
60
  shareable: z.ZodBoolean;
@@ -31,6 +31,10 @@ declare const SharedSearchSchemaDefinition: z.ZodObject<{
31
31
  }[];
32
32
  text: string;
33
33
  topic?: string | null | undefined;
34
+ webSource?: {
35
+ title: string;
36
+ url: string;
37
+ }[] | undefined;
34
38
  }[];
35
39
  relatedQuery: string[];
36
40
  shareable: boolean;
@@ -5842,6 +5846,10 @@ declare const SharedSearchSchemaDefinition: z.ZodObject<{
5842
5846
  }[];
5843
5847
  text: string;
5844
5848
  topic?: string | null | undefined;
5849
+ webSource?: {
5850
+ title: string;
5851
+ url: string;
5852
+ }[] | undefined;
5845
5853
  }[];
5846
5854
  relatedQuery: string[];
5847
5855
  shareable: boolean;
@@ -0,0 +1,28 @@
1
+ import { z } from "zod/v4";
2
+ declare const WriterAnalysisSectionSchemaDefinition: z.ZodObject<{
3
+ judgment: z.ZodType<{
4
+ claim: number[];
5
+ statement: string;
6
+ }, import("./judgment.ts").WriterJudgmentSchemaInput, z.core.$ZodTypeInternals<{
7
+ claim: number[];
8
+ statement: string;
9
+ }, import("./judgment.ts").WriterJudgmentSchemaInput>>;
10
+ label: z.ZodString;
11
+ }, z.core.$strip>;
12
+ type WriterAnalysisSectionDefinition = z.infer<typeof WriterAnalysisSectionSchemaDefinition>;
13
+ export interface WriterAnalysisSectionSchemaInput extends z.input<typeof WriterAnalysisSectionSchemaDefinition> {
14
+ }
15
+ /**
16
+ * One ordered framework judgment.
17
+ *
18
+ * @openapiSchema WriterAnalysisSection
19
+ * @endpoint PUT /v1/research-runs/{runId}/draft/sections/{sectionKey}
20
+ * @endpoint PUT /v1/research/runs/{runId}/draft/sections/{sectionKey}
21
+ * @usedBySchema WriterMetaAnalysisSchema
22
+ * @contractShape writer.analysis-section
23
+ * @contractRole canonical
24
+ */
25
+ export declare const WriterAnalysisSectionSchema: z.ZodType<WriterAnalysisSectionDefinition, WriterAnalysisSectionSchemaInput>;
26
+ export type WriterAnalysisSection = z.infer<typeof WriterAnalysisSectionSchema>;
27
+ export {};
28
+ //# sourceMappingURL=analysis-section.d.ts.map
@@ -0,0 +1,21 @@
1
+ // LLM AGENTS MAY NOT EDIT THIS FILE UNDER ANY CIRCUMSTANCES. DO NOT EDIT - generated from Kotlin data classes via OpenAPI. Edit the backend owner and run: make docs-openapi && make docs-zod
2
+ import { z } from "zod/v4";
3
+ import { WriterJudgmentSchema } from "./judgment.js";
4
+ const WriterAnalysisSectionSchemaDefinition = z.object({
5
+ /** Judgment for this section. */
6
+ judgment: WriterJudgmentSchema,
7
+ /** Skill-owned section label. */
8
+ label: z.string(),
9
+ });
10
+ /**
11
+ * One ordered framework judgment.
12
+ *
13
+ * @openapiSchema WriterAnalysisSection
14
+ * @endpoint PUT /v1/research-runs/{runId}/draft/sections/{sectionKey}
15
+ * @endpoint PUT /v1/research/runs/{runId}/draft/sections/{sectionKey}
16
+ * @usedBySchema WriterMetaAnalysisSchema
17
+ * @contractShape writer.analysis-section
18
+ * @contractRole canonical
19
+ */
20
+ export const WriterAnalysisSectionSchema = WriterAnalysisSectionSchemaDefinition;
21
+ //# sourceMappingURL=analysis-section.js.map