@aventurevc/api-schemas 0.8.275 → 0.8.277

package/dist/entity/enrichment.js

@@ -6,7 +6,7 @@ import { EntityFundingDetailSchema } from "./funding-detail.js";
 import { EntityTextBundleSchema } from "./text-bundle.js";
 import { EntityUrlLinkSchema } from "./url-link.js";
 const EntityEnrichmentSchemaDefinition = z.object({
-    /** Current addresses. Full-detail search carries only the headquarters row (headquartersAddressId); GET /v1/entities/{entityId}/addresses lists every row. */
+    /** Current addresses. List rows carry bounded current locations for named roles, identification evidence, and card display, not every office or association history. Single-detail reads retain all current locations and their association history. Full-detail search carries only the headquarters row (headquartersAddressId); GET /v1/entities/{entityId}/addresses lists every row. */
     address: z.array(AddressSchema),
     /** Entity classifications. Single-detail and full-detail batch reads include history; list, default batch, and similar-entity reads may return only current classifications. Use GET /v1/entities/{entityId}/classifications?includeInactive=true for the full history. */
     classification: EntityClassificationSchema,

package/dist/entity/list.d.ts

@@ -1180,7 +1180,7 @@ type EntityListDefinition = z.infer<typeof EntityListSchemaDefinition>;
 export interface EntityListSchemaInput extends z.input<typeof EntityListSchemaDefinition> {
 }
 /**
- * Narrow entity row for list and batch-list reads. Keeps core identity, enrichment, governed research detail, accelerator participation, and fundraise rounds while omitting detail-only relationship, newsArticle, person, sitemap, and research snippet sections. Classification enrichment is current-only on list rows; use the entity classifications subresource with includeInactive=true to audit historical joins.
+ * Narrow entity row for list and batch-list reads. Keeps core identity, enrichment, governed research detail, accelerator participation, and fundraise rounds while omitting detail-only relationship, newsArticle, person, sitemap, and research snippet sections. Classification enrichment is current-only on list rows; use the entity classifications subresource with includeInactive=true to audit historical joins. Addresses are bounded current-location samples, not a complete office inventory; use the entity addresses subresource to list every office and association.
  *
  * @openapiSchema EntityList
  * @endpoint GET /v1/entities

package/dist/entity/list.js

@@ -24,7 +24,7 @@ const EntityListSchemaDefinition = z.object({
     semanticMatch: ContentEmbeddingMatchSchema.nullish(),
 });
 /**
- * Narrow entity row for list and batch-list reads. Keeps core identity, enrichment, governed research detail, accelerator participation, and fundraise rounds while omitting detail-only relationship, newsArticle, person, sitemap, and research snippet sections. Classification enrichment is current-only on list rows; use the entity classifications subresource with includeInactive=true to audit historical joins.
+ * Narrow entity row for list and batch-list reads. Keeps core identity, enrichment, governed research detail, accelerator participation, and fundraise rounds while omitting detail-only relationship, newsArticle, person, sitemap, and research snippet sections. Classification enrichment is current-only on list rows; use the entity classifications subresource with includeInactive=true to audit historical joins. Addresses are bounded current-location samples, not a complete office inventory; use the entity addresses subresource to list every office and association.
  *
  * @openapiSchema EntityList
  * @endpoint GET /v1/entities

package/dist/http/problem-detail.js

@@ -139,7 +139,7 @@ const ProblemDetailSchemaDefinition = z.object({
             "news_similarity_embedding_unavailable",
             /** The web search provider is not configured for this environment. Agent action: stop; admin/ops must configure the provider key before this endpoint will succeed. */
             "search_provider_not_configured",
-            /** Search provider call failed. Agent action: inspect detail and source. Provider credential or credit refusals (401, 402, or 407) are terminal: restore the provider credential or credits before retrying. Other transient provider outages may be retried according to Retry-After. */
+            /** Search provider call failed. Agent action: inspect detail and source. Provider credential or credit refusals (401, 402, or 407) are terminal: restore the provider credential or credits before retrying. TERMINAL: every provider failed this query; record the outage, never resend. TRANSIENT: retry once per Retry-After. */
             "search_provider_error",
             /** aVenture stopped waiting for a web search the provider is still running; the search keeps running and its finished result is stored. Agent action: retry the same request, after retryAfterSeconds when present (also in the Retry-After header); this is not a provider failure. */
             "search_still_running",

package/dist/logo/accuracy-method.d.ts

@@ -0,0 +1,27 @@
+import { z } from "zod/v4";
+/**
+ * How a logo-accuracy outcome was reached
+ *
+ * @openapiSchema LogoAccuracyMethod
+ * @endpoint GET /v1/entities/{entityId}/logo
+ * @endpoint GET /v1/news/{newsId}/thumbnail
+ * @endpoint GET /v1/people/{personId}/photo
+ * @usedBySchema LogoAccuracySchema
+ * @contractShape logo.accuracy-method
+ * @contractRole canonical
+ */
+export declare const LogoAccuracyMethodSchema: z.ZodUnion<readonly [z.ZodEnum<{
+    OPERATOR_REVIEW: "OPERATOR_REVIEW";
+    PERCEPTUAL_HASH: "PERCEPTUAL_HASH";
+    REFERENCE_UNAVAILABLE: "REFERENCE_UNAVAILABLE";
+    VISION: "VISION";
+}>, z.ZodString]> & {
+    enum: {
+        OPERATOR_REVIEW: "OPERATOR_REVIEW";
+        PERCEPTUAL_HASH: "PERCEPTUAL_HASH";
+        REFERENCE_UNAVAILABLE: "REFERENCE_UNAVAILABLE";
+        VISION: "VISION";
+    };
+};
+export type LogoAccuracyMethod = z.infer<typeof LogoAccuracyMethodSchema>;
+//# sourceMappingURL=accuracy-method.d.ts.map

package/dist/logo/accuracy-method.js

@@ -0,0 +1,21 @@
+// 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
+import { z } from "zod/v4";
+const LogoAccuracyMethodSchemaKnownMembers = z.enum([
+    "PERCEPTUAL_HASH",
+    "VISION",
+    "OPERATOR_REVIEW",
+    "REFERENCE_UNAVAILABLE",
+]);
+/**
+ * How a logo-accuracy outcome was reached
+ *
+ * @openapiSchema LogoAccuracyMethod
+ * @endpoint GET /v1/entities/{entityId}/logo
+ * @endpoint GET /v1/news/{newsId}/thumbnail
+ * @endpoint GET /v1/people/{personId}/photo
+ * @usedBySchema LogoAccuracySchema
+ * @contractShape logo.accuracy-method
+ * @contractRole canonical
+ */
+export const LogoAccuracyMethodSchema = Object.assign(z.union([LogoAccuracyMethodSchemaKnownMembers, z.string()]), { enum: LogoAccuracyMethodSchemaKnownMembers.enum });
+//# sourceMappingURL=accuracy-method.js.map

package/dist/logo/accuracy.d.ts

@@ -17,12 +17,19 @@ export declare const LogoAccuracySchema: z.ZodObject<{
         LOW: "LOW";
         MEDIUM: "MEDIUM";
     }>;
-    method: z.ZodEnum<{
+    method: z.ZodUnion<readonly [z.ZodEnum<{
         OPERATOR_REVIEW: "OPERATOR_REVIEW";
         PERCEPTUAL_HASH: "PERCEPTUAL_HASH";
         REFERENCE_UNAVAILABLE: "REFERENCE_UNAVAILABLE";
         VISION: "VISION";
-    }>;
+    }>, z.ZodString]> & {
+        enum: {
+            OPERATOR_REVIEW: "OPERATOR_REVIEW";
+            PERCEPTUAL_HASH: "PERCEPTUAL_HASH";
+            REFERENCE_UNAVAILABLE: "REFERENCE_UNAVAILABLE";
+            VISION: "VISION";
+        };
+    };
     outcome: z.ZodEnum<{
         INSUFFICIENT: "INSUFFICIENT";
         MATCH: "MATCH";

package/dist/logo/accuracy.js

@@ -1,6 +1,7 @@
 // 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
 import { z } from "zod/v4";
 import { ConfidenceSchema } from "../confidence/confidence.js";
+import { LogoAccuracyMethodSchema } from "./accuracy-method.js";
 import { LogoAccuracyReferenceSchema } from "./accuracy-reference.js";
 /**
  * Read-only assessment of whether a stored logo/photo depicts the target's own brand, decided from visible features of the stored mark versus the target's own reference marks
@@ -19,7 +20,7 @@ export const LogoAccuracySchema = z.object({
     /** Confidence in the outcome */
     confidence: ConfidenceSchema,
     /** How the outcome was reached */
-    method: z.enum(["PERCEPTUAL_HASH", "VISION", "OPERATOR_REVIEW", "REFERENCE_UNAVAILABLE"]),
+    method: LogoAccuracyMethodSchema,
     /** Whether the candidate mark matches the target's own brand */
     outcome: z.enum(["MATCH", "MISMATCH", "INSUFFICIENT"]),
     /** Reference marks fetched from the target's own surfaces, each with its perceptual-hash distance to the candidate. The deciding deterministic distance is the smallest entry */

package/dist/lookup/job-mutation.d.ts

@@ -81,7 +81,7 @@ type LookupJobMutationDefinition = z.infer<typeof LookupJobMutationSchemaDefinit
 export interface LookupJobMutationSchemaInput extends z.input<typeof LookupJobMutationSchemaDefinition> {
 }
 /**
- * The article whose companies and people a lookup identifies. Send sourceUrl, sourceNewsId, or both; POST /v1/lookup/mentions also reads a recorded sourceDocumentId alone; lookup-only bulk jobs and POST /v1/lookup/mentions also accept mention instead. A job filed by Prefer: respond-async on GET /v1/lookup or POST /v1/entities/lookup carries that request's subject instead.
+ * The article whose companies and people a lookup identifies. Send sourceUrl, sourceNewsId, or both; POST /v1/lookup/mentions also reads a recorded sourceDocumentId alone; lookup-only bulk jobs and POST /v1/lookup/mentions also accept mention instead. A job filed by Prefer: respond-async on POST /v1/lookup with kind in the JSON body carries that request's subject instead.
  *
  * @openapiSchema LookupJobMutation
  * @endpoint GET /v1/lookup-jobs/{jobId}

package/dist/lookup/job-mutation.js

@@ -15,11 +15,11 @@ const LookupJobMutationSchemaDefinition = z.object({
     sourceNewsId: z.int().nullish(),
     /** URL of the article; read from aVenture news when stored there, otherwise fetched. */
     sourceUrl: z.string().max(2000).nullish(),
-    /** Read-only: the subject of a GET or POST /v1/lookup or POST /v1/entities/lookup request sent with Prefer: respond-async, rolled over from a signed-in live lookup, or handed off for pending filing. This job preserves the route's options. Requests to create a job or read mentions must omit it. */
+    /** Read-only: the subject of a POST /v1/lookup request with kind in the JSON body, sent with Prefer: respond-async, rolled over from a signed-in live lookup, or handed off for pending filing. This job preserves the route's options. Requests to create a job or read mentions must omit it. */
     subject: IdentificationSubjectSchema.nullish(),
 });
 /**
- * The article whose companies and people a lookup identifies. Send sourceUrl, sourceNewsId, or both; POST /v1/lookup/mentions also reads a recorded sourceDocumentId alone; lookup-only bulk jobs and POST /v1/lookup/mentions also accept mention instead. A job filed by Prefer: respond-async on GET /v1/lookup or POST /v1/entities/lookup carries that request's subject instead.
+ * The article whose companies and people a lookup identifies. Send sourceUrl, sourceNewsId, or both; POST /v1/lookup/mentions also reads a recorded sourceDocumentId alone; lookup-only bulk jobs and POST /v1/lookup/mentions also accept mention instead. A job filed by Prefer: respond-async on POST /v1/lookup with kind in the JSON body carries that request's subject instead.
  *
  * @openapiSchema LookupJobMutation
  * @endpoint GET /v1/lookup-jobs/{jobId}

package/dist/lookup/job.js

@@ -9,7 +9,7 @@ const LookupJobSchemaDefinition = z.object({
     createdAt: z.iso.datetime({ offset: true }),
     /** Why the job failed; absent unless state is FAILED. */
     failureReason: z.string().nullish(),
-    /** Subject jobs only: once COMPLETED, the identification GET or POST /v1/lookup or POST /v1/entities/lookup returns for source.subject, including requested filing and source-claim outcomes; absent otherwise. */
+    /** Subject jobs only: once COMPLETED, the identification returned for source.subject by POST /v1/lookup (kind in the JSON body), including requested filing and source-claim outcomes; absent otherwise. */
     identification: IdentificationSchema.nullish(),
     /** Lookup job id. */
     jobId: z.uuid(),

package/dist/media/upload.d.ts

@@ -7,12 +7,19 @@ declare const MediaUploadSchemaDefinition: z.ZodObject<{
             LOW: "LOW";
             MEDIUM: "MEDIUM";
         }>;
-        method: z.ZodEnum<{
+        method: z.ZodUnion<readonly [z.ZodEnum<{
             OPERATOR_REVIEW: "OPERATOR_REVIEW";
             PERCEPTUAL_HASH: "PERCEPTUAL_HASH";
             REFERENCE_UNAVAILABLE: "REFERENCE_UNAVAILABLE";
             VISION: "VISION";
-        }>;
+        }>, z.ZodString]> & {
+            enum: {
+                OPERATOR_REVIEW: "OPERATOR_REVIEW";
+                PERCEPTUAL_HASH: "PERCEPTUAL_HASH";
+                REFERENCE_UNAVAILABLE: "REFERENCE_UNAVAILABLE";
+                VISION: "VISION";
+            };
+        };
         outcome: z.ZodEnum<{
             INSUFFICIENT: "INSUFFICIENT";
             MATCH: "MATCH";

package/dist/openapi-component-manifest.js

@@ -739,6 +739,10 @@ export const OPENAPI_COMPONENT_MANIFEST = Object.freeze({
     JsonValue: { modulePath: "http/json-value", schemaName: "JsonValueSchema" },
     LinkSearch: { modulePath: "link/search", schemaName: "LinkSearchSchema" },
     LogoAccuracy: { modulePath: "logo/accuracy", schemaName: "LogoAccuracySchema" },
+    LogoAccuracyMethod: {
+        modulePath: "logo/accuracy-method",
+        schemaName: "LogoAccuracyMethodSchema",
+    },
     LogoAccuracyReference: {
         modulePath: "logo/accuracy-reference",
         schemaName: "LogoAccuracyReferenceSchema",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aventurevc/api-schemas",
-  "version": "0.8.275",
+  "version": "0.8.277",
   "private": false,
   "description": "Zod v4 schemas and TypeScript types for the aVenture API.",
   "license": "Apache-2.0",