@aventurevc/api-schemas 0.8.180 → 0.8.182

package/dist/funding/stage.d.ts

@@ -5,17 +5,20 @@ import { z } from "zod/v4";
  * @openapiSchema FundingStage
  * @endpoint GET /v1/entities
  * @endpoint GET /v1/entities/lookup-exact
+ * @endpoint GET /v1/people/lookup-exact
  * @endpoint GET /v1/search/link
  * @endpoint GET /v1/entities/{entityId}
  * @endpoint GET /v1/entities/{entityId}/fundraise-rounds
  * @endpoint GET /v1/entities/{entityId}/fundraise-rounds/{fundraiseRoundId}
  * @endpoint GET /v1/entities/{entityId}/investments
  * @endpoint GET /v1/entities/{entityId}/investors
+ * @endpoint GET /v1/entities/{entityId}/person-investors
  * @endpoint GET /v1/entities/{entityId}/relationships
  * @endpoint GET /v1/entities/{entityId}/similar
  * @endpoint GET /v1/entities/{entityId}/similar/summary
  * @endpoint GET /v1/entities/relationships/{relationshipId}
  * @endpoint GET /v1/lookup-jobs/{jobId}
+ * @endpoint GET /v1/people/{personId}
  * @endpoint GET /v1/people/{personId}/graph
  * @endpoint GET /v1/search/link/jobs/{jobId}
  * @endpoint GET /v1/search/shared/{id}
@@ -24,6 +27,7 @@ import { z } from "zod/v4";
  * @endpoint POST /v1/entities/lookup-matches
  * @endpoint POST /v1/entities/search
  * @endpoint POST /v1/lookup-mentions
+ * @endpoint POST /v1/people/lookup-batch
  * @endpoint POST /v1/search
  * @endpoint POST /v1/search/natural/entities
  * @endpoint POST /v1/search/natural/people

package/dist/funding/stage.js

@@ -45,17 +45,20 @@ const FundingStageSchemaKnownMembers = z.enum([
  * @openapiSchema FundingStage
  * @endpoint GET /v1/entities
  * @endpoint GET /v1/entities/lookup-exact
+ * @endpoint GET /v1/people/lookup-exact
  * @endpoint GET /v1/search/link
  * @endpoint GET /v1/entities/{entityId}
  * @endpoint GET /v1/entities/{entityId}/fundraise-rounds
  * @endpoint GET /v1/entities/{entityId}/fundraise-rounds/{fundraiseRoundId}
  * @endpoint GET /v1/entities/{entityId}/investments
  * @endpoint GET /v1/entities/{entityId}/investors
+ * @endpoint GET /v1/entities/{entityId}/person-investors
  * @endpoint GET /v1/entities/{entityId}/relationships
  * @endpoint GET /v1/entities/{entityId}/similar
  * @endpoint GET /v1/entities/{entityId}/similar/summary
  * @endpoint GET /v1/entities/relationships/{relationshipId}
  * @endpoint GET /v1/lookup-jobs/{jobId}
+ * @endpoint GET /v1/people/{personId}
  * @endpoint GET /v1/people/{personId}/graph
  * @endpoint GET /v1/search/link/jobs/{jobId}
  * @endpoint GET /v1/search/shared/{id}
@@ -64,6 +67,7 @@ const FundingStageSchemaKnownMembers = z.enum([
  * @endpoint POST /v1/entities/lookup-matches
  * @endpoint POST /v1/entities/search
  * @endpoint POST /v1/lookup-mentions
+ * @endpoint POST /v1/people/lookup-batch
  * @endpoint POST /v1/search
  * @endpoint POST /v1/search/natural/entities
  * @endpoint POST /v1/search/natural/people

package/dist/harness/task-input-type.d.ts

@@ -1,6 +1,6 @@
 import { z } from "zod/v4";
 /**
- * ENTITY binds a target entity to its canonical id through entity identification; TEXT is a literal value the request states.
+ * ENTITY binds a target entity to its canonical id through entity identification; TEXT is a literal value the request states; WRITER_BRIEF is the typed research analysis a prose writer composes from (claim ledger, positioning frame, paragraph plan).
  *
  * @openapiSchema HarnessTaskInputType
  * @endpoint POST /v1/agents/help
@@ -12,10 +12,12 @@ import { z } from "zod/v4";
 export declare const HarnessTaskInputTypeSchema: z.ZodUnion<readonly [z.ZodEnum<{
     ENTITY: "ENTITY";
     TEXT: "TEXT";
+    WRITER_BRIEF: "WRITER_BRIEF";
 }>, z.ZodString]> & {
     enum: {
         ENTITY: "ENTITY";
         TEXT: "TEXT";
+        WRITER_BRIEF: "WRITER_BRIEF";
     };
 };
 export type HarnessTaskInputType = z.infer<typeof HarnessTaskInputTypeSchema>;

package/dist/harness/task-input-type.js

@@ -1,8 +1,8 @@
 // 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 HarnessTaskInputTypeSchemaKnownMembers = z.enum(["ENTITY", "TEXT"]);
+const HarnessTaskInputTypeSchemaKnownMembers = z.enum(["ENTITY", "TEXT", "WRITER_BRIEF"]);
 /**
- * ENTITY binds a target entity to its canonical id through entity identification; TEXT is a literal value the request states.
+ * ENTITY binds a target entity to its canonical id through entity identification; TEXT is a literal value the request states; WRITER_BRIEF is the typed research analysis a prose writer composes from (claim ledger, positioning frame, paragraph plan).
  *
  * @openapiSchema HarnessTaskInputType
  * @endpoint POST /v1/agents/help

package/dist/harness/task-plan.d.ts

@@ -13,10 +13,12 @@ export declare const HarnessTaskPlanSchema: z.ZodObject<{
     catalogRevision: z.ZodOptional<z.ZodInt>;
     gateId: z.ZodOptional<z.ZodArray<z.ZodString>>;
     input: z.ZodArray<z.ZodType<{
+        allowedValue?: string | null | undefined;
         description: string;
         key: string;
         type: string;
     }, import("./task.ts").HarnessTaskSchemaInput, z.core.$ZodTypeInternals<{
+        allowedValue?: string | null | undefined;
         description: string;
         key: string;
         type: string;

package/dist/harness/task.d.ts

@@ -1,14 +1,17 @@
 import { z } from "zod/v4";
 declare const HarnessTaskSchemaDefinition: z.ZodObject<{
+    allowedValue: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     description: z.ZodString;
     key: z.ZodString;
     type: z.ZodUnion<readonly [z.ZodEnum<{
         ENTITY: "ENTITY";
         TEXT: "TEXT";
+        WRITER_BRIEF: "WRITER_BRIEF";
     }>, z.ZodString]> & {
         enum: {
             ENTITY: "ENTITY";
             TEXT: "TEXT";
+            WRITER_BRIEF: "WRITER_BRIEF";
         };
     };
 }, z.core.$strip>;

package/dist/harness/task.js

@@ -2,6 +2,8 @@
 import { z } from "zod/v4";
 import { HarnessTaskInputTypeSchema } from "./task-input-type.js";
 const HarnessTaskSchemaDefinition = z.object({
+    /** Optional exact literal accepted for a TEXT input; when present, the run and its mutation guard require this value instead of accepting an arbitrary string. */
+    allowedValue: z.string().nullish(),
     /** What the value is, written for the caller that supplies it. */
     description: z.string(),
     /** Input key, unique within its task. */

package/dist/help/resolution.d.ts

@@ -34,10 +34,12 @@ export declare const HelpResolutionSchema: z.ZodObject<{
         catalogRevision: z.ZodOptional<z.ZodInt>;
         gateId: z.ZodOptional<z.ZodArray<z.ZodString>>;
         input: z.ZodArray<z.ZodType<{
+            allowedValue?: string | null | undefined;
             description: string;
             key: string;
             type: string;
         }, import("../harness/task.ts").HarnessTaskSchemaInput, z.core.$ZodTypeInternals<{
+            allowedValue?: string | null | undefined;
             description: string;
             key: string;
             type: string;

package/dist/http/problem-detail.d.ts

@@ -214,6 +214,10 @@ declare const ProblemDetailSchemaDefinition: z.ZodObject<{
         conflictingArticleTitle: string;
         conflictType: string;
     }, import("../news/source-url-conflict.ts").NewsSourceUrlConflictSchemaInput>>]>>>;
+    disposition: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+        TERMINAL: "TERMINAL";
+        TRANSIENT: "TRANSIENT";
+    }>>>;
     error: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>>;
     existingRecordId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     existingRedirect: z.ZodOptional<z.ZodNullable<z.ZodObject<{

package/dist/http/problem-detail.js

@@ -164,6 +164,8 @@ const ProblemDetailSchemaDefinition = z.object({
     detail: z.string().optional(),
     /** Structured conflict details. A possible duplicate or an ambiguous lookup returns its candidate records; score and threshold rank the candidates and do not prove that the requested record is absent. */
     details: DomainConflictDetailsSchema.nullish(),
+    /** Whether a service-unavailable failure can be retried. */
+    disposition: z.enum(["TRANSIENT", "TERMINAL"]).nullish(),
     error: z.record(z.string(), z.string()).nullish(),
     /** On a duplicate 409, the id of the stored record the request collided with; read or update that record instead of creating it again. Absent when the conflict names no single stored record. */
     existingRecordId: z.string().nullish(),

package/dist/identification/identification.d.ts

@@ -200,6 +200,25 @@ export declare const IdentificationSchema: z.ZodObject<{
         NEEDS_REVIEW: "NEEDS_REVIEW";
         NO_MATCH: "NO_MATCH";
     }>;
+    urlHostForm: z.ZodArray<z.ZodType<{
+        concluded: boolean;
+        crawlCdnProvider?: "akamai" | "awsCloudfront" | "azureCdn" | "bunny" | "cdn77" | "cdnetworks" | "cloudflare" | "digitalocean" | "fastly" | "gcore" | "googlecloudCdn" | "incapsula" | "keycdn" | "leaseweb" | "netlify" | "none" | "stackpath" | "sucuri" | "unknown" | "vercel" | null | undefined;
+        crawlRenderMode?: "jsEnhanced" | "jsRequired" | "static" | null | undefined;
+        landingHost?: string | null | undefined;
+        outcome?: "noResponse" | "refusal" | "rejection" | "success" | "transient" | null | undefined;
+        status?: string | null | undefined;
+        submittedUrl: string;
+        url: string;
+    }, import("../url/host-form-resolution.ts").UrlHostFormResolutionSchemaInput, z.core.$ZodTypeInternals<{
+        concluded: boolean;
+        crawlCdnProvider?: "akamai" | "awsCloudfront" | "azureCdn" | "bunny" | "cdn77" | "cdnetworks" | "cloudflare" | "digitalocean" | "fastly" | "gcore" | "googlecloudCdn" | "incapsula" | "keycdn" | "leaseweb" | "netlify" | "none" | "stackpath" | "sucuri" | "unknown" | "vercel" | null | undefined;
+        crawlRenderMode?: "jsEnhanced" | "jsRequired" | "static" | null | undefined;
+        landingHost?: string | null | undefined;
+        outcome?: "noResponse" | "refusal" | "rejection" | "success" | "transient" | null | undefined;
+        status?: string | null | undefined;
+        submittedUrl: string;
+        url: string;
+    }, import("../url/host-form-resolution.ts").UrlHostFormResolutionSchemaInput>>>;
 }, z.core.$strip>;
 export type Identification = z.infer<typeof IdentificationSchema>;
 //# sourceMappingURL=identification.d.ts.map

package/dist/identification/identification.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 { IdentificationCandidateSchema } from "./candidate.js";
+import { UrlHostFormResolutionSchema } from "../url/host-form-resolution.js";
 /**
  * Which existing entity or person satisfies the requested identity, type, and provider scope, how that was settled, and the candidates considered, most probable first.
  *
@@ -19,13 +20,13 @@ import { IdentificationCandidateSchema } from "./candidate.js";
 export const IdentificationSchema = z.object({
     /** Records considered, most probable first. */
     candidate: z.array(IdentificationCandidateSchema),
-    /** With fileOnMiss=true, the new record this NO_MATCH created, or the existing one that already held its website. Absent otherwise. */
+    /** The new unpublished record a NO_MATCH subject with a proven own site was added as, or the existing one that already held its website. Absent otherwise. */
     created: IdentificationCandidateSchema.nullish(),
     /** One sentence naming what settled the answer or what the user must decide. */
     detail: z.string(),
     /** Other records that appear to describe the same subject as match. Empty when none were found. */
     duplicate: z.array(IdentificationCandidateSchema),
-    /** Research request filed for the created record; absent without created, and when the record is already public. */
+    /** Research request filed for the created record; absent without created, when the lookup did not request research on it, and when the record is already public. */
     enrichmentRunId: z.uuid().nullish(),
     /** true when the match was settled on a second, slower review; confirm it before relying on it. Absent otherwise. */
     languageModelSettled: z.boolean().nullish(),
@@ -35,5 +36,7 @@ export const IdentificationSchema = z.object({
     officialUrl: z.string().nullish(),
     /** Use the scoped match, record scoped absence, or refine an ambiguous identity with evidence. */
     status: z.enum(["MATCHED", "NO_MATCH", "NEEDS_REVIEW"]),
+    /** Fresh backend URL evidence gathered when verifyUrl=true; empty otherwise. */
+    urlHostForm: z.array(UrlHostFormResolutionSchema),
 });
 //# sourceMappingURL=identification.js.map

package/dist/identification/subject.d.ts

@@ -22,6 +22,11 @@ export declare const IdentificationSubjectSchema: z.ZodObject<{
     location: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     providerId: z.ZodOptional<z.ZodNullable<z.ZodUUID>>;
+    sourceIdentifier: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        identifier: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        idType: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        source: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strip>>>;
     sourceNewsId: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
     sourceUrl: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     typeRecord: z.ZodOptional<z.ZodNullable<z.ZodEnum<{

package/dist/identification/subject.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 { EntityTypeSchema } from "../entity/type.js";
+import { UniqueIdMutationSchema } from "../unique/id-mutation.js";
 /**
  * The company, Product, Service, or person to identify. Send the name, a URL it owns, or both, plus every location and source you have; a website or profile URL usually settles the answer without any model call.
  *
@@ -26,6 +27,8 @@ export const IdentificationSubjectSchema = z.object({
     name: z.string().max(200).nullish(),
     /** Provider entity id for a Product or Service lookup. Omit it when the provider is unknown. With no typeRecord, searches both Product and Service. Invalid for a company type or a person lookup. */
     providerId: z.uuid().nullish(),
+    /** Internal permanent Folk source identity. Requires private visibility and resolves before names or URLs. */
+    sourceIdentifier: UniqueIdMutationSchema.nullish(),
     /** aVenture news id of the article that mentions the subject; an unknown id is a 400. */
     sourceNewsId: z.int().nullish(),
     /** URL of the article that mentions the subject; read from aVenture news when stored there, otherwise fetched. */