@aventurevc/api-schemas 0.8.42 → 0.8.44

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

@@ -19,6 +19,12 @@ declare const ProblemDetailSchemaDefinition: z.ZodObject<{
         JOBRUNR_STORAGE_UNAVAILABLE: "JOBRUNR_STORAGE_UNAVAILABLE";
         billing_additional_usage_cap_reached: "billing_additional_usage_cap_reached";
         billing_allowance_exhausted: "billing_allowance_exhausted";
+        callback_challenge_failed: "callback_challenge_failed";
+        callback_connection_refused: "callback_connection_refused";
+        callback_http_4xx: "callback_http_4xx";
+        callback_http_5xx: "callback_http_5xx";
+        callback_timeout: "callback_timeout";
+        callback_tls_error: "callback_tls_error";
         frontend_cache_epoch_mode_not_targeted: "frontend_cache_epoch_mode_not_targeted";
         geocode_provider_error: "geocode_provider_error";
         github_fetch_failed: "github_fetch_failed";
@@ -40,6 +46,7 @@ declare const ProblemDetailSchemaDefinition: z.ZodObject<{
         news_rss_article_fetch_failed: "news_rss_article_fetch_failed";
         news_rss_feed_fetch_failed: "news_rss_feed_fetch_failed";
         news_similarity_embedding_unavailable: "news_similarity_embedding_unavailable";
+        news_subscription_limit: "news_subscription_limit";
         not_authorized: "not_authorized";
         origin_detail_capacity: "origin_detail_capacity";
         origin_detail_shutdown: "origin_detail_shutdown";

package/dist/http/problem-detail.js

@@ -85,6 +85,20 @@ const ProblemDetailSchemaDefinition = z.object({
             "news_rss_feed_fetch_failed",
             /** RSS news-ingest article page fetch failed after retries or with the breaker open. Agent action: inspect the source article URL and upstream status; the ingest job may skip that article. */
             "news_rss_article_fetch_failed",
+            /** News subscription webhook verification could not connect to delivery.url. Agent action: confirm the endpoint is publicly reachable over https, then subscribe again. */
+            "callback_connection_refused",
+            /** News subscription webhook verification timed out. Agent action: make the endpoint answer the challenge within the delivery read timeout, then subscribe again. */
+            "callback_timeout",
+            /** News subscription webhook verification failed the TLS handshake. Agent action: serve a publicly trusted certificate for the delivery.url host, then subscribe again. */
+            "callback_tls_error",
+            /** News subscription webhook verification got a 4xx answer. Agent action: make the endpoint accept the signed verification POST, then subscribe again. */
+            "callback_http_4xx",
+            /** News subscription webhook verification got a 5xx answer. Agent action: fix or wait for the endpoint, then subscribe again. */
+            "callback_http_5xx",
+            /** News subscription webhook verification got a 2xx answer whose body was not {"challenge":"<nonce>"} with the sent nonce. Agent action: echo the challenge exactly, then subscribe again. */
+            "callback_challenge_failed",
+            /** Caller already holds the maximum number of news subscriptions. Agent action: unsubscribe one before subscribing again. */
+            "news_subscription_limit",
             /** Cloudflare R2 object fetch failed during a read operation. Agent action: retry once with backoff; persistent failure indicates R2 outage or asset deletion. */
             "r2_fetch_failed",
             /** Cloudflare R2 object delete failed during a cleanup operation. Agent action: surface; retrying may produce duplicate-delete errors. */

package/dist/job/enqueue.d.ts

@@ -9,6 +9,7 @@ type JobEnqueueDefinition = z.infer<typeof JobEnqueueSchemaDefinition>;
  * Accepted asynchronous app job enqueue response.
  *
  * @openapiSchema JobEnqueue
+ * @endpoint GET /v1/web/searches/jobs/{jobId}
  * @endpoint POST /v1/lookup-jobs
  * @contractShape job.enqueue
  * @contractRole canonical

package/dist/job/enqueue.js

@@ -10,6 +10,7 @@ const JobEnqueueSchemaDefinition = z.object({
  * Accepted asynchronous app job enqueue response.
  *
  * @openapiSchema JobEnqueue
+ * @endpoint GET /v1/web/searches/jobs/{jobId}
  * @endpoint POST /v1/lookup-jobs
  * @contractShape job.enqueue
  * @contractRole canonical

package/dist/news/news.d.ts

@@ -35,6 +35,7 @@ type NewsDefinition = z.infer<typeof NewsSchemaDefinition>;
  * @endpoint POST /v1/search/all
  * @usedBySchema EntityDetailSchema
  * @usedBySchema NewsDetailSchema
+ * @usedBySchema NewsPublishedEventSchema
  * @usedBySchema PageNewsSchema
  * @usedBySchema PageResultNewsSchema
  * @usedBySchema PersonGraphCareerContextSchema

package/dist/news/news.js

@@ -43,6 +43,7 @@ const NewsSchemaDefinition = z.object({
  * @endpoint POST /v1/search/all
  * @usedBySchema EntityDetailSchema
  * @usedBySchema NewsDetailSchema
+ * @usedBySchema NewsPublishedEventSchema
  * @usedBySchema PageNewsSchema
  * @usedBySchema PageResultNewsSchema
  * @usedBySchema PersonGraphCareerContextSchema

package/dist/news/published-event.d.ts

@@ -0,0 +1,52 @@
+import { z } from "zod/v4";
+declare const NewsPublishedEventSchemaDefinition: z.ZodObject<{
+    cursor: z.ZodString;
+    data: z.ZodType<{
+        author?: string | null | undefined;
+        category?: string | null | undefined;
+        createdAt?: string | null | undefined;
+        excerpt?: string | null | undefined;
+        externalNewsArticle?: boolean | null | undefined;
+        id: number;
+        newsImageThumbnail?: string | null | undefined;
+        newsUrlOriginal?: string | null | undefined;
+        publication?: string | null | undefined;
+        publishedAt?: string | null | undefined;
+        slug?: string | null | undefined;
+        title: string;
+        updatedAt?: string | null | undefined;
+    }, unknown, z.core.$ZodTypeInternals<{
+        author?: string | null | undefined;
+        category?: string | null | undefined;
+        createdAt?: string | null | undefined;
+        excerpt?: string | null | undefined;
+        externalNewsArticle?: boolean | null | undefined;
+        id: number;
+        newsImageThumbnail?: string | null | undefined;
+        newsUrlOriginal?: string | null | undefined;
+        publication?: string | null | undefined;
+        publishedAt?: string | null | undefined;
+        slug?: string | null | undefined;
+        title: string;
+        updatedAt?: string | null | undefined;
+    }, unknown>>;
+    eventId: z.ZodString;
+    name: z.ZodEnum<{
+        "entity.news.published": "entity.news.published";
+    }>;
+    timestamp: z.ZodISODateTime;
+}, z.core.$strip>;
+type NewsPublishedEventDefinition = z.infer<typeof NewsPublishedEventSchemaDefinition>;
+/**
+ * Webhook POST body for one news article newly linked to the subscribed entity.
+ *
+ * @openapiSchema NewsPublishedEvent
+ * @usedByEndpoint none:external-root
+ * @shared composition:used as building block for other schemas news.published-event; not direct because nested fragment composes parent endpoint contracts
+ * @contractShape news.published-event
+ * @contractRole canonical
+ */
+export declare const NewsPublishedEventSchema: z.ZodType<NewsPublishedEventDefinition>;
+export type NewsPublishedEvent = z.infer<typeof NewsPublishedEventSchema>;
+export {};
+//# sourceMappingURL=published-event.d.ts.map

package/dist/news/published-event.js

@@ -0,0 +1,25 @@
+// 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 { NewsSchema } from "./news.js";
+import { NewsSubscriptionEventSchema } from "./subscription-event.js";
+const NewsPublishedEventSchemaDefinition = z.object({
+    /** Opaque watermark to resume after this event. */
+    cursor: z.string(),
+    data: NewsSchema,
+    /** Deterministic event id, equal to the webhook-id header. */
+    eventId: z.string(),
+    name: NewsSubscriptionEventSchema,
+    /** When the article was linked to the entity. */
+    timestamp: z.iso.datetime({ offset: true }),
+});
+/**
+ * Webhook POST body for one news article newly linked to the subscribed entity.
+ *
+ * @openapiSchema NewsPublishedEvent
+ * @usedByEndpoint none:external-root
+ * @shared composition:used as building block for other schemas news.published-event; not direct because nested fragment composes parent endpoint contracts
+ * @contractShape news.published-event
+ * @contractRole canonical
+ */
+export const NewsPublishedEventSchema = NewsPublishedEventSchemaDefinition;
+//# sourceMappingURL=published-event.js.map

package/dist/news/subscription-arguments.d.ts

@@ -0,0 +1,20 @@
+import { z } from "zod/v4";
+declare const NewsSubscriptionArgumentsSchemaDefinition: z.ZodObject<{
+    entityId: z.ZodUUID;
+}, z.core.$strip>;
+type NewsSubscriptionArgumentsDefinition = z.infer<typeof NewsSubscriptionArgumentsSchemaDefinition>;
+/**
+ * Arguments of the entity.news.published event.
+ *
+ * @openapiSchema NewsSubscriptionArguments
+ * @endpoint PUT /v1/news/subscriptions
+ * @endpoint DELETE /v1/news/subscriptions
+ * @usedBySchema NewsSubscriptionKeySchema
+ * @usedBySchema NewsSubscriptionSchema
+ * @contractShape news.subscription-arguments
+ * @contractRole canonical
+ */
+export declare const NewsSubscriptionArgumentsSchema: z.ZodType<NewsSubscriptionArgumentsDefinition>;
+export type NewsSubscriptionArguments = z.infer<typeof NewsSubscriptionArgumentsSchema>;
+export {};
+//# sourceMappingURL=subscription-arguments.d.ts.map

package/dist/news/subscription-arguments.js

@@ -0,0 +1,19 @@
+// 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 NewsSubscriptionArgumentsSchemaDefinition = z.object({
+    /** Entity whose newly linked public news is delivered. */
+    entityId: z.uuid(),
+});
+/**
+ * Arguments of the entity.news.published event.
+ *
+ * @openapiSchema NewsSubscriptionArguments
+ * @endpoint PUT /v1/news/subscriptions
+ * @endpoint DELETE /v1/news/subscriptions
+ * @usedBySchema NewsSubscriptionKeySchema
+ * @usedBySchema NewsSubscriptionSchema
+ * @contractShape news.subscription-arguments
+ * @contractRole canonical
+ */
+export const NewsSubscriptionArgumentsSchema = NewsSubscriptionArgumentsSchemaDefinition;
+//# sourceMappingURL=subscription-arguments.js.map

package/dist/news/subscription-delivery-mode.d.ts

@@ -0,0 +1,15 @@
+import { z } from "zod/v4";
+/**
+ * Event delivery mode
+ *
+ * @openapiSchema NewsSubscriptionDeliveryMode
+ * @endpoint PUT /v1/news/subscriptions
+ * @usedBySchema NewsSubscriptionDeliverySchema
+ * @contractShape news.subscription-delivery-mode
+ * @contractRole canonical
+ */
+export declare const NewsSubscriptionDeliveryModeSchema: z.ZodEnum<{
+    webhook: "webhook";
+}>;
+export type NewsSubscriptionDeliveryMode = z.infer<typeof NewsSubscriptionDeliveryModeSchema>;
+//# sourceMappingURL=subscription-delivery-mode.d.ts.map

package/dist/news/subscription-delivery-mode.js

@@ -0,0 +1,13 @@
+// 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";
+/**
+ * Event delivery mode
+ *
+ * @openapiSchema NewsSubscriptionDeliveryMode
+ * @endpoint PUT /v1/news/subscriptions
+ * @usedBySchema NewsSubscriptionDeliverySchema
+ * @contractShape news.subscription-delivery-mode
+ * @contractRole canonical
+ */
+export const NewsSubscriptionDeliveryModeSchema = z.enum(["webhook"]);
+//# sourceMappingURL=subscription-delivery-mode.js.map

package/dist/news/subscription-delivery.d.ts

@@ -0,0 +1,22 @@
+import { z } from "zod/v4";
+declare const NewsSubscriptionDeliverySchemaDefinition: z.ZodObject<{
+    mode: z.ZodEnum<{
+        webhook: "webhook";
+    }>;
+    secret: z.ZodString;
+    url: z.ZodString;
+}, z.core.$strip>;
+type NewsSubscriptionDeliveryDefinition = z.infer<typeof NewsSubscriptionDeliverySchemaDefinition>;
+/**
+ * Webhook delivery target and secret.
+ *
+ * @openapiSchema NewsSubscriptionDelivery
+ * @endpoint PUT /v1/news/subscriptions
+ * @usedBySchema NewsSubscriptionSchema
+ * @contractShape news.subscription-delivery
+ * @contractRole canonical
+ */
+export declare const NewsSubscriptionDeliverySchema: z.ZodType<NewsSubscriptionDeliveryDefinition>;
+export type NewsSubscriptionDelivery = z.infer<typeof NewsSubscriptionDeliverySchema>;
+export {};
+//# sourceMappingURL=subscription-delivery.d.ts.map

package/dist/news/subscription-delivery.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";
+import { NewsSubscriptionDeliveryModeSchema } from "./subscription-delivery-mode.js";
+const NewsSubscriptionDeliverySchemaDefinition = z.object({
+    mode: NewsSubscriptionDeliveryModeSchema,
+    /** Standard Webhooks signing secret: whsec_ followed by base64 of 24 to 64 bytes. It is never returned. The CLI reads it only from --from-file, never a flag. */
+    secret: z.string(),
+    /** Public https endpoint that receives signed event POSTs. */
+    url: z.string().max(2048),
+});
+/**
+ * Webhook delivery target and secret.
+ *
+ * @openapiSchema NewsSubscriptionDelivery
+ * @endpoint PUT /v1/news/subscriptions
+ * @usedBySchema NewsSubscriptionSchema
+ * @contractShape news.subscription-delivery
+ * @contractRole canonical
+ */
+export const NewsSubscriptionDeliverySchema = NewsSubscriptionDeliverySchemaDefinition;
+//# sourceMappingURL=subscription-delivery.js.map

package/dist/news/subscription-endpoint.d.ts

@@ -0,0 +1,18 @@
+import { z } from "zod/v4";
+declare const NewsSubscriptionEndpointSchemaDefinition: z.ZodObject<{
+    url: z.ZodString;
+}, z.core.$strip>;
+type NewsSubscriptionEndpointDefinition = z.infer<typeof NewsSubscriptionEndpointSchemaDefinition>;
+/**
+ * Webhook delivery target.
+ *
+ * @openapiSchema NewsSubscriptionEndpoint
+ * @endpoint DELETE /v1/news/subscriptions
+ * @usedBySchema NewsSubscriptionKeySchema
+ * @contractShape news.subscription-endpoint
+ * @contractRole canonical
+ */
+export declare const NewsSubscriptionEndpointSchema: z.ZodType<NewsSubscriptionEndpointDefinition>;
+export type NewsSubscriptionEndpoint = z.infer<typeof NewsSubscriptionEndpointSchema>;
+export {};
+//# sourceMappingURL=subscription-endpoint.d.ts.map

package/dist/news/subscription-endpoint.js

@@ -0,0 +1,16 @@
+// 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 NewsSubscriptionEndpointSchemaDefinition = z.object({
+    url: z.string(),
+});
+/**
+ * Webhook delivery target.
+ *
+ * @openapiSchema NewsSubscriptionEndpoint
+ * @endpoint DELETE /v1/news/subscriptions
+ * @usedBySchema NewsSubscriptionKeySchema
+ * @contractShape news.subscription-endpoint
+ * @contractRole canonical
+ */
+export const NewsSubscriptionEndpointSchema = NewsSubscriptionEndpointSchemaDefinition;
+//# sourceMappingURL=subscription-endpoint.js.map

package/dist/news/subscription-event.d.ts

@@ -0,0 +1,18 @@
+import { z } from "zod/v4";
+/**
+ * Subscribable event name
+ *
+ * @openapiSchema NewsSubscriptionEvent
+ * @endpoint PUT /v1/news/subscriptions
+ * @endpoint DELETE /v1/news/subscriptions
+ * @usedBySchema NewsPublishedEventSchema
+ * @usedBySchema NewsSubscriptionKeySchema
+ * @usedBySchema NewsSubscriptionSchema
+ * @contractShape news.subscription-event
+ * @contractRole canonical
+ */
+export declare const NewsSubscriptionEventSchema: z.ZodEnum<{
+    "entity.news.published": "entity.news.published";
+}>;
+export type NewsSubscriptionEvent = z.infer<typeof NewsSubscriptionEventSchema>;
+//# sourceMappingURL=subscription-event.d.ts.map

package/dist/news/subscription-event.js

@@ -0,0 +1,16 @@
+// 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";
+/**
+ * Subscribable event name
+ *
+ * @openapiSchema NewsSubscriptionEvent
+ * @endpoint PUT /v1/news/subscriptions
+ * @endpoint DELETE /v1/news/subscriptions
+ * @usedBySchema NewsPublishedEventSchema
+ * @usedBySchema NewsSubscriptionKeySchema
+ * @usedBySchema NewsSubscriptionSchema
+ * @contractShape news.subscription-event
+ * @contractRole canonical
+ */
+export const NewsSubscriptionEventSchema = z.enum(["entity.news.published"]);
+//# sourceMappingURL=subscription-event.js.map

package/dist/news/subscription-grant.d.ts

@@ -0,0 +1,20 @@
+import { z } from "zod/v4";
+declare const NewsSubscriptionGrantSchemaDefinition: z.ZodObject<{
+    cursor: z.ZodString;
+    id: z.ZodString;
+    refreshBefore: z.ZodISODateTime;
+    truncated: z.ZodBoolean;
+}, z.core.$strip>;
+type NewsSubscriptionGrantDefinition = z.infer<typeof NewsSubscriptionGrantSchemaDefinition>;
+/**
+ * Granted news subscription.
+ *
+ * @openapiSchema NewsSubscriptionGrant
+ * @endpoint PUT /v1/news/subscriptions
+ * @contractShape news.subscription-grant
+ * @contractRole canonical
+ */
+export declare const NewsSubscriptionGrantSchema: z.ZodType<NewsSubscriptionGrantDefinition>;
+export type NewsSubscriptionGrant = z.infer<typeof NewsSubscriptionGrantSchema>;
+export {};
+//# sourceMappingURL=subscription-grant.d.ts.map

package/dist/news/subscription-grant.js

@@ -0,0 +1,22 @@
+// 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 NewsSubscriptionGrantSchemaDefinition = z.object({
+    /** Opaque watermark the subscription delivers after. */
+    cursor: z.string(),
+    /** Stable subscription id; sent as X-MCP-Subscription-Id. */
+    id: z.string(),
+    /** The subscription expires unless refreshed before this instant. */
+    refreshBefore: z.iso.datetime({ offset: true }),
+    /** Whether events between the requested cursor and now were lost. */
+    truncated: z.boolean(),
+});
+/**
+ * Granted news subscription.
+ *
+ * @openapiSchema NewsSubscriptionGrant
+ * @endpoint PUT /v1/news/subscriptions
+ * @contractShape news.subscription-grant
+ * @contractRole canonical
+ */
+export const NewsSubscriptionGrantSchema = NewsSubscriptionGrantSchemaDefinition;
+//# sourceMappingURL=subscription-grant.js.map

package/dist/news/subscription-key.d.ts

@@ -0,0 +1,29 @@
+import { z } from "zod/v4";
+declare const NewsSubscriptionKeySchemaDefinition: z.ZodObject<{
+    arguments: z.ZodType<{
+        entityId: string;
+    }, unknown, z.core.$ZodTypeInternals<{
+        entityId: string;
+    }, unknown>>;
+    delivery: z.ZodType<{
+        url: string;
+    }, unknown, z.core.$ZodTypeInternals<{
+        url: string;
+    }, unknown>>;
+    name: z.ZodEnum<{
+        "entity.news.published": "entity.news.published";
+    }>;
+}, z.core.$strip>;
+type NewsSubscriptionKeyDefinition = z.infer<typeof NewsSubscriptionKeySchemaDefinition>;
+/**
+ * Identifies one subscription to remove by its event name, arguments, and url.
+ *
+ * @openapiSchema NewsSubscriptionKey
+ * @endpoint DELETE /v1/news/subscriptions
+ * @contractShape news.subscription-key
+ * @contractRole canonical
+ */
+export declare const NewsSubscriptionKeySchema: z.ZodType<NewsSubscriptionKeyDefinition>;
+export type NewsSubscriptionKey = z.infer<typeof NewsSubscriptionKeySchema>;
+export {};
+//# sourceMappingURL=subscription-key.d.ts.map

package/dist/news/subscription-key.js

@@ -0,0 +1,20 @@
+// 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 { NewsSubscriptionArgumentsSchema } from "./subscription-arguments.js";
+import { NewsSubscriptionEndpointSchema } from "./subscription-endpoint.js";
+import { NewsSubscriptionEventSchema } from "./subscription-event.js";
+const NewsSubscriptionKeySchemaDefinition = z.object({
+    arguments: NewsSubscriptionArgumentsSchema,
+    delivery: NewsSubscriptionEndpointSchema,
+    name: NewsSubscriptionEventSchema,
+});
+/**
+ * Identifies one subscription to remove by its event name, arguments, and url.
+ *
+ * @openapiSchema NewsSubscriptionKey
+ * @endpoint DELETE /v1/news/subscriptions
+ * @contractShape news.subscription-key
+ * @contractRole canonical
+ */
+export const NewsSubscriptionKeySchema = NewsSubscriptionKeySchemaDefinition;
+//# sourceMappingURL=subscription-key.js.map

package/dist/news/subscription.d.ts

@@ -0,0 +1,35 @@
+import { z } from "zod/v4";
+declare const NewsSubscriptionSchemaDefinition: z.ZodObject<{
+    arguments: z.ZodType<{
+        entityId: string;
+    }, unknown, z.core.$ZodTypeInternals<{
+        entityId: string;
+    }, unknown>>;
+    cursor: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    delivery: z.ZodType<{
+        mode: "webhook";
+        secret: string;
+        url: string;
+    }, unknown, z.core.$ZodTypeInternals<{
+        mode: "webhook";
+        secret: string;
+        url: string;
+    }, unknown>>;
+    name: z.ZodEnum<{
+        "entity.news.published": "entity.news.published";
+    }>;
+    ttlMs: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+}, z.core.$strip>;
+type NewsSubscriptionDefinition = z.infer<typeof NewsSubscriptionSchemaDefinition>;
+/**
+ * Subscribe or refresh one webhook subscription to news newly linked to an entity. The same caller, delivery url, event name, and arguments always address the same subscription, so repeating the call refreshes it.
+ *
+ * @openapiSchema NewsSubscription
+ * @endpoint PUT /v1/news/subscriptions
+ * @contractShape news.subscription
+ * @contractRole canonical
+ */
+export declare const NewsSubscriptionSchema: z.ZodType<NewsSubscriptionDefinition>;
+export type NewsSubscription = z.infer<typeof NewsSubscriptionSchema>;
+export {};
+//# sourceMappingURL=subscription.d.ts.map

package/dist/news/subscription.js

@@ -0,0 +1,24 @@
+// 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 { NewsSubscriptionArgumentsSchema } from "./subscription-arguments.js";
+import { NewsSubscriptionDeliverySchema } from "./subscription-delivery.js";
+import { NewsSubscriptionEventSchema } from "./subscription-event.js";
+const NewsSubscriptionSchemaDefinition = z.object({
+    arguments: NewsSubscriptionArgumentsSchema,
+    /** Opaque watermark from an earlier grant or event to resume after; null starts a new subscription from now and keeps an existing subscription's position. */
+    cursor: z.string().nullish(),
+    delivery: NewsSubscriptionDeliverySchema,
+    name: NewsSubscriptionEventSchema,
+    /** Requested subscription lifetime in milliseconds; the server caps it. */
+    ttlMs: z.number().int().min(1).nullish(),
+});
+/**
+ * Subscribe or refresh one webhook subscription to news newly linked to an entity. The same caller, delivery url, event name, and arguments always address the same subscription, so repeating the call refreshes it.
+ *
+ * @openapiSchema NewsSubscription
+ * @endpoint PUT /v1/news/subscriptions
+ * @contractShape news.subscription
+ * @contractRole canonical
+ */
+export const NewsSubscriptionSchema = NewsSubscriptionSchemaDefinition;
+//# sourceMappingURL=subscription.js.map

package/dist/openapi-component-manifest.js

@@ -537,6 +537,10 @@ export const OPENAPI_COMPONENT_MANIFEST = Object.freeze({
         schemaName: "NewsFeedbackAcknowledgementSchema",
     },
     NewsMatchStatus: { modulePath: "news/match-status", schemaName: "NewsMatchStatusSchema" },
+    NewsPublishedEvent: {
+        modulePath: "news/published-event",
+        schemaName: "NewsPublishedEventSchema",
+    },
     NewsResolvedEntityLink: {
         modulePath: "news/resolved-entity-link",
         schemaName: "NewsResolvedEntityLinkSchema",
@@ -549,6 +553,35 @@ export const OPENAPI_COMPONENT_MANIFEST = Object.freeze({
         modulePath: "news/source-url-conflict",
         schemaName: "NewsSourceUrlConflictSchema",
     },
+    NewsSubscription: { modulePath: "news/subscription", schemaName: "NewsSubscriptionSchema" },
+    NewsSubscriptionArguments: {
+        modulePath: "news/subscription-arguments",
+        schemaName: "NewsSubscriptionArgumentsSchema",
+    },
+    NewsSubscriptionDelivery: {
+        modulePath: "news/subscription-delivery",
+        schemaName: "NewsSubscriptionDeliverySchema",
+    },
+    NewsSubscriptionDeliveryMode: {
+        modulePath: "news/subscription-delivery-mode",
+        schemaName: "NewsSubscriptionDeliveryModeSchema",
+    },
+    NewsSubscriptionEndpoint: {
+        modulePath: "news/subscription-endpoint",
+        schemaName: "NewsSubscriptionEndpointSchema",
+    },
+    NewsSubscriptionEvent: {
+        modulePath: "news/subscription-event",
+        schemaName: "NewsSubscriptionEventSchema",
+    },
+    NewsSubscriptionGrant: {
+        modulePath: "news/subscription-grant",
+        schemaName: "NewsSubscriptionGrantSchema",
+    },
+    NewsSubscriptionKey: {
+        modulePath: "news/subscription-key",
+        schemaName: "NewsSubscriptionKeySchema",
+    },
     PageableObject: { modulePath: "pageable/object", schemaName: "PageableObjectSchema" },
     PageBlogPost: { modulePath: "pagination/schemas", schemaName: "PageBlogPostSchema" },
     PageClassification: {

package/dist/search/hit.d.ts

@@ -10,6 +10,7 @@ type SearchHitDefinition = z.infer<typeof SearchHitSchemaDefinition>;
  * One normalized web-search hit with its title, URL, snippet, and relevance score
  *
  * @openapiSchema SearchHit
+ * @endpoint GET /v1/web/searches/jobs/{jobId}
  * @endpoint POST /v1/web/search
  * @usedBySchema WebSearchSchema
  * @contractShape search.hit

package/dist/search/hit.js

@@ -10,6 +10,7 @@ const SearchHitSchemaDefinition = z.object({
  * One normalized web-search hit with its title, URL, snippet, and relevance score
  *
  * @openapiSchema SearchHit
+ * @endpoint GET /v1/web/searches/jobs/{jobId}
  * @endpoint POST /v1/web/search
  * @usedBySchema WebSearchSchema
  * @contractShape search.hit

package/dist/search/search.d.ts

@@ -13,6 +13,7 @@ type SearchDefinition = z.infer<typeof SearchSchemaDefinition>;
  * Live web search request with cache controls
  *
  * @openapiSchema Search
+ * @endpoint GET /v1/web/searches/jobs/{jobId}
  * @endpoint POST /v1/web/search
  * @usedBySchema WebSearchSchema
  * @contractShape search.search

package/dist/search/search.js

@@ -20,6 +20,7 @@ const SearchSchemaDefinition = z.object({
  * Live web search request with cache controls
  *
  * @openapiSchema Search
+ * @endpoint GET /v1/web/searches/jobs/{jobId}
  * @endpoint POST /v1/web/search
  * @usedBySchema WebSearchSchema
  * @contractShape search.search

package/dist/source/document-list.d.ts

@@ -20,6 +20,7 @@ type SourceDocumentListDefinition = z.infer<typeof SourceDocumentListSchemaDefin
  * Metadata-only ledger row for source-document lists
  *
  * @openapiSchema SourceDocumentList
+ * @endpoint GET /v1/web/searches/jobs/{jobId}
  * @endpoint POST /v1/web/search
  * @usedBySchema WebSearchSchema
  * @contractShape source.document-list

package/dist/source/document-list.js

@@ -22,6 +22,7 @@ const SourceDocumentListSchemaDefinition = z.object({
  * Metadata-only ledger row for source-document lists
  *
  * @openapiSchema SourceDocumentList
+ * @endpoint GET /v1/web/searches/jobs/{jobId}
  * @endpoint POST /v1/web/search
  * @usedBySchema WebSearchSchema
  * @contractShape source.document-list

package/dist/web/search.d.ts

@@ -65,6 +65,7 @@ type WebSearchDefinition = z.infer<typeof WebSearchSchemaDefinition>;
  * Live web search result with its backing source-document row and normalized items
  *
  * @openapiSchema WebSearch
+ * @endpoint GET /v1/web/searches/jobs/{jobId}
  * @endpoint POST /v1/web/search
  * @contractShape web.search
  * @contractRole canonical

package/dist/web/search.js

@@ -15,6 +15,7 @@ const WebSearchSchemaDefinition = z.object({
  * Live web search result with its backing source-document row and normalized items
  *
  * @openapiSchema WebSearch
+ * @endpoint GET /v1/web/searches/jobs/{jobId}
  * @endpoint POST /v1/web/search
  * @contractShape web.search
  * @contractRole canonical

package/package.json

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