@aventurevc/api-schemas 0.8.20 → 0.8.21

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/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/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/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/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.21",
   "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