@aventurevc/api-schemas 0.8.297 → 0.8.298

package/dist/job/enqueue.d.ts

@@ -18,6 +18,7 @@ import { z } from "zod/v4";
  * @endpoint POST /v1/lookup/mentions
  * @endpoint POST /v1/people/lookup
  * @usedBySchema IdentificationSchema
+ * @usedBySchema LookupSourceReadSchema
  * @usedBySchema MentionLookupSchema
  * @contractShape job.enqueue
  * @contractRole canonical

package/dist/job/enqueue.js

@@ -19,6 +19,7 @@ import { z } from "zod/v4";
  * @endpoint POST /v1/lookup/mentions
  * @endpoint POST /v1/people/lookup
  * @usedBySchema IdentificationSchema
+ * @usedBySchema LookupSourceReadSchema
  * @usedBySchema MentionLookupSchema
  * @contractShape job.enqueue
  * @contractRole canonical

package/dist/lookup/job.d.ts

@@ -1882,6 +1882,68 @@ declare const LookupJobSchemaDefinition: z.ZodObject<{
     }, import("./job-mention.ts").LookupJobMentionSchemaInput>>>;
     namesFound: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
     namesProcessed: z.ZodInt;
+    news: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        author: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        category: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        createdAt: z.ZodOptional<z.ZodNullable<z.ZodISODateTime>>;
+        excerpt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        externalNewsArticle: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+        id: z.ZodInt;
+        newsImageThumbnail: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        newsUrlOriginal: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        publication: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        publishedAt: z.ZodOptional<z.ZodNullable<z.ZodISODateTime>>;
+        slug: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        title: z.ZodString;
+        titleMention: z.ZodOptional<z.ZodArray<z.ZodType<{
+            end: number;
+            entity?: {
+                createdAt: string;
+                entityId: string;
+                href?: string | null | undefined;
+                internal: boolean;
+                matchStatus?: "approved" | "auto-match" | "needs-review" | "rejected" | null | undefined;
+                mention?: string | null | undefined;
+                slug?: string | null | undefined;
+                typeRecord?: "Business Line" | "Company" | "Fund" | "Government" | "Investment Firm" | "Nonprofit" | "Organization" | "Product" | "Service" | null | undefined;
+                updatedAt: string;
+            } | null | undefined;
+            person?: {
+                createdAt: string;
+                href?: string | null | undefined;
+                matchStatus?: "approved" | "auto-match" | "needs-review" | "rejected" | null | undefined;
+                mention?: string | null | undefined;
+                personId: string;
+                slug?: string | null | undefined;
+                updatedAt: string;
+            } | null | undefined;
+            start: number;
+        }, import("../news/title-mention.ts").NewsTitleMentionSchemaInput, z.core.$ZodTypeInternals<{
+            end: number;
+            entity?: {
+                createdAt: string;
+                entityId: string;
+                href?: string | null | undefined;
+                internal: boolean;
+                matchStatus?: "approved" | "auto-match" | "needs-review" | "rejected" | null | undefined;
+                mention?: string | null | undefined;
+                slug?: string | null | undefined;
+                typeRecord?: "Business Line" | "Company" | "Fund" | "Government" | "Investment Firm" | "Nonprofit" | "Organization" | "Product" | "Service" | null | undefined;
+                updatedAt: string;
+            } | null | undefined;
+            person?: {
+                createdAt: string;
+                href?: string | null | undefined;
+                matchStatus?: "approved" | "auto-match" | "needs-review" | "rejected" | null | undefined;
+                mention?: string | null | undefined;
+                personId: string;
+                slug?: string | null | undefined;
+                updatedAt: string;
+            } | null | undefined;
+            start: number;
+        }, import("../news/title-mention.ts").NewsTitleMentionSchemaInput>>>>;
+        updatedAt: z.ZodOptional<z.ZodNullable<z.ZodISODateTime>>;
+    }, z.core.$strip>>>;
     source: z.ZodType<{
         deterministic?: boolean | undefined;
         mention?: {
@@ -2007,6 +2069,28 @@ declare const LookupJobSchemaDefinition: z.ZodObject<{
             url?: string[] | undefined;
         } | null | undefined;
     }, import("./job-mutation.ts").LookupJobMutationSchemaInput>>;
+    sourceRead: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        continuation: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+            deduped: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+            jobId: z.ZodUUID;
+            mode: z.ZodString;
+            statusUrl: z.ZodString;
+        }, z.core.$strip>>>;
+        faviconUrl: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        logoUrl: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        message: z.ZodArray<z.ZodString>;
+        p95Ms: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        phase: z.ZodUnion<readonly [z.ZodEnum<{
+            MATCHING: "MATCHING";
+            READING: "READING";
+        }>, z.ZodString]> & {
+            enum: {
+                MATCHING: "MATCHING";
+                READING: "READING";
+            };
+        };
+        publication: z.ZodString;
+    }, z.core.$strip>>>;
     state: z.ZodEnum<{
         CANCELED: "CANCELED";
         COMPLETED: "COMPLETED";

package/dist/lookup/job.js

@@ -4,6 +4,8 @@ import { IdentificationSchema } from "../identification/identification.js";
 import { JobStateSchema } from "../job/state.js";
 import { LookupJobMentionSchema } from "./job-mention.js";
 import { LookupJobMutationSchema } from "./job-mutation.js";
+import { LookupSourceReadSchema } from "./source-read.js";
+import { NewsSchema } from "../news/news.js";
 const LookupJobSchemaDefinition = z.object({
     /** When the job was requested. */
     createdAt: z.iso.datetime({ offset: true }),
@@ -23,8 +25,12 @@ const LookupJobSchemaDefinition = z.object({
     namesFound: z.int().nullish(),
     /** Names processed so far, including per-name failures. */
     namesProcessed: z.int(),
+    /** Stored article behind a shared-article lookup, when known. */
+    news: NewsSchema.nullish(),
     /** The article the job reads or names supplied for a bulk lookup. */
     source: LookupJobMutationSchema,
+    /** Publisher-reading activity for a durably accepted shared-article lookup. */
+    sourceRead: LookupSourceReadSchema.nullish(),
     /** Current job state. */
     state: JobStateSchema,
     /** When the job last changed state. */

package/dist/lookup/source-read-phase.d.ts

@@ -0,0 +1,24 @@
+import { z } from "zod/v4";
+/**
+ * Observed article-reading activity; unknown future phases retain their supplied copy.
+ *
+ * @openapiSchema LookupSourceReadPhase
+ * @endpoint GET /v1/lookup-jobs/{jobId}
+ * @endpoint GET /v1/lookup/jobs/{jobId}
+ * @endpoint POST /v1/lookup-mentions
+ * @endpoint POST /v1/lookup/mentions
+ * @usedBySchema LookupSourceReadSchema
+ * @contractShape lookup.source-read-phase
+ * @contractRole canonical
+ */
+export declare const LookupSourceReadPhaseSchema: z.ZodUnion<readonly [z.ZodEnum<{
+    MATCHING: "MATCHING";
+    READING: "READING";
+}>, z.ZodString]> & {
+    enum: {
+        MATCHING: "MATCHING";
+        READING: "READING";
+    };
+};
+export type LookupSourceReadPhase = z.infer<typeof LookupSourceReadPhaseSchema>;
+//# sourceMappingURL=source-read-phase.d.ts.map

package/dist/lookup/source-read-phase.js

@@ -0,0 +1,17 @@
+// 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 LookupSourceReadPhaseSchemaKnownMembers = z.enum(["READING", "MATCHING"]);
+/**
+ * Observed article-reading activity; unknown future phases retain their supplied copy.
+ *
+ * @openapiSchema LookupSourceReadPhase
+ * @endpoint GET /v1/lookup-jobs/{jobId}
+ * @endpoint GET /v1/lookup/jobs/{jobId}
+ * @endpoint POST /v1/lookup-mentions
+ * @endpoint POST /v1/lookup/mentions
+ * @usedBySchema LookupSourceReadSchema
+ * @contractShape lookup.source-read-phase
+ * @contractRole canonical
+ */
+export const LookupSourceReadPhaseSchema = Object.assign(z.union([LookupSourceReadPhaseSchemaKnownMembers, z.string()]), { enum: LookupSourceReadPhaseSchemaKnownMembers.enum });
+//# sourceMappingURL=source-read-phase.js.map

package/dist/lookup/source-read.d.ts

@@ -0,0 +1,38 @@
+import { z } from "zod/v4";
+/**
+ * Publisher context and honest reading activity for a shared-article lookup.
+ *
+ * @openapiSchema LookupSourceRead
+ * @endpoint GET /v1/lookup-jobs/{jobId}
+ * @endpoint GET /v1/lookup/jobs/{jobId}
+ * @endpoint POST /v1/lookup-mentions
+ * @endpoint POST /v1/lookup/mentions
+ * @usedBySchema LookupJobSchema
+ * @usedBySchema MentionLookupSchema
+ * @contractShape lookup.source-read
+ * @contractRole canonical
+ */
+export declare const LookupSourceReadSchema: z.ZodObject<{
+    continuation: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        deduped: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+        jobId: z.ZodUUID;
+        mode: z.ZodString;
+        statusUrl: z.ZodString;
+    }, z.core.$strip>>>;
+    faviconUrl: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    logoUrl: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    message: z.ZodArray<z.ZodString>;
+    p95Ms: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    phase: z.ZodUnion<readonly [z.ZodEnum<{
+        MATCHING: "MATCHING";
+        READING: "READING";
+    }>, z.ZodString]> & {
+        enum: {
+            MATCHING: "MATCHING";
+            READING: "READING";
+        };
+    };
+    publication: z.ZodString;
+}, z.core.$strip>;
+export type LookupSourceRead = z.infer<typeof LookupSourceReadSchema>;
+//# sourceMappingURL=source-read.d.ts.map

package/dist/lookup/source-read.js

@@ -0,0 +1,30 @@
+// 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 { JobEnqueueSchema } from "../job/enqueue.js";
+import { LookupSourceReadPhaseSchema } from "./source-read-phase.js";
+/**
+ * Publisher context and honest reading activity for a shared-article lookup.
+ *
+ * @openapiSchema LookupSourceRead
+ * @endpoint GET /v1/lookup-jobs/{jobId}
+ * @endpoint GET /v1/lookup/jobs/{jobId}
+ * @endpoint POST /v1/lookup-mentions
+ * @endpoint POST /v1/lookup/mentions
+ * @usedBySchema LookupJobSchema
+ * @usedBySchema MentionLookupSchema
+ * @contractShape lookup.source-read
+ * @contractRole canonical
+ */
+export const LookupSourceReadSchema = z.object({
+    /** A committed durable lookup to follow; only its presence permits a promise to leave and return. Follow its status URL with the same caller's bearer, honoring Retry-After. */
+    continuation: JobEnqueueSchema.nullish(),
+    faviconUrl: z.string().nullish(),
+    logoUrl: z.string().nullish(),
+    /** Informational messages to cycle within this stage, never evidence of completed work. */
+    message: z.array(z.string()),
+    /** Measured reference p95 in milliseconds; no slow-state claim when absent. */
+    p95Ms: z.number().int().nullish(),
+    phase: LookupSourceReadPhaseSchema,
+    publication: z.string(),
+});
+//# sourceMappingURL=source-read.js.map

package/dist/mention/lookup.d.ts

@@ -1725,6 +1725,28 @@ declare const MentionLookupSchemaDefinition: z.ZodObject<{
         }, import("../news/title-mention.ts").NewsTitleMentionSchemaInput>>>>;
         updatedAt: z.ZodOptional<z.ZodNullable<z.ZodISODateTime>>;
     }, z.core.$strip>>>;
+    sourceRead: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        continuation: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+            deduped: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+            jobId: z.ZodUUID;
+            mode: z.ZodString;
+            statusUrl: z.ZodString;
+        }, z.core.$strip>>>;
+        faviconUrl: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        logoUrl: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        message: z.ZodArray<z.ZodString>;
+        p95Ms: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        phase: z.ZodUnion<readonly [z.ZodEnum<{
+            MATCHING: "MATCHING";
+            READING: "READING";
+        }>, z.ZodString]> & {
+            enum: {
+                MATCHING: "MATCHING";
+                READING: "READING";
+            };
+        };
+        publication: z.ZodString;
+    }, z.core.$strip>>>;
     truncated: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strip>;
 type MentionLookupDefinition = z.infer<typeof MentionLookupSchemaDefinition>;

package/dist/mention/lookup.js

@@ -2,6 +2,7 @@
 import { z } from "zod/v4";
 import { JobEnqueueSchema } from "../job/enqueue.js";
 import { LookupJobMentionSchema } from "../lookup/job-mention.js";
+import { LookupSourceReadSchema } from "../lookup/source-read.js";
 import { NewsSchema } from "../news/news.js";
 const MentionLookupSchemaDefinition = z.object({
     /** Present only for callers that sent Prefer: respond-async. Identifications are settled but shell filing is pending. Poll statusUrl until the lookup job completes; merge its filing outcomes by mentionType and name. */
@@ -10,6 +11,8 @@ const MentionLookupSchemaDefinition = z.object({
     mention: z.array(LookupJobMentionSchema),
     /** The stored aVenture news article the source page is, when it is one; absent otherwise. */
     news: NewsSchema.nullish(),
+    /** Publisher reading state, available before the first name settles; a continuation is present only after its durable job commits. */
+    sourceRead: LookupSourceReadSchema.nullish(),
     /** True when the page names more than this answer holds: more names than one live lookup reads, or a body longer than the read limit. A lookup job with maxNames reads every name. */
     truncated: z.boolean().optional(),
 });

package/dist/news/match-status.d.ts

@@ -13,6 +13,8 @@ import { z } from "zod/v4";
  * @endpoint GET /v1/entities/{entityId}/investors/people
  * @endpoint GET /v1/entities/{entityId}/person-investors
  * @endpoint GET /v1/entities/{entityId}/trending-news
+ * @endpoint GET /v1/lookup-jobs/{jobId}
+ * @endpoint GET /v1/lookup/jobs/{jobId}
  * @endpoint GET /v1/news/{newsId}
  * @endpoint GET /v1/people/{personId}
  * @endpoint GET /v1/people/{personId}/graph

package/dist/news/match-status.js

@@ -14,6 +14,8 @@ import { z } from "zod/v4";
  * @endpoint GET /v1/entities/{entityId}/investors/people
  * @endpoint GET /v1/entities/{entityId}/person-investors
  * @endpoint GET /v1/entities/{entityId}/trending-news
+ * @endpoint GET /v1/lookup-jobs/{jobId}
+ * @endpoint GET /v1/lookup/jobs/{jobId}
  * @endpoint GET /v1/news/{newsId}
  * @endpoint GET /v1/people/{personId}
  * @endpoint GET /v1/people/{personId}/graph

package/dist/news/news.d.ts

@@ -13,6 +13,8 @@ import { z } from "zod/v4";
  * @endpoint GET /v1/entities/{entityId}/investors/people
  * @endpoint GET /v1/entities/{entityId}/person-investors
  * @endpoint GET /v1/entities/{entityId}/trending-news
+ * @endpoint GET /v1/lookup-jobs/{jobId}
+ * @endpoint GET /v1/lookup/jobs/{jobId}
  * @endpoint GET /v1/news/{newsId}
  * @endpoint GET /v1/people/{personId}
  * @endpoint GET /v1/people/{personId}/graph
@@ -28,6 +30,7 @@ import { z } from "zod/v4";
  * @endpoint POST /v1/search
  * @endpoint POST /v1/search/shared
  * @usedBySchema EntityDetailSchema
+ * @usedBySchema LookupJobSchema
  * @usedBySchema MentionLookupSchema
  * @usedBySchema NewsDetailSchema
  * @usedBySchema NewsPublishedEventSchema

package/dist/news/news.js

@@ -15,6 +15,8 @@ import { NewsTitleMentionSchema } from "./title-mention.js";
  * @endpoint GET /v1/entities/{entityId}/investors/people
  * @endpoint GET /v1/entities/{entityId}/person-investors
  * @endpoint GET /v1/entities/{entityId}/trending-news
+ * @endpoint GET /v1/lookup-jobs/{jobId}
+ * @endpoint GET /v1/lookup/jobs/{jobId}
  * @endpoint GET /v1/news/{newsId}
  * @endpoint GET /v1/people/{personId}
  * @endpoint GET /v1/people/{personId}/graph
@@ -30,6 +32,7 @@ import { NewsTitleMentionSchema } from "./title-mention.js";
  * @endpoint POST /v1/search
  * @endpoint POST /v1/search/shared
  * @usedBySchema EntityDetailSchema
+ * @usedBySchema LookupJobSchema
  * @usedBySchema MentionLookupSchema
  * @usedBySchema NewsDetailSchema
  * @usedBySchema NewsPublishedEventSchema

package/dist/news/resolved-entity-link.d.ts

@@ -13,6 +13,8 @@ import { z } from "zod/v4";
  * @endpoint GET /v1/entities/{entityId}/investors/people
  * @endpoint GET /v1/entities/{entityId}/person-investors
  * @endpoint GET /v1/entities/{entityId}/trending-news
+ * @endpoint GET /v1/lookup-jobs/{jobId}
+ * @endpoint GET /v1/lookup/jobs/{jobId}
  * @endpoint GET /v1/news/{newsId}
  * @endpoint GET /v1/people/{personId}
  * @endpoint GET /v1/people/{personId}/graph

package/dist/news/resolved-entity-link.js

@@ -16,6 +16,8 @@ import { NewsMatchStatusSchema } from "./match-status.js";
  * @endpoint GET /v1/entities/{entityId}/investors/people
  * @endpoint GET /v1/entities/{entityId}/person-investors
  * @endpoint GET /v1/entities/{entityId}/trending-news
+ * @endpoint GET /v1/lookup-jobs/{jobId}
+ * @endpoint GET /v1/lookup/jobs/{jobId}
  * @endpoint GET /v1/news/{newsId}
  * @endpoint GET /v1/people/{personId}
  * @endpoint GET /v1/people/{personId}/graph

package/dist/news/resolved-person-link.d.ts

@@ -13,6 +13,8 @@ import { z } from "zod/v4";
  * @endpoint GET /v1/entities/{entityId}/investors/people
  * @endpoint GET /v1/entities/{entityId}/person-investors
  * @endpoint GET /v1/entities/{entityId}/trending-news
+ * @endpoint GET /v1/lookup-jobs/{jobId}
+ * @endpoint GET /v1/lookup/jobs/{jobId}
  * @endpoint GET /v1/news/{newsId}
  * @endpoint GET /v1/people/{personId}
  * @endpoint GET /v1/people/{personId}/graph

package/dist/news/resolved-person-link.js

@@ -15,6 +15,8 @@ import { NewsMatchStatusSchema } from "./match-status.js";
  * @endpoint GET /v1/entities/{entityId}/investors/people
  * @endpoint GET /v1/entities/{entityId}/person-investors
  * @endpoint GET /v1/entities/{entityId}/trending-news
+ * @endpoint GET /v1/lookup-jobs/{jobId}
+ * @endpoint GET /v1/lookup/jobs/{jobId}
  * @endpoint GET /v1/news/{newsId}
  * @endpoint GET /v1/people/{personId}
  * @endpoint GET /v1/people/{personId}/graph

package/dist/news/title-mention.d.ts

@@ -60,6 +60,8 @@ export interface NewsTitleMentionSchemaInput extends z.input<typeof NewsTitleMen
  * @endpoint GET /v1/entities/{entityId}/investors/people
  * @endpoint GET /v1/entities/{entityId}/person-investors
  * @endpoint GET /v1/entities/{entityId}/trending-news
+ * @endpoint GET /v1/lookup-jobs/{jobId}
+ * @endpoint GET /v1/lookup/jobs/{jobId}
  * @endpoint GET /v1/news/{newsId}
  * @endpoint GET /v1/people/{personId}
  * @endpoint GET /v1/people/{personId}/graph

package/dist/news/title-mention.js

@@ -24,6 +24,8 @@ const NewsTitleMentionSchemaDefinition = z.object({
  * @endpoint GET /v1/entities/{entityId}/investors/people
  * @endpoint GET /v1/entities/{entityId}/person-investors
  * @endpoint GET /v1/entities/{entityId}/trending-news
+ * @endpoint GET /v1/lookup-jobs/{jobId}
+ * @endpoint GET /v1/lookup/jobs/{jobId}
  * @endpoint GET /v1/news/{newsId}
  * @endpoint GET /v1/people/{personId}
  * @endpoint GET /v1/people/{personId}/graph

package/dist/openapi-component-manifest.js

@@ -778,6 +778,11 @@ export const OPENAPI_COMPONENT_MANIFEST = Object.freeze({
     LookupJobMention: { modulePath: "lookup/job-mention", schemaName: "LookupJobMentionSchema" },
     LookupJobMutation: { modulePath: "lookup/job-mutation", schemaName: "LookupJobMutationSchema" },
     LookupMention: { modulePath: "lookup/mention", schemaName: "LookupMentionSchema" },
+    LookupSourceRead: { modulePath: "lookup/source-read", schemaName: "LookupSourceReadSchema" },
+    LookupSourceReadPhase: {
+        modulePath: "lookup/source-read-phase",
+        schemaName: "LookupSourceReadPhaseSchema",
+    },
     MediaObjectType: { modulePath: "media/object-type", schemaName: "MediaObjectTypeSchema" },
     MediaUpload: { modulePath: "media/upload", schemaName: "MediaUploadSchema" },
     MentionLookup: { modulePath: "mention/lookup", schemaName: "MentionLookupSchema" },

package/package.json

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