@buildinternet/releases-api-types 0.51.0 → 0.52.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@buildinternet/releases-api-types",
-  "version": "0.51.0",
+  "version": "0.52.1",
   "description": "Wire protocol — request/response types for the Releases registry API. Shared by web, workers, and clients.",
   "type": "module",
   "license": "MIT",

package/src/api-types.ts

@@ -14,6 +14,13 @@ export type {
 import type { SourceType, SourceFetchPriority } from "@buildinternet/releases-core/source-enums";
 import type { ApiScope } from "@buildinternet/releases-core/api-token";
 import type { BreakingLevel } from "@buildinternet/releases-core/breaking";
+import type {
+  AiLaneIdSchema,
+  AiLaneModelsPutSchema,
+  AiLaneStateSchema,
+  OpenRouterCatalogModelSchema,
+  AiLaneModelsResponseSchema,
+} from "./schemas/ai-models.js";
 import type {
   MediaItemSchema,
   PaginationSchema,
@@ -67,6 +74,12 @@ import type {
   PatchWorkspaceProfileBodySchema,
   WorkspaceProfileResponseSchema,
 } from "./schemas/account-profile.js";
+import type {
+  UploadsIntegrationStatusSchema,
+  UploadsOAuthConnectResponseSchema,
+  UploadsOAuthCallbackBodySchema,
+  UploadsOAuthCallbackResponseSchema,
+} from "./schemas/workspace-integrations.js";
 import type {
   SourceListItemSchema,
   SourceWithOrgSchema,
@@ -203,6 +216,15 @@ import type {
   FeedbackUpdateBodySchema,
   FeedbackDeleteResponseSchema,
 } from "./schemas/feedback.js";
+import type {
+  ClassificationSummarySchema,
+  ClassificationRecentResponseSchema,
+  ClassificationRecentItemSchema,
+} from "./schemas/classifications.js";
+import type {
+  RecommendationNotifyAddedBodySchema,
+  RecommendationNotifyAddedResultSchema,
+} from "./schemas/recommendations.js";
 import type {
   SitemapSourceSchema,
   SitemapPayloadSchema,
@@ -280,6 +302,13 @@ export {
   NoticeSchema,
 } from "./schemas/shared.js";
 export { SiteNoticeSchema, SiteNoticeResponseSchema } from "./schemas/site-notice.js";
+export {
+  AiLaneIdSchema,
+  AiLaneModelsPutSchema,
+  AiLaneStateSchema,
+  OpenRouterCatalogModelSchema,
+  AiLaneModelsResponseSchema,
+} from "./schemas/ai-models.js";
 export {
   OrgListItemSchema,
   OrgListResponseSchema,
@@ -320,6 +349,12 @@ export {
   PatchWorkspaceProfileBodySchema,
   WorkspaceProfileResponseSchema,
 } from "./schemas/account-profile.js";
+export {
+  UploadsIntegrationStatusSchema,
+  UploadsOAuthConnectResponseSchema,
+  UploadsOAuthCallbackBodySchema,
+  UploadsOAuthCallbackResponseSchema,
+} from "./schemas/workspace-integrations.js";
 export {
   CreateStubOrgBodySchema,
   StubFromDomainBodySchema,
@@ -521,6 +556,15 @@ export {
   FeedbackUpdateBodySchema,
   FeedbackDeleteResponseSchema,
 } from "./schemas/feedback.js";
+export {
+  ClassificationSummarySchema,
+  ClassificationRecentResponseSchema,
+  ClassificationRecentItemSchema,
+} from "./schemas/classifications.js";
+export {
+  RecommendationNotifyAddedBodySchema,
+  RecommendationNotifyAddedResultSchema,
+} from "./schemas/recommendations.js";
 export {
   SitemapSourceSchema,
   SitemapPayloadSchema,
@@ -589,6 +633,12 @@ export type { ResolveResponse } from "./schemas/resolve.js";
 
 export type MediaItem = z.infer<typeof MediaItemSchema>;
 
+export type AiLaneId = z.infer<typeof AiLaneIdSchema>;
+export type AiLaneModelsPut = z.infer<typeof AiLaneModelsPutSchema>;
+export type AiLaneState = z.infer<typeof AiLaneStateSchema>;
+export type OpenRouterCatalogModel = z.infer<typeof OpenRouterCatalogModelSchema>;
+export type AiLaneModelsResponse = z.infer<typeof AiLaneModelsResponseSchema>;
+
 // ── Stub tier (#1947) ──
 
 export type OrgStatus = z.infer<typeof OrgStatusSchema>;
@@ -677,6 +727,10 @@ export type UploadAvatarResponse = z.infer<typeof UploadAvatarResponseSchema>;
 export type WorkspaceProfileFields = z.infer<typeof WorkspaceProfileFieldsSchema>;
 export type PatchWorkspaceProfileBody = z.infer<typeof PatchWorkspaceProfileBodySchema>;
 export type WorkspaceProfileResponse = z.infer<typeof WorkspaceProfileResponseSchema>;
+export type UploadsIntegrationStatus = z.infer<typeof UploadsIntegrationStatusSchema>;
+export type UploadsOAuthConnectResponse = z.infer<typeof UploadsOAuthConnectResponseSchema>;
+export type UploadsOAuthCallbackBody = z.infer<typeof UploadsOAuthCallbackBodySchema>;
+export type UploadsOAuthCallbackResponse = z.infer<typeof UploadsOAuthCallbackResponseSchema>;
 export type OrgDetail = z.infer<typeof OrgDetailSchema>;
 
 export type OrgCatalogItem = z.infer<typeof OrgCatalogItemSchema>;
@@ -869,6 +923,12 @@ export interface ProviderHealthResponse extends ListResponse<ProviderHealthSourc
     overdueOrgs: number;
     /** Distinct orgs represented among active sources. */
     totalOrgs: number;
+    /**
+     * Active sources that should still be polling but whose SourceActor mirror
+     * is unmanaged / missing `nextAlarmAt` (#2286). Independent of overdue
+     * last-check — a freshly fetched source can still have a dead alarm.
+     */
+    unmanagedActors: number;
   };
 }
 
@@ -1123,7 +1183,7 @@ export type UserWebhookScope = "org" | "follows";
 export type UserWebhookReleaseTypeFilter = "feature" | "rollup";
 
 /** Webhook delivery output format. */
-export type UserWebhookFormat = "json" | "slack";
+export type UserWebhookFormat = "json" | "slack" | "discord";
 
 /** A user-owned webhook subscription row (no signing secret). */
 export interface UserWebhookSubscription {
@@ -1170,7 +1230,7 @@ export interface UserWebhookListResponse {
   subscriptions: UserWebhookListItem[];
 }
 
-/** POST /v1/me/webhooks response — signing key shown once at creation (omitted for slack format). */
+/** POST /v1/me/webhooks response — signing key shown once at creation (omitted for slack/discord). */
 export interface CreateUserWebhookResponse
   extends UserWebhookSubscription, UserWebhookDeliveryHealth {
   orgSlug: string | null;
@@ -1197,7 +1257,7 @@ export interface WebhookDeliveryRow {
   error_message?: string | null;
   error_code?: string | null;
   outcome?: string;
-  /** Delivery format — "json" (signed raw event) or "slack" (Block Kit). Empty on pre-format rows. */
+  /** Delivery format — "json" (signed raw event) or a chat card (`slack` / `discord`). Empty on pre-format rows. */
   format?: UserWebhookFormat | "";
   http_status?: number;
   latency_ms?: number;
@@ -1705,6 +1765,15 @@ export type FeedbackListResponse = z.infer<typeof FeedbackListResponseSchema>;
 export type FeedbackUpdateBody = z.infer<typeof FeedbackUpdateBodySchema>;
 export type FeedbackDeleteResponse = z.infer<typeof FeedbackDeleteResponseSchema>;
 
+// ── Classification analytics ──
+export type ClassificationSummary = z.infer<typeof ClassificationSummarySchema>;
+export type ClassificationRecentResponse = z.infer<typeof ClassificationRecentResponseSchema>;
+export type ClassificationRecentItem = z.infer<typeof ClassificationRecentItemSchema>;
+
+// ── Recommendations ──
+export type RecommendationNotifyAddedBody = z.infer<typeof RecommendationNotifyAddedBodySchema>;
+export type RecommendationNotifyAddedResult = z.infer<typeof RecommendationNotifyAddedResultSchema>;
+
 // ── Fetch log ──
 
 export interface FetchLogEntry {

package/src/schemas/ai-models.test.ts

@@ -0,0 +1,29 @@
+import { describe, expect, it } from "bun:test";
+import { AiLaneModelsPutSchema } from "./ai-models";
+
+describe("AiLaneModelsPutSchema", () => {
+  it("accepts a partial map", () => {
+    expect(
+      AiLaneModelsPutSchema.safeParse({
+        models: { summarize: "deepseek/deepseek-v4.1-flash" },
+      }).success,
+    ).toBe(true);
+  });
+
+  it("accepts null to clear an override", () => {
+    expect(AiLaneModelsPutSchema.safeParse({ models: { extract: null } }).success).toBe(true);
+  });
+
+  it("rejects an empty models object", () => {
+    expect(AiLaneModelsPutSchema.safeParse({ models: {} }).success).toBe(false);
+  });
+
+  it("rejects unknown keys", () => {
+    expect(
+      AiLaneModelsPutSchema.safeParse({
+        models: { summarize: "x" },
+        extra: true,
+      }).success,
+    ).toBe(false);
+  });
+});

package/src/schemas/ai-models.ts

@@ -0,0 +1,49 @@
+import { z } from "zod";
+
+export const AiLaneIdSchema = z.enum(["summarize", "extract", "feed-enrich", "marketing"]);
+
+const ModelIdOrClearSchema = z.string().max(200).nullable().optional();
+
+/** PUT /v1/ai/models — partial map; `null` or `""` clears that lane's override. */
+export const AiLaneModelsPutSchema = z
+  .object({
+    models: z
+      .object({
+        summarize: ModelIdOrClearSchema,
+        extract: ModelIdOrClearSchema,
+        "feed-enrich": ModelIdOrClearSchema,
+        marketing: ModelIdOrClearSchema,
+      })
+      .refine((m) => Object.values(m).some((v) => v !== undefined), {
+        message: "at least one lane is required",
+      }),
+  })
+  .strict();
+
+export const AiLaneStateSchema = z.object({
+  id: AiLaneIdSchema,
+  label: z.string(),
+  description: z.string(),
+  envVar: z.string(),
+  wranglerDefault: z.string().nullable(),
+  override: z.string().nullable(),
+  effective: z.string().nullable(),
+});
+
+export const OpenRouterCatalogModelSchema = z.object({
+  id: z.string(),
+  name: z.string(),
+  contextLength: z.number().nullable(),
+  promptPricePerMillion: z.number().nullable(),
+  completionPricePerMillion: z.number().nullable(),
+  vision: z.boolean(),
+});
+
+/** GET /v1/ai/models — current assignments plus the OpenRouter catalog. */
+export const AiLaneModelsResponseSchema = z.object({
+  lanes: z.array(AiLaneStateSchema),
+  catalog: z.array(OpenRouterCatalogModelSchema),
+  catalogFetchedAt: z.string().nullable(),
+  catalogError: z.string().nullable(),
+  updatedAt: z.string().nullable(),
+});

package/src/schemas/classifications.ts

@@ -0,0 +1,105 @@
+import { z } from "zod";
+
+/**
+ * Admin classification analytics (`GET /v1/admin/classifications/summary`
+ * and `/recent`). Decisions live in Analytics Engine; these shapes are the
+ * hydrated read model, not the positional point schema.
+ */
+
+const ClassificationOriginSchema = z.enum(["ingest", "manual", "eval"]);
+const ClassificationOriginFilterSchema = z.enum(["ingest", "manual", "eval", "all"]);
+const ClassificationDispositionSchema = z.enum(["kept", "suppressed", "failed", "skipped"]);
+
+const ProbabilityBinSchema = z.object({
+  /** Inclusive. Width is 0.1. `0.8` is the start of the threshold bin. */
+  start: z.number(),
+  /** Exclusive, except the last bin (`0.9`–`1`) which includes `1`. */
+  end: z.number(),
+  count: z.number(),
+});
+
+const ProbabilityHistogramSchema = z.object({
+  bins: z.array(ProbabilityBinSchema),
+  /** Sampled rows whose double is `< 0` (the absent sentinel). */
+  missing: z.number(),
+});
+
+/** `GET /v1/admin/classifications/summary`. */
+export const ClassificationSummarySchema = z.object({
+  after: z.string(),
+  before: z.string(),
+  bucket: z.enum(["hour", "day"]),
+  origin: ClassificationOriginFilterSchema,
+  totals: z.object({
+    classified: z.number(),
+    kept: z.number(),
+    suppressed: z.number(),
+    failed: z.number(),
+    skipped: z.number(),
+    costUsd: z.number(),
+    /** `suppressed / (kept + suppressed)`, or null when the denominator is 0. */
+    suppressionRate: z.number().nullable(),
+  }),
+  series: z.array(
+    z.object({
+      t: z.string(),
+      kept: z.number(),
+      suppressed: z.number(),
+      failed: z.number(),
+      skipped: z.number(),
+    }),
+  ),
+  choices: z.array(z.object({ choice: z.string(), count: z.number() })),
+  choiceSeries: z.array(
+    z.object({
+      t: z.string(),
+      choices: z.record(z.string(), z.number()),
+    }),
+  ),
+  models: z.array(
+    z.object({
+      provider: z.string(),
+      model: z.string(),
+      count: z.number(),
+      costUsd: z.number(),
+    }),
+  ),
+  probability: z.object({
+    threshold: z.literal(0.8),
+    selected: ProbabilityHistogramSchema,
+    confidence: ProbabilityHistogramSchema,
+  }),
+  meta: z.object({
+    dataset: z.string(),
+    retentionDays: z.literal(90),
+    sampled: z.literal(true),
+  }),
+});
+
+/** One sampled decision from `GET /v1/admin/classifications/recent`. */
+export const ClassificationRecentItemSchema = z.object({
+  timestamp: z.string(),
+  origin: ClassificationOriginSchema,
+  sourceId: z.string().nullable(),
+  sourceName: z.string().nullable(),
+  sourceSlug: z.string().nullable(),
+  orgSlug: z.string().nullable(),
+  releaseId: z.string().nullable(),
+  releaseTitle: z.string().nullable(),
+  provider: z.string(),
+  model: z.string(),
+  choice: z.string(),
+  selectedChoiceProbability: z.number().nullable(),
+  providerConfidence: z.number().nullable(),
+  disposition: ClassificationDispositionSchema,
+  reason: z.string(),
+  failureCategory: z.string(),
+  costUsd: z.number().nullable(),
+  durationMs: z.number().nullable(),
+});
+
+/** `GET /v1/admin/classifications/recent` — newest sampled rows, not weighted. */
+export const ClassificationRecentResponseSchema = z.object({
+  items: z.array(ClassificationRecentItemSchema),
+  nextCursor: z.string().nullable(),
+});

package/src/schemas/recommendations.ts

@@ -0,0 +1,39 @@
+import { z } from "zod";
+
+/**
+ * `POST /v1/admin/recommendations/:id/notify-added` body.
+ *
+ * Resolves a live registry listing (org required, source optional) and
+ * emails the submitter's `contactEmail` that their suggestion was added.
+ * Opt-in only — triage / close / archive never send this.
+ */
+export const RecommendationNotifyAddedBodySchema = z.object({
+  orgSlug: z
+    .string()
+    .min(1)
+    .describe(
+      "Org slug or `org_…` id of the onboarded listing. Required so the email can link a live registry URL.",
+    ),
+  sourceSlug: z
+    .string()
+    .min(1)
+    .optional()
+    .describe(
+      "Optional source slug or `src_…` id under that org. When set, the email links the source page.",
+    ),
+});
+
+/**
+ * `POST /v1/admin/recommendations/:id/notify-added` success body.
+ *
+ * `sent: false` + `reason: "already_notified"` is the idempotent replay —
+ * a second call does not email again.
+ */
+export const RecommendationNotifyAddedResultSchema = z.object({
+  ok: z.literal(true),
+  sent: z.boolean(),
+  reason: z.enum(["already_notified"]).optional(),
+  notifiedAt: z.number().nullable(),
+  registryUrl: z.string().optional(),
+  contactEmail: z.string().optional(),
+});

package/src/schemas/workspace-integrations.ts

@@ -0,0 +1,26 @@
+import { z } from "zod";
+
+export const UploadsIntegrationStatusSchema = z.object({
+  provider: z.literal("uploads"),
+  connected: z.boolean(),
+  /** False when the token-encryption key is missing. */
+  configured: z.boolean(),
+  connectedAt: z.string().nullable(),
+  scope: z.string().nullable(),
+  /** uploads.sh workspace slug from the access-token JWT (`workspace`, else `workspaces[]`). */
+  uploadsWorkspace: z.string().nullable(),
+});
+
+export const UploadsOAuthConnectResponseSchema = z.object({
+  authorizeUrl: z.string(),
+  redirectUri: z.string(),
+});
+
+export const UploadsOAuthCallbackBodySchema = z.object({
+  code: z.string().min(1),
+  state: z.string().min(1),
+});
+
+export const UploadsOAuthCallbackResponseSchema = UploadsIntegrationStatusSchema.extend({
+  workspaceId: z.string(),
+});