@aventurevc/api-schemas 0.8.65 → 0.8.67

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.
@@ -5,8 +5,8 @@ const AgentHelpQuestionSchemaDefinition = z.object({
5
5
  /** Optional chat model that answers the question; null uses the configured default. A caller without admin authority may only choose an allowlisted model; an ineligible model is rejected with 422. Admin callers are unrestricted. */
6
6
  model: z.string().nullish(),
7
7
  /** The question to answer, in natural language. */
8
- question: z.string().min(1),
9
- /** True resolves the question to one runnable operation instead of answering it: the response carries a resolution (operation advice, clarify, or abstain) and no generated answer. Resolving calls no chat model, ignores model, and spends no help quota. */
8
+ question: z.string().max(2000),
9
+ /** True resolves the question to one runnable operation instead of answering it: the response carries a resolution (operation advice, clarify, or abstain) and no generated answer. Resolving calls no chat model, ignores model, and draws on its own per-caller limit instead of the answer quota. */
10
10
  resolve: z.boolean().optional(),
11
11
  /** Optional scope restricting which operations the answer may recommend; null means all. */
12
12
  scope: HelpScopeSchema.nullish(),
@@ -162,11 +162,11 @@ declare const EntityNaturalSearchSchemaDefinition: z.ZodObject<{
162
162
  }, unknown>>>>;
163
163
  }, z.core.$strict>>;
164
164
  search: z.ZodType<{
165
- mode?: "auto" | "exact" | "keyword" | "natural" | "semantic" | undefined;
165
+ mode?: string | undefined;
166
166
  model?: string | null | undefined;
167
167
  query: string;
168
168
  }, unknown, z.core.$ZodTypeInternals<{
169
- mode?: "auto" | "exact" | "keyword" | "natural" | "semantic" | undefined;
169
+ mode?: string | undefined;
170
170
  model?: string | null | undefined;
171
171
  query: string;
172
172
  }, unknown>>;
@@ -1,25 +1,25 @@
1
1
  import { z } from "zod/v4";
2
2
  declare const FederatedSearchProvenanceSchemaDefinition: z.ZodObject<{
3
3
  entity: z.ZodType<{
4
- modeRequested: "auto" | "exact" | "keyword" | "natural" | "semantic";
5
- modeUsed: "auto" | "exact" | "keyword" | "natural" | "semantic";
4
+ modeRequested: string;
5
+ modeUsed: string;
6
6
  }, unknown, z.core.$ZodTypeInternals<{
7
- modeRequested: "auto" | "exact" | "keyword" | "natural" | "semantic";
8
- modeUsed: "auto" | "exact" | "keyword" | "natural" | "semantic";
7
+ modeRequested: string;
8
+ modeUsed: string;
9
9
  }, unknown>>;
10
10
  news: z.ZodType<{
11
- modeRequested: "auto" | "exact" | "keyword" | "natural" | "semantic";
12
- modeUsed: "auto" | "exact" | "keyword" | "natural" | "semantic";
11
+ modeRequested: string;
12
+ modeUsed: string;
13
13
  }, unknown, z.core.$ZodTypeInternals<{
14
- modeRequested: "auto" | "exact" | "keyword" | "natural" | "semantic";
15
- modeUsed: "auto" | "exact" | "keyword" | "natural" | "semantic";
14
+ modeRequested: string;
15
+ modeUsed: string;
16
16
  }, unknown>>;
17
17
  person: z.ZodType<{
18
- modeRequested: "auto" | "exact" | "keyword" | "natural" | "semantic";
19
- modeUsed: "auto" | "exact" | "keyword" | "natural" | "semantic";
18
+ modeRequested: string;
19
+ modeUsed: string;
20
20
  }, unknown, z.core.$ZodTypeInternals<{
21
- modeRequested: "auto" | "exact" | "keyword" | "natural" | "semantic";
22
- modeUsed: "auto" | "exact" | "keyword" | "natural" | "semantic";
21
+ modeRequested: string;
22
+ modeUsed: string;
23
23
  }, unknown>>;
24
24
  }, z.core.$strip>;
25
25
  type FederatedSearchProvenanceDefinition = z.infer<typeof FederatedSearchProvenanceSchemaDefinition>;
@@ -13,8 +13,8 @@ declare const FederatedSearchSchemaDefinition: z.ZodObject<{
13
13
  interpretation: {
14
14
  confidence: "HIGH" | "LOW" | "MEDIUM";
15
15
  execution: {
16
- modeRequested: "auto" | "exact" | "keyword" | "natural" | "semantic";
17
- modeUsed: "auto" | "exact" | "keyword" | "natural" | "semantic";
16
+ modeRequested: string;
17
+ modeUsed: string;
18
18
  };
19
19
  fallbackUsed: boolean;
20
20
  filter: {
@@ -2076,8 +2076,8 @@ declare const FederatedSearchSchemaDefinition: z.ZodObject<{
2076
2076
  interpretation: {
2077
2077
  confidence: "HIGH" | "LOW" | "MEDIUM";
2078
2078
  execution: {
2079
- modeRequested: "auto" | "exact" | "keyword" | "natural" | "semantic";
2080
- modeUsed: "auto" | "exact" | "keyword" | "natural" | "semantic";
2079
+ modeRequested: string;
2080
+ modeUsed: string;
2081
2081
  };
2082
2082
  fallbackUsed: boolean;
2083
2083
  filter: {
@@ -4172,8 +4172,8 @@ declare const FederatedSearchSchemaDefinition: z.ZodObject<{
4172
4172
  interpretation: {
4173
4173
  confidence: "HIGH" | "LOW" | "MEDIUM";
4174
4174
  execution: {
4175
- modeRequested: "auto" | "exact" | "keyword" | "natural" | "semantic";
4176
- modeUsed: "auto" | "exact" | "keyword" | "natural" | "semantic";
4175
+ modeRequested: string;
4176
+ modeUsed: string;
4177
4177
  };
4178
4178
  fallbackUsed: boolean;
4179
4179
  filter: {
@@ -4294,8 +4294,8 @@ declare const FederatedSearchSchemaDefinition: z.ZodObject<{
4294
4294
  interpretation: {
4295
4295
  confidence: "HIGH" | "LOW" | "MEDIUM";
4296
4296
  execution: {
4297
- modeRequested: "auto" | "exact" | "keyword" | "natural" | "semantic";
4298
- modeUsed: "auto" | "exact" | "keyword" | "natural" | "semantic";
4297
+ modeRequested: string;
4298
+ modeUsed: string;
4299
4299
  };
4300
4300
  fallbackUsed: boolean;
4301
4301
  filter: {
@@ -4415,29 +4415,29 @@ declare const FederatedSearchSchemaDefinition: z.ZodObject<{
4415
4415
  }, unknown>>;
4416
4416
  provenance: z.ZodType<{
4417
4417
  entity: {
4418
- modeRequested: "auto" | "exact" | "keyword" | "natural" | "semantic";
4419
- modeUsed: "auto" | "exact" | "keyword" | "natural" | "semantic";
4418
+ modeRequested: string;
4419
+ modeUsed: string;
4420
4420
  };
4421
4421
  news: {
4422
- modeRequested: "auto" | "exact" | "keyword" | "natural" | "semantic";
4423
- modeUsed: "auto" | "exact" | "keyword" | "natural" | "semantic";
4422
+ modeRequested: string;
4423
+ modeUsed: string;
4424
4424
  };
4425
4425
  person: {
4426
- modeRequested: "auto" | "exact" | "keyword" | "natural" | "semantic";
4427
- modeUsed: "auto" | "exact" | "keyword" | "natural" | "semantic";
4426
+ modeRequested: string;
4427
+ modeUsed: string;
4428
4428
  };
4429
4429
  }, unknown, z.core.$ZodTypeInternals<{
4430
4430
  entity: {
4431
- modeRequested: "auto" | "exact" | "keyword" | "natural" | "semantic";
4432
- modeUsed: "auto" | "exact" | "keyword" | "natural" | "semantic";
4431
+ modeRequested: string;
4432
+ modeUsed: string;
4433
4433
  };
4434
4434
  news: {
4435
- modeRequested: "auto" | "exact" | "keyword" | "natural" | "semantic";
4436
- modeUsed: "auto" | "exact" | "keyword" | "natural" | "semantic";
4435
+ modeRequested: string;
4436
+ modeUsed: string;
4437
4437
  };
4438
4438
  person: {
4439
- modeRequested: "auto" | "exact" | "keyword" | "natural" | "semantic";
4440
- modeUsed: "auto" | "exact" | "keyword" | "natural" | "semantic";
4439
+ modeRequested: string;
4440
+ modeUsed: string;
4441
4441
  };
4442
4442
  }, unknown>>;
4443
4443
  }, z.core.$strip>;
@@ -15,8 +15,8 @@ declare const LinkSearchSchemaDefinition: z.ZodObject<{
15
15
  interpretation: {
16
16
  confidence: "HIGH" | "LOW" | "MEDIUM";
17
17
  execution: {
18
- modeRequested: "auto" | "exact" | "keyword" | "natural" | "semantic";
19
- modeUsed: "auto" | "exact" | "keyword" | "natural" | "semantic";
18
+ modeRequested: string;
19
+ modeUsed: string;
20
20
  };
21
21
  fallbackUsed: boolean;
22
22
  filter: {
@@ -2091,8 +2091,8 @@ declare const LinkSearchSchemaDefinition: z.ZodObject<{
2091
2091
  interpretation: {
2092
2092
  confidence: "HIGH" | "LOW" | "MEDIUM";
2093
2093
  execution: {
2094
- modeRequested: "auto" | "exact" | "keyword" | "natural" | "semantic";
2095
- modeUsed: "auto" | "exact" | "keyword" | "natural" | "semantic";
2094
+ modeRequested: string;
2095
+ modeUsed: string;
2096
2096
  };
2097
2097
  fallbackUsed: boolean;
2098
2098
  filter: {
@@ -2212,16 +2212,16 @@ declare const LinkSearchSchemaDefinition: z.ZodObject<{
2212
2212
  };
2213
2213
  provenance: {
2214
2214
  entity: {
2215
- modeRequested: "auto" | "exact" | "keyword" | "natural" | "semantic";
2216
- modeUsed: "auto" | "exact" | "keyword" | "natural" | "semantic";
2215
+ modeRequested: string;
2216
+ modeUsed: string;
2217
2217
  };
2218
2218
  news: {
2219
- modeRequested: "auto" | "exact" | "keyword" | "natural" | "semantic";
2220
- modeUsed: "auto" | "exact" | "keyword" | "natural" | "semantic";
2219
+ modeRequested: string;
2220
+ modeUsed: string;
2221
2221
  };
2222
2222
  person: {
2223
- modeRequested: "auto" | "exact" | "keyword" | "natural" | "semantic";
2224
- modeUsed: "auto" | "exact" | "keyword" | "natural" | "semantic";
2223
+ modeRequested: string;
2224
+ modeUsed: string;
2225
2225
  };
2226
2226
  };
2227
2227
  }, unknown, z.core.$ZodTypeInternals<{
@@ -2238,8 +2238,8 @@ declare const LinkSearchSchemaDefinition: z.ZodObject<{
2238
2238
  interpretation: {
2239
2239
  confidence: "HIGH" | "LOW" | "MEDIUM";
2240
2240
  execution: {
2241
- modeRequested: "auto" | "exact" | "keyword" | "natural" | "semantic";
2242
- modeUsed: "auto" | "exact" | "keyword" | "natural" | "semantic";
2241
+ modeRequested: string;
2242
+ modeUsed: string;
2243
2243
  };
2244
2244
  fallbackUsed: boolean;
2245
2245
  filter: {
@@ -4314,8 +4314,8 @@ declare const LinkSearchSchemaDefinition: z.ZodObject<{
4314
4314
  interpretation: {
4315
4315
  confidence: "HIGH" | "LOW" | "MEDIUM";
4316
4316
  execution: {
4317
- modeRequested: "auto" | "exact" | "keyword" | "natural" | "semantic";
4318
- modeUsed: "auto" | "exact" | "keyword" | "natural" | "semantic";
4317
+ modeRequested: string;
4318
+ modeUsed: string;
4319
4319
  };
4320
4320
  fallbackUsed: boolean;
4321
4321
  filter: {
@@ -4435,16 +4435,16 @@ declare const LinkSearchSchemaDefinition: z.ZodObject<{
4435
4435
  };
4436
4436
  provenance: {
4437
4437
  entity: {
4438
- modeRequested: "auto" | "exact" | "keyword" | "natural" | "semantic";
4439
- modeUsed: "auto" | "exact" | "keyword" | "natural" | "semantic";
4438
+ modeRequested: string;
4439
+ modeUsed: string;
4440
4440
  };
4441
4441
  news: {
4442
- modeRequested: "auto" | "exact" | "keyword" | "natural" | "semantic";
4443
- modeUsed: "auto" | "exact" | "keyword" | "natural" | "semantic";
4442
+ modeRequested: string;
4443
+ modeUsed: string;
4444
4444
  };
4445
4445
  person: {
4446
- modeRequested: "auto" | "exact" | "keyword" | "natural" | "semantic";
4447
- modeUsed: "auto" | "exact" | "keyword" | "natural" | "semantic";
4446
+ modeRequested: string;
4447
+ modeUsed: string;
4448
4448
  };
4449
4449
  };
4450
4450
  }, unknown>>;
@@ -20,8 +20,8 @@ declare const NaturalSearchResultSchemaDefinition: z.ZodObject<{
20
20
  interpretation: z.ZodType<{
21
21
  confidence: "HIGH" | "LOW" | "MEDIUM";
22
22
  execution: {
23
- modeRequested: "auto" | "exact" | "keyword" | "natural" | "semantic";
24
- modeUsed: "auto" | "exact" | "keyword" | "natural" | "semantic";
23
+ modeRequested: string;
24
+ modeUsed: string;
25
25
  };
26
26
  fallbackUsed: boolean;
27
27
  filter: {
@@ -137,8 +137,8 @@ declare const NaturalSearchResultSchemaDefinition: z.ZodObject<{
137
137
  }, unknown, z.core.$ZodTypeInternals<{
138
138
  confidence: "HIGH" | "LOW" | "MEDIUM";
139
139
  execution: {
140
- modeRequested: "auto" | "exact" | "keyword" | "natural" | "semantic";
141
- modeUsed: "auto" | "exact" | "keyword" | "natural" | "semantic";
140
+ modeRequested: string;
141
+ modeUsed: string;
142
142
  };
143
143
  fallbackUsed: boolean;
144
144
  filter: {
@@ -1,12 +1,6 @@
1
1
  import { z } from "zod/v4";
2
2
  declare const NaturalSearchSchemaDefinition: z.ZodObject<{
3
- mode: z.ZodOptional<z.ZodDefault<z.ZodEnum<{
4
- auto: "auto";
5
- exact: "exact";
6
- keyword: "keyword";
7
- natural: "natural";
8
- semantic: "semantic";
9
- }>>>;
3
+ mode: z.ZodOptional<z.ZodDefault<z.ZodType<string, unknown, z.core.$ZodTypeInternals<string, unknown>>>>;
10
4
  model: z.ZodOptional<z.ZodNullable<z.ZodString>>;
11
5
  query: z.ZodString;
12
6
  }, z.core.$strip>;
@@ -3,8 +3,8 @@ declare const PersonNaturalSearchResultSchemaDefinition: z.ZodObject<{
3
3
  interpretation: z.ZodType<{
4
4
  confidence: "HIGH" | "LOW" | "MEDIUM";
5
5
  execution: {
6
- modeRequested: "auto" | "exact" | "keyword" | "natural" | "semantic";
7
- modeUsed: "auto" | "exact" | "keyword" | "natural" | "semantic";
6
+ modeRequested: string;
7
+ modeUsed: string;
8
8
  };
9
9
  fallbackUsed: boolean;
10
10
  filter: {
@@ -76,8 +76,8 @@ declare const PersonNaturalSearchResultSchemaDefinition: z.ZodObject<{
76
76
  }, unknown, z.core.$ZodTypeInternals<{
77
77
  confidence: "HIGH" | "LOW" | "MEDIUM";
78
78
  execution: {
79
- modeRequested: "auto" | "exact" | "keyword" | "natural" | "semantic";
80
- modeUsed: "auto" | "exact" | "keyword" | "natural" | "semantic";
79
+ modeRequested: string;
80
+ modeUsed: string;
81
81
  };
82
82
  fallbackUsed: boolean;
83
83
  filter: {
@@ -92,11 +92,11 @@ declare const PersonNaturalSearchSchemaDefinition: z.ZodObject<{
92
92
  status: z.ZodOptional<z.ZodNullable<z.ZodString>>;
93
93
  }, z.core.$strip>>;
94
94
  search: z.ZodType<{
95
- mode?: "auto" | "exact" | "keyword" | "natural" | "semantic" | undefined;
95
+ mode?: string | undefined;
96
96
  model?: string | null | undefined;
97
97
  query: string;
98
98
  }, unknown, z.core.$ZodTypeInternals<{
99
- mode?: "auto" | "exact" | "keyword" | "natural" | "semantic" | undefined;
99
+ mode?: string | undefined;
100
100
  model?: string | null | undefined;
101
101
  query: string;
102
102
  }, unknown>>;
@@ -6,11 +6,11 @@ declare const PersonSearchInterpretationSchemaDefinition: z.ZodObject<{
6
6
  MEDIUM: "MEDIUM";
7
7
  }>;
8
8
  execution: z.ZodType<{
9
- modeRequested: "auto" | "exact" | "keyword" | "natural" | "semantic";
10
- modeUsed: "auto" | "exact" | "keyword" | "natural" | "semantic";
9
+ modeRequested: string;
10
+ modeUsed: string;
11
11
  }, unknown, z.core.$ZodTypeInternals<{
12
- modeRequested: "auto" | "exact" | "keyword" | "natural" | "semantic";
13
- modeUsed: "auto" | "exact" | "keyword" | "natural" | "semantic";
12
+ modeRequested: string;
13
+ modeUsed: string;
14
14
  }, unknown>>;
15
15
  fallbackUsed: z.ZodBoolean;
16
16
  filter: z.ZodObject<{
@@ -6,11 +6,11 @@ declare const SearchInterpretationSchemaDefinition: z.ZodObject<{
6
6
  MEDIUM: "MEDIUM";
7
7
  }>;
8
8
  execution: z.ZodType<{
9
- modeRequested: "auto" | "exact" | "keyword" | "natural" | "semantic";
10
- modeUsed: "auto" | "exact" | "keyword" | "natural" | "semantic";
9
+ modeRequested: string;
10
+ modeUsed: string;
11
11
  }, unknown, z.core.$ZodTypeInternals<{
12
- modeRequested: "auto" | "exact" | "keyword" | "natural" | "semantic";
13
- modeUsed: "auto" | "exact" | "keyword" | "natural" | "semantic";
12
+ modeRequested: string;
13
+ modeUsed: string;
14
14
  }, unknown>>;
15
15
  fallbackUsed: z.ZodBoolean;
16
16
  filter: z.ZodType<{
@@ -1,19 +1,7 @@
1
1
  import { z } from "zod/v4";
2
2
  declare const SearchModeExecutionSchemaDefinition: z.ZodObject<{
3
- modeRequested: z.ZodEnum<{
4
- auto: "auto";
5
- exact: "exact";
6
- keyword: "keyword";
7
- natural: "natural";
8
- semantic: "semantic";
9
- }>;
10
- modeUsed: z.ZodEnum<{
11
- auto: "auto";
12
- exact: "exact";
13
- keyword: "keyword";
14
- natural: "natural";
15
- semantic: "semantic";
16
- }>;
3
+ modeRequested: z.ZodType<string, unknown, z.core.$ZodTypeInternals<string, unknown>>;
4
+ modeUsed: z.ZodType<string, unknown, z.core.$ZodTypeInternals<string, unknown>>;
17
5
  }, z.core.$strip>;
18
6
  type SearchModeExecutionDefinition = z.infer<typeof SearchModeExecutionSchemaDefinition>;
19
7
  /**
@@ -1,4 +1,12 @@
1
1
  import { z } from "zod/v4";
2
+ declare const SearchModeSchemaDefinition: z.ZodUnion<readonly [z.ZodEnum<{
3
+ auto: "auto";
4
+ exact: "exact";
5
+ keyword: "keyword";
6
+ natural: "natural";
7
+ semantic: "semantic";
8
+ }>, z.ZodString]>;
9
+ type SearchModeDefinition = z.infer<typeof SearchModeSchemaDefinition>;
2
10
  /**
3
11
  * Search strategy for a natural-language search request. `auto` keeps the server pipeline (exact-name shortcut first, planner otherwise); `exact` matches entity or person names exactly with no planner and no embedding; `keyword` runs full-text search; `semantic` runs vector similarity; `natural` always runs the language-model planner. Entity and person natural-search support every mode; news and federated search accept only `auto` and `keyword`; content search accepts `auto` (topic, type, relation, and year words become filters and any other words rank by full text), `keyword` (the full text of articles, posts, and fetched pages), and `semantic` (one entity's or person's library pages by vector similarity of their fetched bodies).
4
12
  *
@@ -15,12 +23,7 @@ import { z } from "zod/v4";
15
23
  * @contractShape search.mode
16
24
  * @contractRole canonical
17
25
  */
18
- export declare const SearchModeSchema: z.ZodEnum<{
19
- auto: "auto";
20
- exact: "exact";
21
- keyword: "keyword";
22
- natural: "natural";
23
- semantic: "semantic";
24
- }>;
26
+ export declare const SearchModeSchema: z.ZodType<SearchModeDefinition>;
25
27
  export type SearchMode = z.infer<typeof SearchModeSchema>;
28
+ export {};
26
29
  //# sourceMappingURL=mode.d.ts.map
@@ -1,5 +1,9 @@
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
+ const SearchModeSchemaDefinition = z.union([
4
+ z.enum(["auto", "exact", "keyword", "semantic", "natural"]),
5
+ z.string(),
6
+ ]);
3
7
  /**
4
8
  * Search strategy for a natural-language search request. `auto` keeps the server pipeline (exact-name shortcut first, planner otherwise); `exact` matches entity or person names exactly with no planner and no embedding; `keyword` runs full-text search; `semantic` runs vector similarity; `natural` always runs the language-model planner. Entity and person natural-search support every mode; news and federated search accept only `auto` and `keyword`; content search accepts `auto` (topic, type, relation, and year words become filters and any other words rank by full text), `keyword` (the full text of articles, posts, and fetched pages), and `semantic` (one entity's or person's library pages by vector similarity of their fetched bodies).
5
9
  *
@@ -16,5 +20,5 @@ import { z } from "zod/v4";
16
20
  * @contractShape search.mode
17
21
  * @contractRole canonical
18
22
  */
19
- export const SearchModeSchema = z.enum(["auto", "exact", "keyword", "semantic", "natural"]);
23
+ export const SearchModeSchema = SearchModeSchemaDefinition;
20
24
  //# sourceMappingURL=mode.js.map
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@aventurevc/api-schemas",
3
- "version": "0.8.65",
3
+ "version": "0.8.67",
4
4
  "private": false,
5
5
  "description": "Zod v4 schemas and TypeScript types for the aVenture API.",
6
6
  "license": "Apache-2.0",