@buildinternet/releases-api-types 0.8.0 → 0.9.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@buildinternet/releases-api-types",
-  "version": "0.8.0",
+  "version": "0.9.0",
   "description": "Wire protocol — request/response types for the Releases registry API. Shared by web, workers, and clients.",
   "type": "module",
   "license": "MIT",
@@ -17,7 +17,7 @@
     "README.md"
   ],
   "dependencies": {
-    "@buildinternet/releases-core": "workspace:*",
+    "@buildinternet/releases-core": "^0.18.0",
     "zod": "^4.3.6"
   },
   "publishConfig": {

package/src/api-types.ts

@@ -620,6 +620,13 @@ export interface OrgReleasesResponse {
   pagination: { nextCursor: string | null; limit: number };
 }
 
+// Source-scoped release feed — the source identity is encoded in the URL, so
+// items omit the redundant `source` block carried by the org feed.
+export interface SourceReleasesResponse {
+  releases: ReleaseItem[];
+  pagination: { nextCursor: string | null; limit: number };
+}
+
 // ── Products ──
 
 // `Category` lives in @buildinternet/releases-core/categories — import it from
@@ -667,6 +674,76 @@ export interface TagDetail {
   products: TaxonomyProduct[];
 }
 
+// ── Collections ──
+//
+// Curated, named groups of orgs that drive a public "playlist" page (e.g.
+// /collections/frontier-ai-labs). Independent of the fixed `category` taxonomy.
+
+export interface CollectionMemberOrg {
+  slug: string;
+  name: string;
+  domain: string | null;
+  avatarUrl: string | null;
+  description: string | null;
+}
+
+/** Item shape on GET /v1/collections (list). */
+export interface CollectionListItem {
+  slug: string;
+  name: string;
+  description: string | null;
+  memberCount: number;
+}
+
+/** Detail shape on GET /v1/collections/:slug. */
+export interface CollectionDetail {
+  slug: string;
+  name: string;
+  description: string | null;
+  orgs: CollectionMemberOrg[];
+}
+
+/** Body for POST /v1/collections. `slug` derives from `name` via toSlug() if omitted. */
+export interface CreateCollectionRequest {
+  slug?: string;
+  name: string;
+  description?: string | null;
+}
+
+/** Body for PATCH /v1/collections/:slug. All fields optional; slug rename is allowed. */
+export interface UpdateCollectionRequest {
+  slug?: string;
+  name?: string;
+  description?: string | null;
+}
+
+/** A single member entry accepted by the member-write endpoints. */
+export interface CollectionMemberInput {
+  /** Either `orgId` (org_…) or `orgSlug` is required; if both are given, `orgId` wins. */
+  orgId?: string;
+  orgSlug?: string;
+  /** Authoring position (default 0). For PUT, omit to use array index. */
+  position?: number;
+}
+
+/** Body for POST /v1/collections/:slug/members. */
+export type AddCollectionMemberRequest = CollectionMemberInput;
+
+/** Body for PUT /v1/collections/:slug/members. Replaces the full membership atomically. */
+export interface ReplaceCollectionMembersRequest {
+  orgs: CollectionMemberInput[];
+}
+
+/** Bare row returned by POST/PATCH on /v1/collections. */
+export interface CollectionRow {
+  id: string;
+  slug: string;
+  name: string;
+  description: string | null;
+  createdAt: string;
+  updatedAt: string;
+}
+
 // ── Releases (enriched) ──
 
 /** Flat release shape returned by GET /v1/releases/:id with source metadata. */
@@ -780,8 +857,28 @@ export interface Session {
   sessionId: string;
   company: string;
   type: "onboard" | "update";
+  /**
+   * Sub-agent **role** label that ran this session — `"coordinator"` is the
+   * parent orchestrator (typically Sonnet) when a multi-agent session
+   * delegates, `"sonnet"` / `"haiku"` are direct single-agent runs.
+   * Surfaces on the detail GET.
+   *
+   * This is a logical role label, not the runtime model identifier. The
+   * resolved Anthropic model string (e.g. `claude-sonnet-4-6`,
+   * `claude-haiku-4-5`) lives on `usage.model` when the session reported
+   * one — consult that field for the concrete model.
+   */
+  agent?: "sonnet" | "haiku" | "coordinator";
+  /** Identifies the client that started this session (e.g. hostname). */
+  runner?: string;
+  /** Correlation ID for end-to-end tracing across CLI → API → managed agent. */
+  correlationId?: string;
+  /** Anthropic session ID for linking to console logs. */
+  anthropicSessionId?: string;
   status: "running" | "complete" | "error" | "cancelled";
   step?: string;
+  sourcesFound?: number;
+  sourcesValidated?: number;
   totalSources?: number;
   sourcesFetched?: number;
   releasesFound?: number;
@@ -798,6 +895,40 @@ export interface Session {
   stopReason?: string;
   /** Number of provider `session.error` events observed before terminal. */
   retryCount?: number;
+  /** Non-fatal warnings collected during the session. */
+  warnings?: string[];
+  /**
+   * Token usage + estimated cost from the managed-agents session. `estimatedUsd`
+   * is a snapshot of Anthropic list prices at session-completion time.
+   */
+  usage?: {
+    inputTokens?: number;
+    outputTokens?: number;
+    cacheWriteTokens?: number;
+    cacheReadTokens?: number;
+    model?: string;
+    estimatedUsd?: number;
+  };
+  /**
+   * Final agent-reported state for terminal `onboard` sessions — the JSON
+   * blob the agent passed to its `releases_report_state` tool, plus an
+   * `agentSessionId` field stitched in server-side. Empty on `update`
+   * sessions and pre-report errors. Typed as `Record<string, unknown>`
+   * because the shape is owned by the discovery system prompt and may
+   * grow new fields without a wire bump; the keys produced today are:
+   *
+   * - `product` (`string`) — company name
+   * - `domain` (`string | null`) — discovered domain
+   * - `githubOrg` (`string | null`) — discovered GitHub org
+   * - `startedAt`, `updatedAt` (ISO strings)
+   * - `status` (e.g. `"awaiting_review"`)
+   * - `sources` (`Array<{ url, type, slug, label, confidence,
+   *   validated, validationError?, releaseCount, releasesFetched,
+   *   fetched, contentDepth }>`)
+   * - `agentSessionId` (`string`) — Anthropic session ID, useful for
+   *   cross-referencing console logs
+   */
+  result?: Record<string, unknown>;
   activeSources?: string[];
   cancelRequested?: boolean;
 }

package/src/schemas/products.ts

@@ -88,18 +88,31 @@ export const UpdateProductBodySchema = z.object({
   aliases: z.array(z.string()).optional(),
 });
 
-/** Body accepted by `POST /v1/products/adopt`. */
+/**
+ * Body accepted by `POST /v1/products/adopt`.
+ *
+ * `mergeInto` (slug or `prod_…` ID) folds the source org into an existing
+ * product under `targetOrgSlug` instead of creating a new one. When set,
+ * `slug` and `url` must be omitted (the existing product's values stand).
+ */
 export const AdoptProductBodySchema = z.object({
   sourceOrgSlug: z.string().min(1),
   targetOrgSlug: z.string().min(1),
   slug: z.string().optional(),
   url: z.string().optional(),
+  mergeInto: z.string().optional(),
   dryRun: z.boolean().optional(),
 });
 
-/** Live (non-dryRun) result from `POST /v1/products/adopt`. */
+/**
+ * Live (non-dryRun) result from `POST /v1/products/adopt`.
+ *
+ * `mergedInto` is set when the request used `mergeInto` — its value is the
+ * existing product's slug, signalling that no new product was created.
+ */
 export const ProductAdoptResultSchema = z.object({
   product: ProductRowSchema,
+  mergedInto: z.string().optional(),
   sourcesMoved: z.number().int().min(0),
   accountsMoved: z.number().int().min(0),
   sourceOrgDeleted: z.string(),
@@ -108,6 +121,7 @@ export const ProductAdoptResultSchema = z.object({
 /** Dry-run preview from `POST /v1/products/adopt` with `dryRun: true`. */
 export const ProductAdoptDryRunSchema = z.object({
   dryRun: z.literal(true),
+  mergeInto: z.string().optional(),
   product: z.object({
     name: z.string(),
     slug: z.string(),