@aventurevc/api-schemas 0.8.20 → 0.8.22

package/dist/confidence/confidence.d.ts

@@ -4,6 +4,9 @@ import { z } from "zod/v4";
  *
  * @openapiSchema Confidence
  * @endpoint GET /v1/search/link
+ * @endpoint GET /v1/entities/{entityId}/logo
+ * @endpoint GET /v1/news/{newsId}/thumbnail
+ * @endpoint GET /v1/people/{personId}/photo
  * @endpoint POST /v1/agents/help
  * @endpoint POST /v1/entities/natural-search
  * @endpoint POST /v1/help
@@ -13,6 +16,7 @@ import { z } from "zod/v4";
  * @endpoint POST /v1/search/natural/entities
  * @endpoint POST /v1/search/natural/people
  * @usedBySchema AgentHelpSchema
+ * @usedBySchema LogoAccuracySchema
  * @usedBySchema PersonSearchInterpretationSchema
  * @usedBySchema SearchInterpretationSchema
  * @contractShape confidence.confidence

package/dist/confidence/confidence.js

@@ -5,6 +5,9 @@ import { z } from "zod/v4";
  *
  * @openapiSchema Confidence
  * @endpoint GET /v1/search/link
+ * @endpoint GET /v1/entities/{entityId}/logo
+ * @endpoint GET /v1/news/{newsId}/thumbnail
+ * @endpoint GET /v1/people/{personId}/photo
  * @endpoint POST /v1/agents/help
  * @endpoint POST /v1/entities/natural-search
  * @endpoint POST /v1/help
@@ -14,6 +17,7 @@ import { z } from "zod/v4";
  * @endpoint POST /v1/search/natural/entities
  * @endpoint POST /v1/search/natural/people
  * @usedBySchema AgentHelpSchema
+ * @usedBySchema LogoAccuracySchema
  * @usedBySchema PersonSearchInterpretationSchema
  * @usedBySchema SearchInterpretationSchema
  * @contractShape confidence.confidence

package/dist/datasource/provenance-actor-type.d.ts

@@ -0,0 +1,15 @@
+import { z } from "zod/v4";
+/**
+ * Actor boundary for a provenance write event
+ *
+ * @openapiSchema DatasourceProvenanceActorType
+ * @endpoint POST /v1/web/search
+ * @contractShape datasource.provenance-actor-type
+ * @contractRole canonical
+ */
+export declare const DatasourceProvenanceActorTypeSchema: z.ZodEnum<{
+    agent: "agent";
+    employee: "employee";
+}>;
+export type DatasourceProvenanceActorType = z.infer<typeof DatasourceProvenanceActorTypeSchema>;
+//# sourceMappingURL=provenance-actor-type.d.ts.map

package/dist/datasource/provenance-actor-type.js

@@ -0,0 +1,12 @@
+// 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";
+/**
+ * Actor boundary for a provenance write event
+ *
+ * @openapiSchema DatasourceProvenanceActorType
+ * @endpoint POST /v1/web/search
+ * @contractShape datasource.provenance-actor-type
+ * @contractRole canonical
+ */
+export const DatasourceProvenanceActorTypeSchema = z.enum(["agent", "employee"]);
+//# sourceMappingURL=provenance-actor-type.js.map

package/dist/datasource/source-metadata.d.ts

@@ -3,9 +3,10 @@ import { z } from "zod/v4";
  * Grouped source/provenance metadata for private v1 response fields
  *
  * @openapiSchema DatasourceSourceMetadata
- * @endpoint GET /v1/entities/{entityId}/media/{mediaType}
- * @endpoint GET /v1/news/{newsId}/media/{mediaType}
- * @endpoint GET /v1/people/{personId}/media/{mediaType}
+ * @endpoint GET /v1/entities/{entityId}/logo
+ * @endpoint GET /v1/news/{newsId}/thumbnail
+ * @endpoint GET /v1/people/{personId}/photo
+ * @usedBySchema LogoAccuracySchema
  * @usedBySchema MediaUploadSchema
  * @contractShape datasource.source-metadata
  * @contractRole canonical

package/dist/datasource/source-metadata.js

@@ -4,9 +4,10 @@ import { z } from "zod/v4";
  * Grouped source/provenance metadata for private v1 response fields
  *
  * @openapiSchema DatasourceSourceMetadata
- * @endpoint GET /v1/entities/{entityId}/media/{mediaType}
- * @endpoint GET /v1/news/{newsId}/media/{mediaType}
- * @endpoint GET /v1/people/{personId}/media/{mediaType}
+ * @endpoint GET /v1/entities/{entityId}/logo
+ * @endpoint GET /v1/news/{newsId}/thumbnail
+ * @endpoint GET /v1/people/{personId}/photo
+ * @usedBySchema LogoAccuracySchema
  * @usedBySchema MediaUploadSchema
  * @contractShape datasource.source-metadata
  * @contractRole canonical

package/dist/entity/filter-search.d.ts

@@ -150,10 +150,10 @@ declare const EntityFilterSearchSchemaDefinition: z.ZodObject<{
         typeTechnologyUsed: z.ZodOptional<z.ZodArray<z.ZodString>>;
         url: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         urlDomain: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-        urlMatchMode: z.ZodOptional<z.ZodEnum<{
+        urlMatchMode: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
             domain: "domain";
             hostPath: "hostPath";
-        }>>;
+        }>>>;
         urlType: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
             alternativeto: "alternativeto";
             angellist: "angellist";

package/dist/entity/filter.d.ts

@@ -159,10 +159,10 @@ export declare const EntityFilterSchema: z.ZodObject<{
     typeTechnologyUsed: z.ZodOptional<z.ZodArray<z.ZodString>>;
     url: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     urlDomain: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    urlMatchMode: z.ZodOptional<z.ZodEnum<{
+    urlMatchMode: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
         domain: "domain";
         hostPath: "hostPath";
-    }>>;
+    }>>>;
     urlType: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
         alternativeto: "alternativeto";
         angellist: "angellist";

package/dist/entity/filter.js

@@ -105,8 +105,8 @@ export const EntityFilterSchema = z.strictObject({
     url: z.string().nullish(),
     /** Current root domain to match when urlMatchMode=domain. */
     urlDomain: z.string().nullish(),
-    /** URL matching mode: hostPath uses host and path; domain uses the root domain. */
-    urlMatchMode: UrlMatchModeSchema.optional(),
+    /** URL matching mode: hostPath uses host and path; domain uses the root domain. Omitted, it is domain when urlDomain is set, else hostPath. */
+    urlMatchMode: UrlMatchModeSchema.nullish(),
     /** Restrict URL matching to one URL type. */
     urlType: EntityUrlTypeSchema.nullish(),
     /** Inclusive founding-year ranges, in calendar years. */

package/dist/entity/list-filter.d.ts

@@ -147,10 +147,10 @@ declare const EntityListFilterSchemaDefinition: z.ZodObject<{
     typeTechnologyUsed: z.ZodOptional<z.ZodArray<z.ZodString>>;
     url: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     urlDomain: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    urlMatchMode: z.ZodOptional<z.ZodEnum<{
+    urlMatchMode: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
         domain: "domain";
         hostPath: "hostPath";
-    }>>;
+    }>>>;
     urlType: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
         alternativeto: "alternativeto";
         angellist: "angellist";

package/dist/entity/list-filter.js

@@ -94,8 +94,8 @@ const EntityListFilterSchemaDefinition = z.strictObject({
     url: z.string().nullish(),
     /** Current root domain to match when urlMatchMode=domain. */
     urlDomain: z.string().nullish(),
-    /** URL matching mode: hostPath uses host and path; domain uses the root domain. */
-    urlMatchMode: UrlMatchModeSchema.optional(),
+    /** URL matching mode: hostPath uses host and path; domain uses the root domain. Omitted, it is domain when urlDomain is set, else hostPath. */
+    urlMatchMode: UrlMatchModeSchema.nullish(),
     /** Restrict URL matching to one URL type. */
     urlType: EntityUrlTypeSchema.nullish(),
     /** Inclusive founding-year ranges, in calendar years. */

package/dist/entity/logo-type.d.ts

@@ -3,7 +3,7 @@ import { z } from "zod/v4";
  * Entity logo slot: SQUARE is the square icon read back as `core.image.logoSquare`; STANDARD is the horizontal wordmark read back as `core.image.logo`.
  *
  * @openapiSchema EntityLogoType
- * @endpoint GET /v1/entities/{entityId}/media/{mediaType}
+ * @endpoint GET /v1/entities/{entityId}/logo
  * @contractShape entity.logo-type
  * @contractRole canonical
  */

package/dist/entity/logo-type.js

@@ -4,7 +4,7 @@ import { z } from "zod/v4";
  * Entity logo slot: SQUARE is the square icon read back as `core.image.logoSquare`; STANDARD is the horizontal wordmark read back as `core.image.logo`.
  *
  * @openapiSchema EntityLogoType
- * @endpoint GET /v1/entities/{entityId}/media/{mediaType}
+ * @endpoint GET /v1/entities/{entityId}/logo
  * @contractShape entity.logo-type
  * @contractRole canonical
  */

package/dist/entity/natural-search.d.ts

@@ -147,10 +147,10 @@ declare const EntityNaturalSearchSchemaDefinition: z.ZodObject<{
         typeTechnologyUsed: z.ZodOptional<z.ZodArray<z.ZodString>>;
         url: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         urlDomain: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-        urlMatchMode: z.ZodOptional<z.ZodEnum<{
+        urlMatchMode: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
             domain: "domain";
             hostPath: "hostPath";
-        }>>;
+        }>>>;
         urlType: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
             alternativeto: "alternativeto";
             angellist: "angellist";

package/dist/federated/search.d.ts

@@ -99,7 +99,7 @@ declare const FederatedSearchSchemaDefinition: z.ZodObject<{
                 typeTechnologyUsed?: string[] | undefined;
                 url?: string | null | undefined;
                 urlDomain?: string | null | undefined;
-                urlMatchMode?: "domain" | "hostPath" | undefined;
+                urlMatchMode?: "domain" | "hostPath" | null | undefined;
                 urlType?: "alternativeto" | "angellist" | "appstore" | "awsmarketplace" | "bloomberg" | "capterra" | "changelog" | "chromewebstore" | "crates" | "crunchbase" | "discord" | "dockerhub" | "documentation" | "facebook" | "forum" | "g2" | "gartnerpeerinsights" | "getapp" | "github" | "glassdoor" | "googleplay" | "homebrew" | "hubspotmarketplace" | "huggingface" | "instagram" | "linkedin" | "maven" | "morningstar" | "nasdaq" | "npm" | "nyse" | "pitchbook" | "producthunt" | "pypi" | "roadmap" | "salesforceappexchange" | "slackappdirectory" | "sourceforge" | "statuspage" | "subreddit" | "support" | "theorg" | "tiktok" | "trustpilot" | "trustradius" | "twitter" | "vscodemarketplace" | "website" | "wellfound" | "wikipedia" | "ycombinator" | "youtube" | null | undefined;
                 yearFoundedRange?: {
                     max?: number | null | undefined;
@@ -690,7 +690,7 @@ declare const FederatedSearchSchemaDefinition: z.ZodObject<{
                 typeTechnologyUsed?: string[] | undefined;
                 url?: string | null | undefined;
                 urlDomain?: string | null | undefined;
-                urlMatchMode?: "domain" | "hostPath" | undefined;
+                urlMatchMode?: "domain" | "hostPath" | null | undefined;
                 urlType?: "alternativeto" | "angellist" | "appstore" | "awsmarketplace" | "bloomberg" | "capterra" | "changelog" | "chromewebstore" | "crates" | "crunchbase" | "discord" | "dockerhub" | "documentation" | "facebook" | "forum" | "g2" | "gartnerpeerinsights" | "getapp" | "github" | "glassdoor" | "googleplay" | "homebrew" | "hubspotmarketplace" | "huggingface" | "instagram" | "linkedin" | "maven" | "morningstar" | "nasdaq" | "npm" | "nyse" | "pitchbook" | "producthunt" | "pypi" | "roadmap" | "salesforceappexchange" | "slackappdirectory" | "sourceforge" | "statuspage" | "subreddit" | "support" | "theorg" | "tiktok" | "trustpilot" | "trustradius" | "twitter" | "vscodemarketplace" | "website" | "wellfound" | "wikipedia" | "ycombinator" | "youtube" | null | undefined;
                 yearFoundedRange?: {
                     max?: number | null | undefined;

package/dist/link/search.d.ts

@@ -101,7 +101,7 @@ declare const LinkSearchSchemaDefinition: z.ZodObject<{
                     typeTechnologyUsed?: string[] | undefined;
                     url?: string | null | undefined;
                     urlDomain?: string | null | undefined;
-                    urlMatchMode?: "domain" | "hostPath" | undefined;
+                    urlMatchMode?: "domain" | "hostPath" | null | undefined;
                     urlType?: "alternativeto" | "angellist" | "appstore" | "awsmarketplace" | "bloomberg" | "capterra" | "changelog" | "chromewebstore" | "crates" | "crunchbase" | "discord" | "dockerhub" | "documentation" | "facebook" | "forum" | "g2" | "gartnerpeerinsights" | "getapp" | "github" | "glassdoor" | "googleplay" | "homebrew" | "hubspotmarketplace" | "huggingface" | "instagram" | "linkedin" | "maven" | "morningstar" | "nasdaq" | "npm" | "nyse" | "pitchbook" | "producthunt" | "pypi" | "roadmap" | "salesforceappexchange" | "slackappdirectory" | "sourceforge" | "statuspage" | "subreddit" | "support" | "theorg" | "tiktok" | "trustpilot" | "trustradius" | "twitter" | "vscodemarketplace" | "website" | "wellfound" | "wikipedia" | "ycombinator" | "youtube" | null | undefined;
                     yearFoundedRange?: {
                         max?: number | null | undefined;
@@ -852,7 +852,7 @@ declare const LinkSearchSchemaDefinition: z.ZodObject<{
                     typeTechnologyUsed?: string[] | undefined;
                     url?: string | null | undefined;
                     urlDomain?: string | null | undefined;
-                    urlMatchMode?: "domain" | "hostPath" | undefined;
+                    urlMatchMode?: "domain" | "hostPath" | null | undefined;
                     urlType?: "alternativeto" | "angellist" | "appstore" | "awsmarketplace" | "bloomberg" | "capterra" | "changelog" | "chromewebstore" | "crates" | "crunchbase" | "discord" | "dockerhub" | "documentation" | "facebook" | "forum" | "g2" | "gartnerpeerinsights" | "getapp" | "github" | "glassdoor" | "googleplay" | "homebrew" | "hubspotmarketplace" | "huggingface" | "instagram" | "linkedin" | "maven" | "morningstar" | "nasdaq" | "npm" | "nyse" | "pitchbook" | "producthunt" | "pypi" | "roadmap" | "salesforceappexchange" | "slackappdirectory" | "sourceforge" | "statuspage" | "subreddit" | "support" | "theorg" | "tiktok" | "trustpilot" | "trustradius" | "twitter" | "vscodemarketplace" | "website" | "wellfound" | "wikipedia" | "ycombinator" | "youtube" | null | undefined;
                     yearFoundedRange?: {
                         max?: number | null | undefined;

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

@@ -0,0 +1,21 @@
+import { z } from "zod/v4";
+declare const LogoAccuracyReferenceSchemaDefinition: z.ZodObject<{
+    hammingDistance: z.ZodInt;
+    url: z.ZodString;
+}, z.core.$strip>;
+type LogoAccuracyReferenceDefinition = z.infer<typeof LogoAccuracyReferenceSchemaDefinition>;
+/**
+ * A reference mark from the target's own surface and its distance to the candidate
+ *
+ * @openapiSchema LogoAccuracyReference
+ * @endpoint GET /v1/entities/{entityId}/logo
+ * @endpoint GET /v1/news/{newsId}/thumbnail
+ * @endpoint GET /v1/people/{personId}/photo
+ * @usedBySchema LogoAccuracySchema
+ * @contractShape logo.accuracy-reference
+ * @contractRole canonical
+ */
+export declare const LogoAccuracyReferenceSchema: z.ZodType<LogoAccuracyReferenceDefinition>;
+export type LogoAccuracyReference = z.infer<typeof LogoAccuracyReferenceSchema>;
+export {};
+//# sourceMappingURL=accuracy-reference.d.ts.map

package/dist/logo/accuracy-reference.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 LogoAccuracyReferenceSchemaDefinition = z.object({
+    /** Perceptual-hash distance between the candidate and this reference */
+    hammingDistance: z.int(),
+    /** Direct URL of the reference mark fetched from the target's surface */
+    url: z.string(),
+});
+/**
+ * A reference mark from the target's own surface and its distance to the candidate
+ *
+ * @openapiSchema LogoAccuracyReference
+ * @endpoint GET /v1/entities/{entityId}/logo
+ * @endpoint GET /v1/news/{newsId}/thumbnail
+ * @endpoint GET /v1/people/{personId}/photo
+ * @usedBySchema LogoAccuracySchema
+ * @contractShape logo.accuracy-reference
+ * @contractRole canonical
+ */
+export const LogoAccuracyReferenceSchema = LogoAccuracyReferenceSchemaDefinition;
+//# sourceMappingURL=accuracy-reference.js.map

package/dist/logo/accuracy.d.ts

@@ -0,0 +1,51 @@
+import { z } from "zod/v4";
+/**
+ * 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
+ *
+ * @openapiSchema LogoAccuracy
+ * @endpoint GET /v1/entities/{entityId}/logo
+ * @endpoint GET /v1/news/{newsId}/thumbnail
+ * @endpoint GET /v1/people/{personId}/photo
+ * @usedBySchema MediaUploadSchema
+ * @contractShape logo.accuracy
+ * @contractRole canonical
+ */
+export declare const LogoAccuracySchema: z.ZodObject<{
+    approval: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        changedAt: z.ZodOptional<z.ZodNullable<z.ZodISODateTime>>;
+        dataSourceUpdatedAt: z.ZodOptional<z.ZodNullable<z.ZodISODateTime>>;
+        detail: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        kind: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        pendingApproval: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
+        sourceId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        status: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strip>>>;
+    candidateObserved: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    confidence: z.ZodEnum<{
+        HIGH: "HIGH";
+        LOW: "LOW";
+        MEDIUM: "MEDIUM";
+    }>;
+    method: z.ZodEnum<{
+        OPERATOR_REVIEW: "OPERATOR_REVIEW";
+        PERCEPTUAL_HASH: "PERCEPTUAL_HASH";
+        REFERENCE_UNAVAILABLE: "REFERENCE_UNAVAILABLE";
+        VISION: "VISION";
+    }>;
+    outcome: z.ZodEnum<{
+        INSUFFICIENT: "INSUFFICIENT";
+        MATCH: "MATCH";
+        MISMATCH: "MISMATCH";
+    }>;
+    reference: z.ZodArray<z.ZodType<{
+        hammingDistance: number;
+        url: string;
+    }, unknown, z.core.$ZodTypeInternals<{
+        hammingDistance: number;
+        url: string;
+    }, unknown>>>;
+    referenceObserved: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    sharedFeature: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>;
+export type LogoAccuracy = z.infer<typeof LogoAccuracySchema>;
+//# sourceMappingURL=accuracy.d.ts.map

package/dist/logo/accuracy.js

@@ -0,0 +1,35 @@
+// 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 { DatasourceSourceMetadataSchema } from "../datasource/source-metadata.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
+ *
+ * @openapiSchema LogoAccuracy
+ * @endpoint GET /v1/entities/{entityId}/logo
+ * @endpoint GET /v1/news/{newsId}/thumbnail
+ * @endpoint GET /v1/people/{personId}/photo
+ * @usedBySchema MediaUploadSchema
+ * @contractShape logo.accuracy
+ * @contractRole canonical
+ */
+export const LogoAccuracySchema = z.object({
+    /** Confirmed media-slot provenance that made this a match without a model/reference comparison; null for deterministic hash, vision, and insufficient outcomes */
+    approval: DatasourceSourceMetadataSchema.nullish(),
+    /** Literal visible description of the candidate mark, when assessed by vision */
+    candidateObserved: z.string().nullish(),
+    /** Confidence in the outcome */
+    confidence: ConfidenceSchema,
+    /** How the outcome was reached */
+    method: z.enum(["PERCEPTUAL_HASH", "VISION", "OPERATOR_REVIEW", "REFERENCE_UNAVAILABLE"]),
+    /** 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 */
+    reference: z.array(LogoAccuracyReferenceSchema),
+    /** Literal visible description of the reference mark, when assessed by vision */
+    referenceObserved: z.string().nullish(),
+    /** The specific visible feature shared by candidate and reference that supports a match (shared name text, symbol, or distinctive palette); null when not a match */
+    sharedFeature: z.string().nullish(),
+});
+//# sourceMappingURL=accuracy.js.map

package/dist/media/object-type.d.ts

@@ -3,9 +3,9 @@ import { z } from "zod/v4";
  * Target domain for media operations (logos, pictures, thumbnails)
  *
  * @openapiSchema MediaObjectType
- * @endpoint GET /v1/entities/{entityId}/media/{mediaType}
- * @endpoint GET /v1/news/{newsId}/media/{mediaType}
- * @endpoint GET /v1/people/{personId}/media/{mediaType}
+ * @endpoint GET /v1/entities/{entityId}/logo
+ * @endpoint GET /v1/news/{newsId}/thumbnail
+ * @endpoint GET /v1/people/{personId}/photo
  * @usedBySchema MediaUploadSchema
  * @contractShape media.object-type
  * @contractRole canonical

package/dist/media/object-type.js

@@ -4,9 +4,9 @@ import { z } from "zod/v4";
  * Target domain for media operations (logos, pictures, thumbnails)
  *
  * @openapiSchema MediaObjectType
- * @endpoint GET /v1/entities/{entityId}/media/{mediaType}
- * @endpoint GET /v1/news/{newsId}/media/{mediaType}
- * @endpoint GET /v1/people/{personId}/media/{mediaType}
+ * @endpoint GET /v1/entities/{entityId}/logo
+ * @endpoint GET /v1/news/{newsId}/thumbnail
+ * @endpoint GET /v1/people/{personId}/photo
  * @usedBySchema MediaUploadSchema
  * @contractShape media.object-type
  * @contractRole canonical

package/dist/media/upload.d.ts

@@ -3,13 +3,50 @@ import { z } from "zod/v4";
  * Managed media asset reference with resolved CDN URL and target metadata
  *
  * @openapiSchema MediaUpload
- * @endpoint GET /v1/entities/{entityId}/media/{mediaType}
- * @endpoint GET /v1/news/{newsId}/media/{mediaType}
- * @endpoint GET /v1/people/{personId}/media/{mediaType}
+ * @endpoint GET /v1/entities/{entityId}/logo
+ * @endpoint GET /v1/news/{newsId}/thumbnail
+ * @endpoint GET /v1/people/{personId}/photo
  * @contractShape media.upload
  * @contractRole canonical
  */
 export declare const MediaUploadSchema: z.ZodObject<{
+    accuracy: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        approval: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+            changedAt: z.ZodOptional<z.ZodNullable<z.ZodISODateTime>>;
+            dataSourceUpdatedAt: z.ZodOptional<z.ZodNullable<z.ZodISODateTime>>;
+            detail: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            kind: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            pendingApproval: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
+            sourceId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            status: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        }, z.core.$strip>>>;
+        candidateObserved: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        confidence: z.ZodEnum<{
+            HIGH: "HIGH";
+            LOW: "LOW";
+            MEDIUM: "MEDIUM";
+        }>;
+        method: z.ZodEnum<{
+            OPERATOR_REVIEW: "OPERATOR_REVIEW";
+            PERCEPTUAL_HASH: "PERCEPTUAL_HASH";
+            REFERENCE_UNAVAILABLE: "REFERENCE_UNAVAILABLE";
+            VISION: "VISION";
+        }>;
+        outcome: z.ZodEnum<{
+            INSUFFICIENT: "INSUFFICIENT";
+            MATCH: "MATCH";
+            MISMATCH: "MISMATCH";
+        }>;
+        reference: z.ZodArray<z.ZodType<{
+            hammingDistance: number;
+            url: string;
+        }, unknown, z.core.$ZodTypeInternals<{
+            hammingDistance: number;
+            url: string;
+        }, unknown>>>;
+        referenceObserved: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        sharedFeature: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strip>>>;
     cdnUrl: z.ZodString;
     firstUploadedAt: z.ZodOptional<z.ZodNullable<z.ZodISODateTime>>;
     mediaType: z.ZodEnum<{

package/dist/media/upload.js

@@ -1,18 +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";
 import { DatasourceSourceMetadataSchema } from "../datasource/source-metadata.js";
+import { LogoAccuracySchema } from "../logo/accuracy.js";
 import { MediaObjectTypeSchema } from "./object-type.js";
 /**
  * Managed media asset reference with resolved CDN URL and target metadata
  *
  * @openapiSchema MediaUpload
- * @endpoint GET /v1/entities/{entityId}/media/{mediaType}
- * @endpoint GET /v1/news/{newsId}/media/{mediaType}
- * @endpoint GET /v1/people/{personId}/media/{mediaType}
+ * @endpoint GET /v1/entities/{entityId}/logo
+ * @endpoint GET /v1/news/{newsId}/thumbnail
+ * @endpoint GET /v1/people/{personId}/photo
  * @contractShape media.upload
  * @contractRole canonical
  */
 export const MediaUploadSchema = z.object({
+    /** Entity logo writes only: the brand-match verdict the write's gate computed on these bytes; absent on reads, photos, thumbnails, and brand-match overrides. */
+    accuracy: LogoAccuracySchema.nullish(),
     /** Resolved API CDN URL */
     cdnUrl: z.string(),
     /** Earliest recorded write timestamp for this media asset slot from res_provenance_event (when this entity/person/news first received any image in this slot). */

package/dist/natural/search-result.d.ts

@@ -98,7 +98,7 @@ declare const NaturalSearchResultSchemaDefinition: z.ZodObject<{
             typeTechnologyUsed?: string[] | undefined;
             url?: string | null | undefined;
             urlDomain?: string | null | undefined;
-            urlMatchMode?: "domain" | "hostPath" | undefined;
+            urlMatchMode?: "domain" | "hostPath" | null | undefined;
             urlType?: "alternativeto" | "angellist" | "appstore" | "awsmarketplace" | "bloomberg" | "capterra" | "changelog" | "chromewebstore" | "crates" | "crunchbase" | "discord" | "dockerhub" | "documentation" | "facebook" | "forum" | "g2" | "gartnerpeerinsights" | "getapp" | "github" | "glassdoor" | "googleplay" | "homebrew" | "hubspotmarketplace" | "huggingface" | "instagram" | "linkedin" | "maven" | "morningstar" | "nasdaq" | "npm" | "nyse" | "pitchbook" | "producthunt" | "pypi" | "roadmap" | "salesforceappexchange" | "slackappdirectory" | "sourceforge" | "statuspage" | "subreddit" | "support" | "theorg" | "tiktok" | "trustpilot" | "trustradius" | "twitter" | "vscodemarketplace" | "website" | "wellfound" | "wikipedia" | "ycombinator" | "youtube" | null | undefined;
             yearFoundedRange?: {
                 max?: number | null | undefined;
@@ -212,7 +212,7 @@ declare const NaturalSearchResultSchemaDefinition: z.ZodObject<{
             typeTechnologyUsed?: string[] | undefined;
             url?: string | null | undefined;
             urlDomain?: string | null | undefined;
-            urlMatchMode?: "domain" | "hostPath" | undefined;
+            urlMatchMode?: "domain" | "hostPath" | null | undefined;
             urlType?: "alternativeto" | "angellist" | "appstore" | "awsmarketplace" | "bloomberg" | "capterra" | "changelog" | "chromewebstore" | "crates" | "crunchbase" | "discord" | "dockerhub" | "documentation" | "facebook" | "forum" | "g2" | "gartnerpeerinsights" | "getapp" | "github" | "glassdoor" | "googleplay" | "homebrew" | "hubspotmarketplace" | "huggingface" | "instagram" | "linkedin" | "maven" | "morningstar" | "nasdaq" | "npm" | "nyse" | "pitchbook" | "producthunt" | "pypi" | "roadmap" | "salesforceappexchange" | "slackappdirectory" | "sourceforge" | "statuspage" | "subreddit" | "support" | "theorg" | "tiktok" | "trustpilot" | "trustradius" | "twitter" | "vscodemarketplace" | "website" | "wellfound" | "wikipedia" | "ycombinator" | "youtube" | null | undefined;
             yearFoundedRange?: {
                 max?: number | null | undefined;

package/dist/openapi-component-manifest.js

@@ -181,6 +181,10 @@ export const OPENAPI_COMPONENT_MANIFEST = Object.freeze({
         modulePath: "redirect/current-slug-owner",
         schemaName: "CurrentSlugOwnerSchema",
     },
+    DatasourceProvenanceActorType: {
+        modulePath: "datasource/provenance-actor-type",
+        schemaName: "DatasourceProvenanceActorTypeSchema",
+    },
     DatasourceSourceMetadata: {
         modulePath: "datasource/source-metadata",
         schemaName: "DatasourceSourceMetadataSchema",
@@ -503,12 +507,16 @@ export const OPENAPI_COMPONENT_MANIFEST = Object.freeze({
     JobState: { modulePath: "job/state", schemaName: "JobStateSchema" },
     JsonValue: { modulePath: "http/json-value", schemaName: "JsonValueSchema" },
     LinkSearch: { modulePath: "link/search", schemaName: "LinkSearchSchema" },
+    LogoAccuracy: { modulePath: "logo/accuracy", schemaName: "LogoAccuracySchema" },
+    LogoAccuracyReference: {
+        modulePath: "logo/accuracy-reference",
+        schemaName: "LogoAccuracyReferenceSchema",
+    },
     LookupJob: { modulePath: "lookup/job", schemaName: "LookupJobSchema" },
     LookupJobMention: { modulePath: "lookup/job-mention", schemaName: "LookupJobMentionSchema" },
     LookupJobMutation: { modulePath: "lookup/job-mutation", schemaName: "LookupJobMutationSchema" },
     LookupMention: { modulePath: "lookup/mention", schemaName: "LookupMentionSchema" },
     MediaObjectType: { modulePath: "media/object-type", schemaName: "MediaObjectTypeSchema" },
-    MediaSlot: { modulePath: "media/slot", schemaName: "MediaSlotSchema" },
     MediaUpload: { modulePath: "media/upload", schemaName: "MediaUploadSchema" },
     MentionLookup: { modulePath: "mention/lookup", schemaName: "MentionLookupSchema" },
     NaturalSearch: { modulePath: "natural/search", schemaName: "NaturalSearchSchema" },

package/dist/search/interpretation.d.ts

@@ -104,7 +104,7 @@ declare const SearchInterpretationSchemaDefinition: z.ZodObject<{
         typeTechnologyUsed?: string[] | undefined;
         url?: string | null | undefined;
         urlDomain?: string | null | undefined;
-        urlMatchMode?: "domain" | "hostPath" | undefined;
+        urlMatchMode?: "domain" | "hostPath" | null | undefined;
         urlType?: "alternativeto" | "angellist" | "appstore" | "awsmarketplace" | "bloomberg" | "capterra" | "changelog" | "chromewebstore" | "crates" | "crunchbase" | "discord" | "dockerhub" | "documentation" | "facebook" | "forum" | "g2" | "gartnerpeerinsights" | "getapp" | "github" | "glassdoor" | "googleplay" | "homebrew" | "hubspotmarketplace" | "huggingface" | "instagram" | "linkedin" | "maven" | "morningstar" | "nasdaq" | "npm" | "nyse" | "pitchbook" | "producthunt" | "pypi" | "roadmap" | "salesforceappexchange" | "slackappdirectory" | "sourceforge" | "statuspage" | "subreddit" | "support" | "theorg" | "tiktok" | "trustpilot" | "trustradius" | "twitter" | "vscodemarketplace" | "website" | "wellfound" | "wikipedia" | "ycombinator" | "youtube" | null | undefined;
         yearFoundedRange?: {
             max?: number | null | undefined;
@@ -201,7 +201,7 @@ declare const SearchInterpretationSchemaDefinition: z.ZodObject<{
         typeTechnologyUsed?: string[] | undefined;
         url?: string | null | undefined;
         urlDomain?: string | null | undefined;
-        urlMatchMode?: "domain" | "hostPath" | undefined;
+        urlMatchMode?: "domain" | "hostPath" | null | undefined;
         urlType?: "alternativeto" | "angellist" | "appstore" | "awsmarketplace" | "bloomberg" | "capterra" | "changelog" | "chromewebstore" | "crates" | "crunchbase" | "discord" | "dockerhub" | "documentation" | "facebook" | "forum" | "g2" | "gartnerpeerinsights" | "getapp" | "github" | "glassdoor" | "googleplay" | "homebrew" | "hubspotmarketplace" | "huggingface" | "instagram" | "linkedin" | "maven" | "morningstar" | "nasdaq" | "npm" | "nyse" | "pitchbook" | "producthunt" | "pypi" | "roadmap" | "salesforceappexchange" | "slackappdirectory" | "sourceforge" | "statuspage" | "subreddit" | "support" | "theorg" | "tiktok" | "trustpilot" | "trustradius" | "twitter" | "vscodemarketplace" | "website" | "wellfound" | "wikipedia" | "ycombinator" | "youtube" | null | undefined;
         yearFoundedRange?: {
             max?: number | null | undefined;

package/dist/search/search.js

@@ -13,7 +13,7 @@ const SearchSchemaDefinition = z.object({
     resultLimit: z.int().nullish(),
     /** Search text sent to the upstream web search provider */
     search: z.string(),
-    /** Optional caller identity, up to 64 characters, persisted for source-document attribution and abuse triage. Agents send `<agentModel>-<tool>` (see aventure-provenance). */
+    /** Optional caller identity, up to 64 characters, persisted for source-document attribution and abuse triage. Agent requests derive `<agentModel>-<agentChassis>` from the validated provenance actor instead of this field. */
     source: z.string().max(64).nullish(),
 });
 /**

package/package.json

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

package/dist/media/slot.d.ts

@@ -1,18 +0,0 @@
-import { z } from "zod/v4";
-/**
- * Media slot on an owner record, addressed by the {mediaType} path segment.
- *
- * @openapiSchema MediaSlot
- * @endpoint GET /v1/entities/{entityId}/media/{mediaType}
- * @endpoint GET /v1/news/{newsId}/media/{mediaType}
- * @endpoint GET /v1/people/{personId}/media/{mediaType}
- * @contractShape media.slot
- * @contractRole canonical
- */
-export declare const MediaSlotSchema: z.ZodEnum<{
-    logo: "logo";
-    photo: "photo";
-    thumbnail: "thumbnail";
-}>;
-export type MediaSlot = z.infer<typeof MediaSlotSchema>;
-//# sourceMappingURL=slot.d.ts.map

package/dist/media/slot.js

@@ -1,14 +0,0 @@
-// 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";
-/**
- * Media slot on an owner record, addressed by the {mediaType} path segment.
- *
- * @openapiSchema MediaSlot
- * @endpoint GET /v1/entities/{entityId}/media/{mediaType}
- * @endpoint GET /v1/news/{newsId}/media/{mediaType}
- * @endpoint GET /v1/people/{personId}/media/{mediaType}
- * @contractShape media.slot
- * @contractRole canonical
- */
-export const MediaSlotSchema = z.enum(["logo", "photo", "thumbnail"]);
-//# sourceMappingURL=slot.js.map