@buildinternet/releases-api-types 0.59.0 → 0.60.0

package/dist/schemas/sources.d.ts

@@ -0,0 +1,1145 @@
+import { z } from "zod";
+export declare const SourceTypeSchema: z.ZodEnum<{
+    agent: "agent";
+    appstore: "appstore";
+    feed: "feed";
+    github: "github";
+    scrape: "scrape";
+    video: "video";
+}>;
+export declare const SourceDiscoverySchema: z.ZodEnum<{
+    agent: "agent";
+    curated: "curated";
+    on_demand: "on_demand";
+}>;
+export declare const SourceFetchPrioritySchema: z.ZodEnum<{
+    low: "low";
+    normal: "normal";
+    paused: "paused";
+}>;
+/**
+ * Per-source row used in list/embedded contexts (e.g. nested inside OrgDetail).
+ * Most fields are optional — embedded shapes (org detail) only carry the
+ * subset needed for that view.
+ */
+export declare const SourceListItemSchema: z.ZodObject<{
+    id: z.ZodOptional<z.ZodString>;
+    slug: z.ZodString;
+    name: z.ZodString;
+    type: z.ZodEnum<{
+        agent: "agent";
+        appstore: "appstore";
+        feed: "feed";
+        github: "github";
+        scrape: "scrape";
+        video: "video";
+    }>;
+    url: z.ZodOptional<z.ZodString>;
+    orgSlug: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    releaseCount: z.ZodNumber;
+    latestVersion: z.ZodNullable<z.ZodString>;
+    latestDate: z.ZodNullable<z.ZodString>;
+    latestAddedAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    isPrimary: z.ZodOptional<z.ZodBoolean>;
+    isHidden: z.ZodOptional<z.ZodBoolean>;
+    discovery: z.ZodOptional<z.ZodEnum<{
+        agent: "agent";
+        curated: "curated";
+        on_demand: "on_demand";
+    }>>;
+    fetchPriority: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+        low: "low";
+        normal: "normal";
+        paused: "paused";
+    }>>>;
+    lastFetchedAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    lastPolledAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    changeDetectedAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    consecutiveNoChange: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    consecutiveErrors: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    nextFetchAfter: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    medianGapDays: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    lastRetieredAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    metadata: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    productName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    productSlug: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    kind: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+        desktop: "desktop";
+        docs: "docs";
+        integration: "integration";
+        mobile: "mobile";
+        platform: "platform";
+        sdk: "sdk";
+        tool: "tool";
+    }>>>;
+    stars: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    starsFetchedAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>;
+/**
+ * Canonical row returned by `GET /v1/sources` (list). Superset of
+ * `SourceListItem` with required `id` / `orgName` / `orgSlug` fields used by
+ * the CLI `list` command.
+ */
+export declare const SourceWithOrgSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    slug: z.ZodString;
+    type: z.ZodEnum<{
+        agent: "agent";
+        appstore: "appstore";
+        feed: "feed";
+        github: "github";
+        scrape: "scrape";
+        video: "video";
+    }>;
+    url: z.ZodString;
+    orgName: z.ZodNullable<z.ZodString>;
+    orgSlug: z.ZodNullable<z.ZodString>;
+    productName: z.ZodNullable<z.ZodString>;
+    productSlug: z.ZodNullable<z.ZodString>;
+    isPrimary: z.ZodBoolean;
+    isHidden: z.ZodNullable<z.ZodBoolean>;
+    discovery: z.ZodOptional<z.ZodEnum<{
+        agent: "agent";
+        curated: "curated";
+        on_demand: "on_demand";
+    }>>;
+    metadata: z.ZodNullable<z.ZodString>;
+    releaseCount: z.ZodNumber;
+    latestVersion: z.ZodNullable<z.ZodString>;
+    latestDate: z.ZodNullable<z.ZodString>;
+    lastFetchedAt: z.ZodNullable<z.ZodString>;
+    lastPolledAt: z.ZodNullable<z.ZodString>;
+    fetchPriority: z.ZodNullable<z.ZodEnum<{
+        low: "low";
+        normal: "normal";
+        paused: "paused";
+    }>>;
+    changeDetectedAt: z.ZodNullable<z.ZodString>;
+    consecutiveNoChange: z.ZodNullable<z.ZodNumber>;
+    consecutiveErrors: z.ZodNullable<z.ZodNumber>;
+    nextFetchAfter: z.ZodNullable<z.ZodString>;
+    medianGapDays: z.ZodNullable<z.ZodNumber>;
+    lastRetieredAt: z.ZodNullable<z.ZodString>;
+    kind: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+        desktop: "desktop";
+        docs: "docs";
+        integration: "integration";
+        mobile: "mobile";
+        platform: "platform";
+        sdk: "sdk";
+        tool: "tool";
+    }>>>;
+    stars: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    starsFetchedAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>;
+export declare const SourceListResponseSchema: z.ZodObject<{
+    items: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        slug: z.ZodString;
+        type: z.ZodEnum<{
+            agent: "agent";
+            appstore: "appstore";
+            feed: "feed";
+            github: "github";
+            scrape: "scrape";
+            video: "video";
+        }>;
+        url: z.ZodString;
+        orgName: z.ZodNullable<z.ZodString>;
+        orgSlug: z.ZodNullable<z.ZodString>;
+        productName: z.ZodNullable<z.ZodString>;
+        productSlug: z.ZodNullable<z.ZodString>;
+        isPrimary: z.ZodBoolean;
+        isHidden: z.ZodNullable<z.ZodBoolean>;
+        discovery: z.ZodOptional<z.ZodEnum<{
+            agent: "agent";
+            curated: "curated";
+            on_demand: "on_demand";
+        }>>;
+        metadata: z.ZodNullable<z.ZodString>;
+        releaseCount: z.ZodNumber;
+        latestVersion: z.ZodNullable<z.ZodString>;
+        latestDate: z.ZodNullable<z.ZodString>;
+        lastFetchedAt: z.ZodNullable<z.ZodString>;
+        lastPolledAt: z.ZodNullable<z.ZodString>;
+        fetchPriority: z.ZodNullable<z.ZodEnum<{
+            low: "low";
+            normal: "normal";
+            paused: "paused";
+        }>>;
+        changeDetectedAt: z.ZodNullable<z.ZodString>;
+        consecutiveNoChange: z.ZodNullable<z.ZodNumber>;
+        consecutiveErrors: z.ZodNullable<z.ZodNumber>;
+        nextFetchAfter: z.ZodNullable<z.ZodString>;
+        medianGapDays: z.ZodNullable<z.ZodNumber>;
+        lastRetieredAt: z.ZodNullable<z.ZodString>;
+        kind: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+            desktop: "desktop";
+            docs: "docs";
+            integration: "integration";
+            mobile: "mobile";
+            platform: "platform";
+            sdk: "sdk";
+            tool: "tool";
+        }>>>;
+        stars: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        starsFetchedAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strip>>;
+    pagination: z.ZodObject<{
+        page: z.ZodNumber;
+        pageSize: z.ZodNumber;
+        returned: z.ZodNumber;
+        totalItems: z.ZodOptional<z.ZodNumber>;
+        totalPages: z.ZodOptional<z.ZodNumber>;
+        hasMore: z.ZodBoolean;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+/**
+ * `GET /v1/sources` returns a bare array by default and an envelope when
+ * `?envelope=true` is passed. The OpenAPI spec advertises the union so
+ * either client expectation is documented.
+ */
+export declare const SourceListResultSchema: z.ZodUnion<readonly [z.ZodArray<z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    slug: z.ZodString;
+    type: z.ZodEnum<{
+        agent: "agent";
+        appstore: "appstore";
+        feed: "feed";
+        github: "github";
+        scrape: "scrape";
+        video: "video";
+    }>;
+    url: z.ZodString;
+    orgName: z.ZodNullable<z.ZodString>;
+    orgSlug: z.ZodNullable<z.ZodString>;
+    productName: z.ZodNullable<z.ZodString>;
+    productSlug: z.ZodNullable<z.ZodString>;
+    isPrimary: z.ZodBoolean;
+    isHidden: z.ZodNullable<z.ZodBoolean>;
+    discovery: z.ZodOptional<z.ZodEnum<{
+        agent: "agent";
+        curated: "curated";
+        on_demand: "on_demand";
+    }>>;
+    metadata: z.ZodNullable<z.ZodString>;
+    releaseCount: z.ZodNumber;
+    latestVersion: z.ZodNullable<z.ZodString>;
+    latestDate: z.ZodNullable<z.ZodString>;
+    lastFetchedAt: z.ZodNullable<z.ZodString>;
+    lastPolledAt: z.ZodNullable<z.ZodString>;
+    fetchPriority: z.ZodNullable<z.ZodEnum<{
+        low: "low";
+        normal: "normal";
+        paused: "paused";
+    }>>;
+    changeDetectedAt: z.ZodNullable<z.ZodString>;
+    consecutiveNoChange: z.ZodNullable<z.ZodNumber>;
+    consecutiveErrors: z.ZodNullable<z.ZodNumber>;
+    nextFetchAfter: z.ZodNullable<z.ZodString>;
+    medianGapDays: z.ZodNullable<z.ZodNumber>;
+    lastRetieredAt: z.ZodNullable<z.ZodString>;
+    kind: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+        desktop: "desktop";
+        docs: "docs";
+        integration: "integration";
+        mobile: "mobile";
+        platform: "platform";
+        sdk: "sdk";
+        tool: "tool";
+    }>>>;
+    stars: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    starsFetchedAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>>, z.ZodObject<{
+    items: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        slug: z.ZodString;
+        type: z.ZodEnum<{
+            agent: "agent";
+            appstore: "appstore";
+            feed: "feed";
+            github: "github";
+            scrape: "scrape";
+            video: "video";
+        }>;
+        url: z.ZodString;
+        orgName: z.ZodNullable<z.ZodString>;
+        orgSlug: z.ZodNullable<z.ZodString>;
+        productName: z.ZodNullable<z.ZodString>;
+        productSlug: z.ZodNullable<z.ZodString>;
+        isPrimary: z.ZodBoolean;
+        isHidden: z.ZodNullable<z.ZodBoolean>;
+        discovery: z.ZodOptional<z.ZodEnum<{
+            agent: "agent";
+            curated: "curated";
+            on_demand: "on_demand";
+        }>>;
+        metadata: z.ZodNullable<z.ZodString>;
+        releaseCount: z.ZodNumber;
+        latestVersion: z.ZodNullable<z.ZodString>;
+        latestDate: z.ZodNullable<z.ZodString>;
+        lastFetchedAt: z.ZodNullable<z.ZodString>;
+        lastPolledAt: z.ZodNullable<z.ZodString>;
+        fetchPriority: z.ZodNullable<z.ZodEnum<{
+            low: "low";
+            normal: "normal";
+            paused: "paused";
+        }>>;
+        changeDetectedAt: z.ZodNullable<z.ZodString>;
+        consecutiveNoChange: z.ZodNullable<z.ZodNumber>;
+        consecutiveErrors: z.ZodNullable<z.ZodNumber>;
+        nextFetchAfter: z.ZodNullable<z.ZodString>;
+        medianGapDays: z.ZodNullable<z.ZodNumber>;
+        lastRetieredAt: z.ZodNullable<z.ZodString>;
+        kind: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+            desktop: "desktop";
+            docs: "docs";
+            integration: "integration";
+            mobile: "mobile";
+            platform: "platform";
+            sdk: "sdk";
+            tool: "tool";
+        }>>>;
+        stars: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        starsFetchedAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strip>>;
+    pagination: z.ZodObject<{
+        page: z.ZodNumber;
+        pageSize: z.ZodNumber;
+        returned: z.ZodNumber;
+        totalItems: z.ZodOptional<z.ZodNumber>;
+        totalPages: z.ZodOptional<z.ZodNumber>;
+        hasMore: z.ZodBoolean;
+    }, z.core.$strip>;
+}, z.core.$strip>]>;
+/**
+ * Cursor pagination shape for the source detail's embedded release feed.
+ * Mirrors `OrgFeedPaginationSchema` and `CollectionFeedPaginationSchema` —
+ * release lists are feed-shaped (append-only, mutates between calls), so they
+ * use cursor pagination per the AGENTS.md convention.
+ */
+export declare const SourceFeedPaginationSchema: z.ZodObject<{
+    nextCursor: z.ZodNullable<z.ZodString>;
+    limit: z.ZodNumber;
+}, z.core.$strip>;
+/**
+ * Response shape for `GET /v1/sources/:slug/releases` (and the org-scoped
+ * alias). The source identity is in the URL, so items omit the `source` block
+ * the org feed carries.
+ */
+export declare const SourceReleasesResponseSchema: z.ZodObject<{
+    releases: z.ZodArray<z.ZodObject<{
+        id: z.ZodOptional<z.ZodString>;
+        version: z.ZodNullable<z.ZodString>;
+        title: z.ZodString;
+        summary: z.ZodString;
+        content: z.ZodOptional<z.ZodString>;
+        publishedAt: z.ZodNullable<z.ZodString>;
+        fetchedAt: z.ZodOptional<z.ZodString>;
+        url: z.ZodNullable<z.ZodString>;
+        media: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            type: z.ZodEnum<{
+                gif: "gif";
+                image: "image";
+                video: "video";
+            }>;
+            url: z.ZodString;
+            alt: z.ZodOptional<z.ZodString>;
+            r2Key: z.ZodOptional<z.ZodString>;
+            r2Url: z.ZodOptional<z.ZodString>;
+            linkUrl: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>>;
+        type: z.ZodOptional<z.ZodEnum<{
+            feature: "feature";
+            rollup: "rollup";
+        }>>;
+        prerelease: z.ZodOptional<z.ZodBoolean>;
+        titleGenerated: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        titleShort: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        breaking: z.ZodOptional<z.ZodEnum<{
+            major: "major";
+            minor: "minor";
+            none: "none";
+            unknown: "unknown";
+        }>>;
+        importance: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        coverageCount: z.ZodOptional<z.ZodNumber>;
+        contentChars: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        contentTokens: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        composition: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+            bugs: z.ZodNumber;
+            features: z.ZodNumber;
+            enhancements: z.ZodNumber;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>>;
+    pagination: z.ZodObject<{
+        nextCursor: z.ZodNullable<z.ZodString>;
+        limit: z.ZodNumber;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+/**
+ * Resolved attribution block returned alongside a source row. `id` is
+ * additive vs the legacy `{ slug, name }` shape — older clients that ignored
+ * it still parse cleanly. `productId` / `productSlug` are sibling top-level
+ * fields on the source response (kept flat to mirror `orgId`), not nested
+ * inside this block.
+ */
+export declare const SourceOrgRefSchema: z.ZodObject<{
+    id: z.ZodString;
+    slug: z.ZodString;
+    name: z.ZodString;
+}, z.core.$strip>;
+export declare const SourceDetailSchema: z.ZodObject<{
+    id: z.ZodString;
+    slug: z.ZodString;
+    name: z.ZodString;
+    type: z.ZodEnum<{
+        agent: "agent";
+        appstore: "appstore";
+        feed: "feed";
+        github: "github";
+        scrape: "scrape";
+        video: "video";
+    }>;
+    url: z.ZodString;
+    orgId: z.ZodNullable<z.ZodString>;
+    productId: z.ZodNullable<z.ZodString>;
+    productSlug: z.ZodNullable<z.ZodString>;
+    isHidden: z.ZodBoolean;
+    discovery: z.ZodOptional<z.ZodEnum<{
+        agent: "agent";
+        curated: "curated";
+        on_demand: "on_demand";
+    }>>;
+    fetchPriority: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+        low: "low";
+        normal: "normal";
+        paused: "paused";
+    }>>>;
+    isPrimary: z.ZodBoolean;
+    metadata: z.ZodString;
+    changelogUrl: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    hasChangelogFile: z.ZodOptional<z.ZodBoolean>;
+    org: z.ZodNullable<z.ZodObject<{
+        id: z.ZodString;
+        slug: z.ZodString;
+        name: z.ZodString;
+    }, z.core.$strip>>;
+    releaseCount: z.ZodNumber;
+    releasesLast30Days: z.ZodNumber;
+    avgReleasesPerWeek: z.ZodNumber;
+    latestVersion: z.ZodNullable<z.ZodString>;
+    latestDate: z.ZodNullable<z.ZodString>;
+    lastFetchedAt: z.ZodNullable<z.ZodString>;
+    lastPolledAt: z.ZodNullable<z.ZodString>;
+    changeDetectedAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    trackingSince: z.ZodString;
+    releases: z.ZodArray<z.ZodObject<{
+        id: z.ZodOptional<z.ZodString>;
+        version: z.ZodNullable<z.ZodString>;
+        title: z.ZodString;
+        summary: z.ZodString;
+        content: z.ZodOptional<z.ZodString>;
+        publishedAt: z.ZodNullable<z.ZodString>;
+        fetchedAt: z.ZodOptional<z.ZodString>;
+        url: z.ZodNullable<z.ZodString>;
+        media: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            type: z.ZodEnum<{
+                gif: "gif";
+                image: "image";
+                video: "video";
+            }>;
+            url: z.ZodString;
+            alt: z.ZodOptional<z.ZodString>;
+            r2Key: z.ZodOptional<z.ZodString>;
+            r2Url: z.ZodOptional<z.ZodString>;
+            linkUrl: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>>;
+        type: z.ZodOptional<z.ZodEnum<{
+            feature: "feature";
+            rollup: "rollup";
+        }>>;
+        prerelease: z.ZodOptional<z.ZodBoolean>;
+        titleGenerated: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        titleShort: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        breaking: z.ZodOptional<z.ZodEnum<{
+            major: "major";
+            minor: "minor";
+            none: "none";
+            unknown: "unknown";
+        }>>;
+        importance: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        coverageCount: z.ZodOptional<z.ZodNumber>;
+        contentChars: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        contentTokens: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        composition: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+            bugs: z.ZodNumber;
+            features: z.ZodNumber;
+            enhancements: z.ZodNumber;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>>;
+    pagination: z.ZodObject<{
+        nextCursor: z.ZodNullable<z.ZodString>;
+        limit: z.ZodNumber;
+    }, z.core.$strip>;
+    summaries: z.ZodObject<{
+        rolling: z.ZodNullable<z.ZodObject<{
+            year: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+            month: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+            windowDays: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+            summary: z.ZodString;
+            releaseCount: z.ZodNumber;
+            generatedAt: z.ZodString;
+        }, z.core.$strip>>;
+        monthly: z.ZodArray<z.ZodObject<{
+            year: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+            month: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+            windowDays: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+            summary: z.ZodString;
+            releaseCount: z.ZodNumber;
+            generatedAt: z.ZodString;
+        }, z.core.$strip>>;
+    }, z.core.$strip>;
+    kind: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+        desktop: "desktop";
+        docs: "docs";
+        integration: "integration";
+        mobile: "mobile";
+        platform: "platform";
+        sdk: "sdk";
+        tool: "tool";
+    }>>>;
+    stars: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    starsFetchedAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    notice: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        message: z.ZodString;
+        linkText: z.ZodOptional<z.ZodString>;
+        coordinate: z.ZodOptional<z.ZodString>;
+        href: z.ZodOptional<z.ZodURL>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+/**
+ * Response returned by `POST /v1/sources` and `PATCH /v1/sources/:slug`.
+ *
+ * Pre-#794 these endpoints returned the bare drizzle row, leaving callers to
+ * round-trip a separate `GET` to confirm the resolved org/product attribution.
+ * Now they return the same source row plus a resolved `org { id, slug, name }`
+ * block and `productSlug`, so an agent can answer "did the write take?" from
+ * the response alone.
+ *
+ * Wire fields are loosely-typed (`z.unknown()`) for the timestamps/counters
+ * that aren't load-bearing for callers — the row is large and we don't want
+ * to hand-mirror every column. Stable, agent-relevant fields are typed.
+ */
+export declare const SourceMutationResponseSchema: z.ZodObject<{
+    id: z.ZodString;
+    slug: z.ZodString;
+    name: z.ZodString;
+    type: z.ZodEnum<{
+        agent: "agent";
+        appstore: "appstore";
+        feed: "feed";
+        github: "github";
+        scrape: "scrape";
+        video: "video";
+    }>;
+    url: z.ZodString;
+    orgId: z.ZodNullable<z.ZodString>;
+    productId: z.ZodNullable<z.ZodString>;
+    productSlug: z.ZodNullable<z.ZodString>;
+    org: z.ZodNullable<z.ZodObject<{
+        id: z.ZodString;
+        slug: z.ZodString;
+        name: z.ZodString;
+    }, z.core.$strip>>;
+    metadata: z.ZodNullable<z.ZodString>;
+    isPrimary: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+    isHidden: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+    discovery: z.ZodOptional<z.ZodEnum<{
+        agent: "agent";
+        curated: "curated";
+        on_demand: "on_demand";
+    }>>;
+    createdAt: z.ZodOptional<z.ZodString>;
+    kind: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+        desktop: "desktop";
+        docs: "docs";
+        integration: "integration";
+        mobile: "mobile";
+        platform: "platform";
+        sdk: "sdk";
+        tool: "tool";
+    }>>>;
+}, z.core.$loose>;
+/**
+ * Response from `POST /v1/sources/appstore` — materializes an App Store listing
+ * into a curated Org → Product → Source → first Release (modeled on the GitHub
+ * coordinate `LookupResponse`).
+ *
+ * Unlike `SourceMutationResponse`, the `source` here is the **bare inserted (or
+ * idempotently looked-up) drizzle row** the materialize handler returns verbatim:
+ * no resolved `org { id, slug, name }` block and no `productSlug`. `loose` so the
+ * untyped timestamp/counter columns on the row pass through.
+ *
+ * `status: "indexed"` is a brand-new source (HTTP 201); `"existing"` is the
+ * idempotent hit on a prior materialize of the same trackId (HTTP 200).
+ */
+export declare const AppStoreMaterializeResponseSchema: z.ZodObject<{
+    status: z.ZodEnum<{
+        existing: "existing";
+        indexed: "indexed";
+    }>;
+    source: z.ZodObject<{
+        id: z.ZodString;
+        slug: z.ZodString;
+        name: z.ZodString;
+        type: z.ZodEnum<{
+            agent: "agent";
+            appstore: "appstore";
+            feed: "feed";
+            github: "github";
+            scrape: "scrape";
+            video: "video";
+        }>;
+        url: z.ZodString;
+        orgId: z.ZodNullable<z.ZodString>;
+        productId: z.ZodNullable<z.ZodString>;
+        metadata: z.ZodNullable<z.ZodString>;
+        kind: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+            desktop: "desktop";
+            docs: "docs";
+            integration: "integration";
+            mobile: "mobile";
+            platform: "platform";
+            sdk: "sdk";
+            tool: "tool";
+        }>>>;
+        discovery: z.ZodOptional<z.ZodEnum<{
+            agent: "agent";
+            curated: "curated";
+            on_demand: "on_demand";
+        }>>;
+        isHidden: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+        createdAt: z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>;
+    releaseCount: z.ZodNumber;
+}, z.core.$strip>;
+/** Body accepted by `PATCH /v1/sources/:slug`. */
+export declare const SourcePatchInputSchema: z.ZodObject<{
+    name: z.ZodOptional<z.ZodString>;
+    url: z.ZodOptional<z.ZodString>;
+    type: z.ZodOptional<z.ZodEnum<{
+        agent: "agent";
+        appstore: "appstore";
+        feed: "feed";
+        github: "github";
+        scrape: "scrape";
+        video: "video";
+    }>>;
+    slug: z.ZodOptional<z.ZodString>;
+    metadata: z.ZodOptional<z.ZodString>;
+    orgId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    productId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    lastFetchedAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    lastContentHash: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    fetchPriority: z.ZodOptional<z.ZodEnum<{
+        low: "low";
+        normal: "normal";
+        paused: "paused";
+    }>>;
+    consecutiveNoChange: z.ZodOptional<z.ZodNumber>;
+    consecutiveErrors: z.ZodOptional<z.ZodNumber>;
+    nextFetchAfter: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    isPrimary: z.ZodOptional<z.ZodBoolean>;
+    isHidden: z.ZodOptional<z.ZodBoolean>;
+    changeDetectedAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    lastPolledAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    kind: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+        desktop: "desktop";
+        docs: "docs";
+        integration: "integration";
+        mobile: "mobile";
+        platform: "platform";
+        sdk: "sdk";
+        tool: "tool";
+    }>>>;
+    discovery: z.ZodOptional<z.ZodEnum<{
+        agent: "agent";
+        curated: "curated";
+        on_demand: "on_demand";
+    }>>;
+    notice: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        message: z.ZodString;
+        linkText: z.ZodOptional<z.ZodString>;
+        coordinate: z.ZodOptional<z.ZodString>;
+        href: z.ZodOptional<z.ZodURL>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+/** Body accepted by `POST /v1/sources`. */
+export declare const CreateSourceBodySchema: z.ZodObject<{
+    name: z.ZodString;
+    url: z.ZodString;
+    type: z.ZodOptional<z.ZodEnum<{
+        agent: "agent";
+        appstore: "appstore";
+        feed: "feed";
+        github: "github";
+        scrape: "scrape";
+        video: "video";
+    }>>;
+    slug: z.ZodOptional<z.ZodString>;
+    orgId: z.ZodOptional<z.ZodString>;
+    orgSlug: z.ZodOptional<z.ZodString>;
+    productId: z.ZodOptional<z.ZodString>;
+    productSlug: z.ZodOptional<z.ZodString>;
+    metadata: z.ZodOptional<z.ZodString>;
+    isPrimary: z.ZodOptional<z.ZodBoolean>;
+    kind: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+        desktop: "desktop";
+        docs: "docs";
+        integration: "integration";
+        mobile: "mobile";
+        platform: "platform";
+        sdk: "sdk";
+        tool: "tool";
+    }>>>;
+}, z.core.$strip>;
+export declare const ChangelogFileSummarySchema: z.ZodObject<{
+    path: z.ZodString;
+    filename: z.ZodString;
+    url: z.ZodString;
+    bytes: z.ZodNumber;
+    fetchedAt: z.ZodString;
+}, z.core.$strip>;
+export declare const SourceChangelogResponseSchema: z.ZodObject<{
+    path: z.ZodString;
+    filename: z.ZodString;
+    url: z.ZodString;
+    rawUrl: z.ZodString;
+    content: z.ZodString;
+    bytes: z.ZodNumber;
+    fetchedAt: z.ZodString;
+    offset: z.ZodNumber;
+    limit: z.ZodNumber;
+    nextOffset: z.ZodNullable<z.ZodNumber>;
+    totalChars: z.ZodNumber;
+    tokens: z.ZodOptional<z.ZodNumber>;
+    sliceTokens: z.ZodOptional<z.ZodNumber>;
+    totalTokens: z.ZodNumber;
+    truncated: z.ZodBoolean;
+    truncatedAt: z.ZodNullable<z.ZodNumber>;
+    files: z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        filename: z.ZodString;
+        url: z.ZodString;
+        bytes: z.ZodNumber;
+        fetchedAt: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+/**
+ * Response shape for `GET /v1/sources/:slug/activity` and the org-scoped twin.
+ * Returns week-bucketed release counts for the full tracking lifetime of the source.
+ * Optional `?from=YYYY-MM-DD` and `?to=YYYY-MM-DD` narrow the range.
+ */
+export declare const SourceActivityResponseSchema: z.ZodObject<{
+    source: z.ZodObject<{
+        slug: z.ZodString;
+        name: z.ZodString;
+        orgSlug: z.ZodNullable<z.ZodString>;
+        orgName: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>;
+    range: z.ZodObject<{
+        from: z.ZodString;
+        to: z.ZodString;
+    }, z.core.$strip>;
+    weeklyBuckets: z.ZodArray<z.ZodObject<{
+        weekStart: z.ZodString;
+        count: z.ZodNumber;
+        earliestVersion: z.ZodNullable<z.ZodString>;
+        latestVersion: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+/**
+ * Response shape for `GET /v1/sources/:slug/heatmap` and the org-scoped twin.
+ * Returns daily release counts for the trailing 365 days — contribution-graph
+ * visualization for the source detail page.
+ */
+export declare const SourceHeatmapResponseSchema: z.ZodObject<{
+    source: z.ZodObject<{
+        slug: z.ZodString;
+        name: z.ZodString;
+    }, z.core.$strip>;
+    range: z.ZodObject<{
+        from: z.ZodString;
+        to: z.ZodString;
+    }, z.core.$strip>;
+    dailyCounts: z.ZodArray<z.ZodObject<{
+        date: z.ZodString;
+        count: z.ZodNumber;
+    }, z.core.$strip>>;
+    total: z.ZodNumber;
+}, z.core.$strip>;
+/**
+ * Single row returned inside `GET /v1/sources/:slug/known-releases`. Minimal
+ * identifier set used by the incremental parsing agent to skip already-known
+ * versions without fetching full content.
+ */
+export declare const SourceKnownReleaseItemSchema: z.ZodObject<{
+    version: z.ZodNullable<z.ZodString>;
+    title: z.ZodString;
+    publishedAt: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * Response shape for `GET /v1/sources/:slug/known-releases`. Returns the
+ * N most-recent non-suppressed releases (default N=10, max 500), ordered
+ * by `publishedAt` descending. Accepts `?limit=N`.
+ */
+export declare const SourceKnownReleasesResponseSchema: z.ZodArray<z.ZodObject<{
+    version: z.ZodNullable<z.ZodString>;
+    title: z.ZodString;
+    publishedAt: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>>;
+/**
+ * Response shape for `GET /v1/sources/:slug/recent-releases`. Returns the
+ * full release rows (non-suppressed, published at or after `?cutoff=`) ordered
+ * by `publishedAt` descending. Used by the summarization agent to retrieve the
+ * release window it needs to summarize. `?cutoff=` is required (ISO-8601 date
+ * string); missing `?cutoff=` returns 400.
+ */
+export declare const SourceRecentReleasesResponseSchema: z.ZodArray<z.ZodObject<{
+    id: z.ZodString;
+    sourceId: z.ZodString;
+    version: z.ZodNullable<z.ZodString>;
+    title: z.ZodString;
+    content: z.ZodString;
+    url: z.ZodNullable<z.ZodString>;
+    publishedAt: z.ZodNullable<z.ZodString>;
+    fetchedAt: z.ZodOptional<z.ZodString>;
+}, z.core.$loose>>;
+/**
+ * Response shape for `GET /v1/sources/:slug/sessions`. Returns the active
+ * discovery session (if any) touching this source. The session object is the
+ * live DO state blob from the `StatusHub` Durable Object. Returns `{ sessions:
+ * [] }` when no active session references this source.
+ */
+export declare const SourceSessionsResponseSchema: z.ZodObject<{
+    sessions: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>;
+/**
+ * Full summary row as stored in `release_summaries`, returned by
+ * `GET /v1/sources/:slug/summaries`. Filter by `?type=rolling|monthly`,
+ * `?year=`, `?month=`.
+ */
+export declare const SourceSummaryRowSchema: z.ZodObject<{
+    id: z.ZodOptional<z.ZodString>;
+    sourceId: z.ZodString;
+    orgId: z.ZodNullable<z.ZodString>;
+    type: z.ZodEnum<{
+        monthly: "monthly";
+        rolling: "rolling";
+    }>;
+    year: z.ZodNullable<z.ZodNumber>;
+    month: z.ZodNullable<z.ZodNumber>;
+    windowDays: z.ZodNullable<z.ZodNumber>;
+    summary: z.ZodString;
+    releaseCount: z.ZodNumber;
+    generatedAt: z.ZodString;
+}, z.core.$strip>;
+export declare const SourceSummariesResponseSchema: z.ZodArray<z.ZodObject<{
+    id: z.ZodOptional<z.ZodString>;
+    sourceId: z.ZodString;
+    orgId: z.ZodNullable<z.ZodString>;
+    type: z.ZodEnum<{
+        monthly: "monthly";
+        rolling: "rolling";
+    }>;
+    year: z.ZodNullable<z.ZodNumber>;
+    month: z.ZodNullable<z.ZodNumber>;
+    windowDays: z.ZodNullable<z.ZodNumber>;
+    summary: z.ZodString;
+    releaseCount: z.ZodNumber;
+    generatedAt: z.ZodString;
+}, z.core.$strip>>;
+/**
+ * Body accepted by `POST /v1/sources/:slug/summaries`.
+ *
+ * `month` is calendar-bounded (1..12) and `windowDays` must be a positive
+ * integer when present — silently dropping wrong-typed values masks client
+ * bugs, so the validator rejects them explicitly. `year` is not bound-checked
+ * (any cutoff would be arbitrary).
+ */
+export declare const CreateSourceSummaryBodySchema: z.ZodObject<{
+    type: z.ZodEnum<{
+        monthly: "monthly";
+        rolling: "rolling";
+    }>;
+    year: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    month: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    windowDays: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    summary: z.ZodString;
+    releaseCount: z.ZodNumber;
+}, z.core.$strip>;
+/** Response for `POST /v1/sources/:slug/summaries` (upsert). */
+export declare const CreateSourceSummaryResponseSchema: z.ZodObject<{
+    ok: z.ZodLiteral<true>;
+}, z.core.$strip>;
+/**
+ * Response shape for `POST /v1/sources/:slug/fetch`. Three branches:
+ *   - Feed/GitHub/scraped-with-feed sources: `{ fetched: true, releasesInserted, … }`
+ *   - Scrape/agent sources (flagged for CLI pickup): `{ queued: true, type: "flagged" }`
+ *   - Render dry-run probe (`?dryRun=true` on a client-rendered scrape source):
+ *     `{ renderCheck: true, rendered, candidateCount, sampleUrls, … }`
+ */
+export declare const SourceFetchResponseSchema: z.ZodUnion<readonly [z.ZodObject<{
+    fetched: z.ZodLiteral<true>;
+}, z.core.$loose>, z.ZodObject<{
+    queued: z.ZodLiteral<true>;
+    type: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    renderCheck: z.ZodLiteral<true>;
+    status: z.ZodEnum<{
+        dry_run: "dry_run";
+        error: "error";
+    }>;
+    rendered: z.ZodBoolean;
+    candidateCount: z.ZodNumber;
+    sampleUrls: z.ZodArray<z.ZodString>;
+    durationMs: z.ZodNumber;
+    error: z.ZodOptional<z.ZodString>;
+}, z.core.$loose>]>;
+/** Response for `POST /v1/sources/:slug/content-hash`. */
+export declare const SourceContentHashResponseSchema: z.ZodUnion<readonly [z.ZodObject<{
+    unchanged: z.ZodLiteral<true>;
+}, z.core.$strip>, z.ZodObject<{
+    unchanged: z.ZodLiteral<false>;
+}, z.core.$strip>]>;
+/** Body for `POST /v1/sources/:slug/content-hash`. */
+export declare const SourceContentHashBodySchema: z.ZodObject<{
+    contentHash: z.ZodString;
+}, z.core.$strip>;
+/** Response for `PATCH /v1/sources/:slug/changelog/tokens`. */
+export declare const ChangelogTokensResponseSchema: z.ZodObject<{
+    path: z.ZodString;
+    oldTokens: z.ZodNullable<z.ZodNumber>;
+    tokens: z.ZodNumber;
+}, z.core.$strip>;
+/** Response for `PATCH /v1/sources/:slug/metadata`. Echoes the merged metadata object. */
+export declare const SourceMetadataResponseSchema: z.ZodObject<{
+    metadata: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+}, z.core.$strip>;
+/**
+ * A discovered CHANGELOG path returned by the probe. Mirrors
+ * `DiscoveredChangelogPath` from `@releases/adapters/github-discovery`:
+ * `origin` tags where the path came from (repo root, a workspace package, or
+ * an explicit `metadata.changelogPaths` override) and `exists` is true when a
+ * directory listing confirmed the file on HEAD.
+ */
+export declare const DiscoveredChangelogPathSchema: z.ZodObject<{
+    path: z.ZodString;
+    origin: z.ZodEnum<{
+        override: "override";
+        root: "root";
+        workspace: "workspace";
+    }>;
+    exists: z.ZodBoolean;
+}, z.core.$strip>;
+/** Response for `POST /v1/sources/:slug/changelog/probe`. */
+export declare const ChangelogProbeResponseSchema: z.ZodObject<{
+    sourceId: z.ZodString;
+    sourceSlug: z.ZodString;
+    url: z.ZodString;
+    paths: z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        origin: z.ZodEnum<{
+            override: "override";
+            root: "root";
+            workspace: "workspace";
+        }>;
+        exists: z.ZodBoolean;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+/**
+ * Response for `DELETE /v1/sources/:slug`. Two shapes:
+ *   - Soft delete: `{ deleted: true, deletedAt: "<iso>" }`
+ *   - Hard delete (`?hard=true`): `{ deleted: true, hard: true }`
+ */
+export declare const DeleteSourceResponseSchema: z.ZodUnion<readonly [z.ZodObject<{
+    deleted: z.ZodLiteral<true>;
+    deletedAt: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    deleted: z.ZodLiteral<true>;
+    hard: z.ZodLiteral<true>;
+}, z.core.$strip>]>;
+/**
+ * Response for `DELETE /v1/sources/:slug/releases`. Two shapes:
+ *   - Soft (`?hard` absent): `{ suppressed: N }` — releases hidden, not deleted
+ *   - Hard (`?hard=true`): `{ deleted: N, hard: true }`
+ */
+export declare const DeleteSourceReleasesResponseSchema: z.ZodUnion<readonly [z.ZodObject<{
+    suppressed: z.ZodNumber;
+}, z.core.$strip>, z.ZodObject<{
+    deleted: z.ZodNumber;
+    hard: z.ZodLiteral<true>;
+}, z.core.$strip>]>;
+/**
+ * Response for `POST /v1/sources/:slug/releases`. Returns the inserted release
+ * row (201) or `{ skipped: true }` (200) on URL conflict.
+ */
+export declare const InsertReleaseResponseSchema: z.ZodUnion<readonly [z.ZodObject<{
+    id: z.ZodString;
+    sourceId: z.ZodString;
+    title: z.ZodString;
+}, z.core.$loose>, z.ZodObject<{
+    skipped: z.ZodLiteral<true>;
+}, z.core.$strip>]>;
+/** One release in a `POST /v1/sources/:slug/releases/batch` body. */
+export declare const BatchReleaseInputSchema: z.ZodObject<{
+    title: z.ZodString;
+    content: z.ZodString;
+    version: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    url: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    contentHash: z.ZodOptional<z.ZodString>;
+    publishedAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    media: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    type: z.ZodOptional<z.ZodEnum<{
+        feature: "feature";
+        rollup: "rollup";
+    }>>;
+    prerelease: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+/**
+ * Body for `POST /v1/sources/:slug/releases/batch`. Without `mode`, a URL that
+ * already exists only has its empty fields filled. `mode: "upsert-content"`
+ * overwrites content and media on a URL match, which is what publishers
+ * (`actions/publish-changelog`, `releases publish`) send.
+ */
+export declare const BatchReleasesBodySchema: z.ZodObject<{
+    mode: z.ZodOptional<z.ZodLiteral<"upsert-content">>;
+    releases: z.ZodArray<z.ZodObject<{
+        title: z.ZodString;
+        content: z.ZodString;
+        version: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        url: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        contentHash: z.ZodOptional<z.ZodString>;
+        publishedAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        media: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        type: z.ZodOptional<z.ZodEnum<{
+            feature: "feature";
+            rollup: "rollup";
+        }>>;
+        prerelease: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+/** Response for `POST /v1/sources/:slug/releases/batch`. */
+export declare const BatchReleasesResponseSchema: z.ZodObject<{
+    inserted: z.ZodNumber;
+    total: z.ZodNumber;
+    insertedIds: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * Response for `POST /v1/sources/:slug/raw-snapshot` (#1283). On a store or a
+ * content-hash dedup hit, all fields are present; `stored` is `false` for the
+ * dedup case. When the `RAW_SNAPSHOTS` bucket is unbound the capture soft-fails
+ * with `{ stored: false, reason: "no_binding" }` and the snapshot fields are
+ * omitted — capture is best-effort and never errors ingest.
+ */
+export declare const RawSnapshotResponseSchema: z.ZodObject<{
+    stored: z.ZodBoolean;
+    r2Key: z.ZodOptional<z.ZodString>;
+    contentHash: z.ZodOptional<z.ZodString>;
+    bytes: z.ZodOptional<z.ZodNumber>;
+    reason: z.ZodOptional<z.ZodEnum<{
+        no_binding: "no_binding";
+    }>>;
+}, z.core.$strip>;
+/**
+ * Row returned by `GET /v1/sources/changelog-files/oversized`. Each row is a
+ * changelog file whose content length exceeds `?minBytes=` (default 256 KB).
+ * Used by `scripts/backfill-changelog-tokens.ts` to find rows with estimated
+ * (not exact) token counts.
+ */
+export declare const OversizedChangelogFileRowSchema: z.ZodObject<{
+    sourceId: z.ZodString;
+    sourceSlug: z.ZodString;
+    sourceName: z.ZodString;
+    orgSlug: z.ZodString;
+    path: z.ZodString;
+    filename: z.ZodString;
+    bytes: z.ZodNumber;
+    tokens: z.ZodNullable<z.ZodNumber>;
+    fetchedAt: z.ZodString;
+}, z.core.$strip>;
+export declare const OversizedChangelogFilesResponseSchema: z.ZodArray<z.ZodObject<{
+    sourceId: z.ZodString;
+    sourceSlug: z.ZodString;
+    sourceName: z.ZodString;
+    orgSlug: z.ZodString;
+    path: z.ZodString;
+    filename: z.ZodString;
+    bytes: z.ZodNumber;
+    tokens: z.ZodNullable<z.ZodNumber>;
+    fetchedAt: z.ZodString;
+}, z.core.$strip>>;
+/**
+ * Response for `GET /v1/sources/fetchable`. Returns raw source rows matching
+ * the requested fetch mode (`?mode=unfetched|stale|retry_errors|all`).
+ * Accepts `?staleHours=N` when `mode=stale`.
+ */
+export declare const FetchableSourcesResponseSchema: z.ZodArray<z.ZodObject<{
+    id: z.ZodString;
+    slug: z.ZodString;
+    name: z.ZodString;
+    type: z.ZodEnum<{
+        agent: "agent";
+        appstore: "appstore";
+        feed: "feed";
+        github: "github";
+        scrape: "scrape";
+        video: "video";
+    }>;
+    url: z.ZodString;
+    metadata: z.ZodNullable<z.ZodString>;
+}, z.core.$loose>>;
+/**
+ * Response for `GET /v1/sources/feeds`. Returns visible source rows where
+ * `metadata.feedUrl` is set and `fetchPriority != 'paused'`.
+ */
+export declare const FeedSourcesResponseSchema: z.ZodArray<z.ZodObject<{
+    id: z.ZodString;
+    slug: z.ZodString;
+    name: z.ZodString;
+    type: z.ZodEnum<{
+        agent: "agent";
+        appstore: "appstore";
+        feed: "feed";
+        github: "github";
+        scrape: "scrape";
+        video: "video";
+    }>;
+    url: z.ZodString;
+    metadata: z.ZodNullable<z.ZodString>;
+}, z.core.$loose>>;
+/**
+ * Response for `GET /v1/sources/changes`. Returns visible source rows that
+ * have a non-null `changeDetectedAt` — the set flagged for CLI pickup.
+ */
+export declare const ChangedSourcesResponseSchema: z.ZodArray<z.ZodObject<{
+    id: z.ZodString;
+    slug: z.ZodString;
+    name: z.ZodString;
+    type: z.ZodEnum<{
+        agent: "agent";
+        appstore: "appstore";
+        feed: "feed";
+        github: "github";
+        scrape: "scrape";
+        video: "video";
+    }>;
+    url: z.ZodString;
+    metadata: z.ZodNullable<z.ZodString>;
+}, z.core.$loose>>;
+//# sourceMappingURL=sources.d.ts.map