@sylphx/contract 0.2.0

package/dist/endpoints/admin-billing.js

@@ -0,0 +1,190 @@
+/**
+ * Admin Billing endpoints — Console operator dashboard billing operations.
+ * Mirrors `apps/api/src/server/platform/routes/admin-billing/`.
+ *
+ * Production mount: `/admin/billing/*`.
+ */
+import { defineEndpoint } from '../endpoint.js';
+import { AdminBillingAddCreditsInput, AdminBillingInvoiceParams, AdminBillingListQuery, AdminBillingMonthlyQuery, AdminBillingOrgParams, AdminBillingTransactionsQuery, AdminBillingUnknownInput, AdminBillingUnknownResult, AdminBillingUpdateSettingsInput, AdminBillingUsageQuery, } from '../schemas/admin-billing.js';
+export const adminBillingEndpoints = {
+    // ── Overview ───────────────────────────────────────────────────────────
+    overview: defineEndpoint({
+        method: 'GET',
+        path: '/admin/billing/overview',
+        response: AdminBillingUnknownResult,
+        plane: 'admin',
+        summary: "Billing overview for the current user's org",
+        tags: ['admin-billing'],
+    }),
+    // ── Stats ──────────────────────────────────────────────────────────────
+    stats: defineEndpoint({
+        method: 'GET',
+        path: '/admin/billing/stats',
+        response: AdminBillingUnknownResult,
+        plane: 'admin',
+        summary: 'Platform-wide billing statistics',
+        tags: ['admin-billing'],
+    }),
+    // ── Usage ──────────────────────────────────────────────────────────────
+    platformUsage: defineEndpoint({
+        method: 'GET',
+        path: '/admin/billing/usage/platform',
+        query: AdminBillingUsageQuery,
+        response: AdminBillingUnknownResult,
+        plane: 'admin',
+        summary: 'Platform-wide usage report',
+        tags: ['admin-billing'],
+    }),
+    orgUsage: defineEndpoint({
+        method: 'GET',
+        path: '/admin/billing/usage/orgs/:orgId',
+        params: AdminBillingOrgParams,
+        query: AdminBillingUsageQuery,
+        response: AdminBillingUnknownResult,
+        plane: 'admin',
+        summary: 'Per-org usage report',
+        tags: ['admin-billing'],
+    }),
+    orgMonthlySummary: defineEndpoint({
+        method: 'GET',
+        path: '/admin/billing/usage/orgs/:orgId/monthly',
+        params: AdminBillingOrgParams,
+        query: AdminBillingMonthlyQuery,
+        response: AdminBillingUnknownResult,
+        plane: 'admin',
+        summary: 'Per-org monthly usage summary',
+        tags: ['admin-billing'],
+    }),
+    // ── Balances ───────────────────────────────────────────────────────────
+    listBalances: defineEndpoint({
+        method: 'GET',
+        path: '/admin/billing/balances',
+        query: AdminBillingListQuery,
+        response: AdminBillingUnknownResult,
+        plane: 'admin',
+        summary: 'List all org balances',
+        tags: ['admin-billing'],
+    }),
+    getBalance: defineEndpoint({
+        method: 'GET',
+        path: '/admin/billing/balances/:orgId',
+        params: AdminBillingOrgParams,
+        response: AdminBillingUnknownResult,
+        plane: 'admin',
+        summary: 'Get org balance details',
+        tags: ['admin-billing'],
+    }),
+    getTransactions: defineEndpoint({
+        method: 'GET',
+        path: '/admin/billing/balances/:orgId/transactions',
+        params: AdminBillingOrgParams,
+        query: AdminBillingTransactionsQuery,
+        response: AdminBillingUnknownResult,
+        plane: 'admin',
+        summary: 'Get org balance transactions',
+        tags: ['admin-billing'],
+    }),
+    addCredits: defineEndpoint({
+        method: 'POST',
+        path: '/admin/billing/balances/:orgId/credits',
+        params: AdminBillingOrgParams,
+        body: AdminBillingAddCreditsInput,
+        response: AdminBillingUnknownResult,
+        plane: 'admin',
+        summary: 'Add credits to an org balance',
+        tags: ['admin-billing'],
+    }),
+    updateBalanceSettings: defineEndpoint({
+        method: 'PATCH',
+        path: '/admin/billing/balances/:orgId/settings',
+        params: AdminBillingOrgParams,
+        body: AdminBillingUpdateSettingsInput,
+        response: AdminBillingUnknownResult,
+        plane: 'admin',
+        summary: 'Update balance settings (alerts + auto top-up)',
+        tags: ['admin-billing'],
+    }),
+    // ── Invoices ───────────────────────────────────────────────────────────
+    listInvoices: defineEndpoint({
+        method: 'GET',
+        path: '/admin/billing/invoices',
+        query: AdminBillingListQuery,
+        response: AdminBillingUnknownResult,
+        plane: 'admin',
+        summary: 'List invoices across all orgs',
+        tags: ['admin-billing'],
+    }),
+    getInvoice: defineEndpoint({
+        method: 'GET',
+        path: '/admin/billing/invoices/:invoiceId',
+        params: AdminBillingInvoiceParams,
+        response: AdminBillingUnknownResult,
+        plane: 'admin',
+        summary: 'Get invoice details',
+        tags: ['admin-billing'],
+    }),
+    getOrgInvoices: defineEndpoint({
+        method: 'GET',
+        path: '/admin/billing/orgs/:orgId/invoices',
+        params: AdminBillingOrgParams,
+        query: AdminBillingListQuery,
+        response: AdminBillingUnknownResult,
+        plane: 'admin',
+        summary: 'List invoices for a specific org',
+        tags: ['admin-billing'],
+    }),
+    generateInvoice: defineEndpoint({
+        method: 'POST',
+        path: '/admin/billing/orgs/:orgId/invoices',
+        params: AdminBillingOrgParams,
+        body: AdminBillingUnknownInput,
+        response: AdminBillingUnknownResult,
+        plane: 'admin',
+        summary: 'Generate a manual invoice for an org',
+        tags: ['admin-billing'],
+    }),
+    finalizeInvoice: defineEndpoint({
+        method: 'POST',
+        path: '/admin/billing/invoices/:invoiceId/finalize',
+        params: AdminBillingInvoiceParams,
+        response: AdminBillingUnknownResult,
+        plane: 'admin',
+        summary: 'Finalize a draft invoice',
+        tags: ['admin-billing'],
+    }),
+    // ── Pricing ────────────────────────────────────────────────────────────
+    getPricing: defineEndpoint({
+        method: 'GET',
+        path: '/admin/billing/pricing',
+        response: AdminBillingUnknownResult,
+        plane: 'admin',
+        summary: 'Get pricing configuration',
+        tags: ['admin-billing'],
+    }),
+    updatePricing: defineEndpoint({
+        method: 'PATCH',
+        path: '/admin/billing/pricing',
+        body: AdminBillingUnknownInput,
+        response: AdminBillingUnknownResult,
+        plane: 'admin',
+        summary: 'Update pricing configuration',
+        tags: ['admin-billing'],
+    }),
+    // ── Analysis ───────────────────────────────────────────────────────────
+    costAnalysis: defineEndpoint({
+        method: 'GET',
+        path: '/admin/billing/analysis/costs',
+        response: AdminBillingUnknownResult,
+        plane: 'admin',
+        summary: 'Platform-wide cost analysis',
+        tags: ['admin-billing'],
+    }),
+    topConsumers: defineEndpoint({
+        method: 'GET',
+        path: '/admin/billing/analysis/top-consumers',
+        response: AdminBillingUnknownResult,
+        plane: 'admin',
+        summary: 'Ranked list of top resource consumers',
+        tags: ['admin-billing'],
+    }),
+};

package/dist/endpoints/admin-bootstrap.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Admin Bootstrap endpoints — reset-window surface (ADR-089 §2.7 Phase 7 Commit B).
+ *
+ * Mirrors `apps/api/src/server/platform/routes/admin/bootstrap.ts`. Companion
+ * to the runtime-plane `POST /v1/auth/bootstrap-signup` — where that one
+ * CONSUMES the window once and then locks, this one RE-OPENS it under the
+ * authority of an existing super-admin session.
+ */
+export declare const adminBootstrapEndpoints: {
+    readonly resetWindow: import("../endpoint.js").Endpoint<"POST", "/admin/reset-bootstrap-window", import("effect/Schema").Schema.AnyNoContext | undefined, import("effect/Schema").Schema.AnyNoContext | undefined, import("effect/Schema").Struct<{}>, import("effect/Schema").Struct<{
+        opened: typeof import("effect/Schema").Boolean;
+        ttlSeconds: typeof import("effect/Schema").Number;
+        message: typeof import("effect/Schema").String;
+    }>>;
+};
+//# sourceMappingURL=admin-bootstrap.d.ts.map

package/dist/endpoints/admin-bootstrap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"admin-bootstrap.d.ts","sourceRoot":"","sources":["../../src/endpoints/admin-bootstrap.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAQH,eAAO,MAAM,uBAAuB;;;;;;CAkB1B,CAAA"}

package/dist/endpoints/admin-bootstrap.js

@@ -0,0 +1,28 @@
+/**
+ * Admin Bootstrap endpoints — reset-window surface (ADR-089 §2.7 Phase 7 Commit B).
+ *
+ * Mirrors `apps/api/src/server/platform/routes/admin/bootstrap.ts`. Companion
+ * to the runtime-plane `POST /v1/auth/bootstrap-signup` — where that one
+ * CONSUMES the window once and then locks, this one RE-OPENS it under the
+ * authority of an existing super-admin session.
+ */
+import { defineEndpoint } from '../endpoint.js';
+import { ResetBootstrapWindowInput, ResetBootstrapWindowResult, } from '../schemas/admin-bootstrap.js';
+export const adminBootstrapEndpoints = {
+    resetWindow: defineEndpoint({
+        method: 'POST',
+        path: '/admin/reset-bootstrap-window',
+        body: ResetBootstrapWindowInput,
+        response: ResetBootstrapWindowResult,
+        plane: 'admin',
+        summary: 'Re-open the Appwrite-pattern bootstrap window',
+        description: 'Forcibly sets the `bootstrap:window:open` Redis key (TTL 600s) so ' +
+            'another call to `POST /v1/auth/bootstrap-signup` will succeed. ' +
+            'Requires a super-admin platform session. The window normally opens ' +
+            'exactly once per fresh cluster and closes itself on first successful ' +
+            'bootstrap signup; this endpoint is the documented recovery path when ' +
+            'the window expires before an operator can use it, or when a second ' +
+            'recovery admin needs to be created via the same flow.',
+        tags: ['admin-bootstrap'],
+    }),
+};

package/dist/endpoints/admin-broadcasts.d.ts

@@ -0,0 +1,105 @@
+/**
+ * Admin Broadcasts endpoints — Console operator dashboard broadcast ops.
+ * Mirrors `apps/api/src/server/platform/routes/admin/broadcasts.ts`.
+ *
+ * Production mount: `/admin/broadcasts/*`. Per-project DB is resolved from
+ * `?projectId=`, so every operation takes that query param.
+ */
+export declare const adminBroadcastsEndpoints: {
+    readonly create: import("../endpoint.js").Endpoint<"POST", "/admin/broadcasts/broadcasts", import("effect/Schema").Schema.AnyNoContext | undefined, import("effect/Schema").Struct<{
+        projectId: typeof import("effect/Schema").String;
+    }>, import("effect/Schema").Struct<{
+        type: import("effect/Schema").Literal<["email", "push", "in_app"]>;
+        targetSegment: import("effect/Schema").optional<import("effect/Schema").Literal<["all", "active", "premium"]>>;
+        targetAppIds: import("effect/Schema").optional<import("effect/Schema").Array$<typeof import("effect/Schema").String>>;
+        subject: import("effect/Schema").optional<typeof import("effect/Schema").String>;
+        content: typeof import("effect/Schema").String;
+        scheduledAt: import("effect/Schema").optional<typeof import("effect/Schema").String>;
+    }>, import("effect/Schema").Struct<{
+        id: typeof import("effect/Schema").String;
+        type: import("effect/Schema").Literal<["email", "push", "in_app"]>;
+        status: import("effect/Schema").Literal<["draft", "scheduled", "sending", "sent", "failed"]>;
+        subject: import("effect/Schema").NullOr<typeof import("effect/Schema").String>;
+        scheduledAt: import("effect/Schema").NullOr<typeof import("effect/Schema").String>;
+        createdAt: typeof import("effect/Schema").String;
+    }>>;
+    readonly list: import("../endpoint.js").Endpoint<"GET", "/admin/broadcasts/broadcasts", import("effect/Schema").Schema.AnyNoContext | undefined, import("effect/Schema").Struct<{
+        projectId: typeof import("effect/Schema").String;
+        limit: import("effect/Schema").optional<typeof import("effect/Schema").String>;
+        offset: import("effect/Schema").optional<typeof import("effect/Schema").String>;
+    }>, import("effect/Schema").Schema.AnyNoContext | undefined, import("effect/Schema").Struct<{
+        broadcasts: import("effect/Schema").Array$<import("effect/Schema").Struct<{
+            id: typeof import("effect/Schema").String;
+            type: import("effect/Schema").Literal<["email", "push", "in_app"]>;
+            status: import("effect/Schema").Literal<["draft", "scheduled", "sending", "sent", "failed"]>;
+            targetSegment: typeof import("effect/Schema").String;
+            subject: import("effect/Schema").NullOr<typeof import("effect/Schema").String>;
+            scheduledAt: import("effect/Schema").NullOr<typeof import("effect/Schema").String>;
+            sentAt: import("effect/Schema").NullOr<typeof import("effect/Schema").String>;
+            stats: import("effect/Schema").NullOr<import("effect/Schema").Struct<{
+                totalRecipients: import("effect/Schema").optional<typeof import("effect/Schema").Number>;
+                sent: import("effect/Schema").optional<typeof import("effect/Schema").Number>;
+                opened: import("effect/Schema").optional<typeof import("effect/Schema").Number>;
+                clicked: import("effect/Schema").optional<typeof import("effect/Schema").Number>;
+                bounced: import("effect/Schema").optional<typeof import("effect/Schema").Number>;
+                unsubscribed: import("effect/Schema").optional<typeof import("effect/Schema").Number>;
+            }>>;
+            createdAt: typeof import("effect/Schema").String;
+            createdBy: import("effect/Schema").NullOr<import("effect/Schema").Struct<{
+                id: typeof import("effect/Schema").String;
+                name: import("effect/Schema").NullOr<typeof import("effect/Schema").String>;
+                email: typeof import("effect/Schema").String;
+            }>>;
+        }>>;
+        total: typeof import("effect/Schema").Number;
+    }>>;
+    readonly get: import("../endpoint.js").Endpoint<"GET", "/admin/broadcasts/broadcasts/:id", import("effect/Schema").Struct<{
+        id: typeof import("effect/Schema").String;
+    }>, import("effect/Schema").Struct<{
+        projectId: typeof import("effect/Schema").String;
+    }>, import("effect/Schema").Schema.AnyNoContext | undefined, import("effect/Schema").Struct<{
+        broadcast: import("effect/Schema").Struct<{
+            id: typeof import("effect/Schema").String;
+            type: import("effect/Schema").Literal<["email", "push", "in_app"]>;
+            status: import("effect/Schema").Literal<["draft", "scheduled", "sending", "sent", "failed"]>;
+            targetSegment: typeof import("effect/Schema").String;
+            targetAppIds: import("effect/Schema").NullOr<import("effect/Schema").Array$<typeof import("effect/Schema").String>>;
+            subject: import("effect/Schema").NullOr<typeof import("effect/Schema").String>;
+            content: import("effect/Schema").NullOr<typeof import("effect/Schema").String>;
+            richContent: import("effect/Schema").NullOr<typeof import("effect/Schema").Unknown>;
+            scheduledAt: import("effect/Schema").NullOr<typeof import("effect/Schema").String>;
+            sentAt: import("effect/Schema").NullOr<typeof import("effect/Schema").String>;
+            stats: import("effect/Schema").NullOr<import("effect/Schema").Struct<{
+                totalRecipients: import("effect/Schema").optional<typeof import("effect/Schema").Number>;
+                sent: import("effect/Schema").optional<typeof import("effect/Schema").Number>;
+                opened: import("effect/Schema").optional<typeof import("effect/Schema").Number>;
+                clicked: import("effect/Schema").optional<typeof import("effect/Schema").Number>;
+                bounced: import("effect/Schema").optional<typeof import("effect/Schema").Number>;
+                unsubscribed: import("effect/Schema").optional<typeof import("effect/Schema").Number>;
+            }>>;
+            createdBy: import("effect/Schema").NullOr<typeof import("effect/Schema").String>;
+            createdAt: typeof import("effect/Schema").String;
+            updatedAt: typeof import("effect/Schema").String;
+        }>;
+    }>>;
+    readonly send: import("../endpoint.js").Endpoint<"POST", "/admin/broadcasts/broadcasts/:id/send", import("effect/Schema").Struct<{
+        id: typeof import("effect/Schema").String;
+    }>, import("effect/Schema").Struct<{
+        projectId: typeof import("effect/Schema").String;
+    }>, import("effect/Schema").Schema.AnyNoContext | undefined, import("effect/Schema").Struct<{
+        success: typeof import("effect/Schema").Boolean;
+        stats: import("effect/Schema").Struct<{
+            totalRecipients: typeof import("effect/Schema").Number;
+            sent: typeof import("effect/Schema").Number;
+            failed: typeof import("effect/Schema").Number;
+        }>;
+    }>>;
+    readonly delete: import("../endpoint.js").Endpoint<"DELETE", "/admin/broadcasts/broadcasts/:id", import("effect/Schema").Struct<{
+        id: typeof import("effect/Schema").String;
+    }>, import("effect/Schema").Struct<{
+        projectId: typeof import("effect/Schema").String;
+    }>, import("effect/Schema").Schema.AnyNoContext | undefined, import("effect/Schema").Struct<{
+        success: typeof import("effect/Schema").Boolean;
+    }>>;
+};
+//# sourceMappingURL=admin-broadcasts.d.ts.map

package/dist/endpoints/admin-broadcasts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"admin-broadcasts.d.ts","sourceRoot":"","sources":["../../src/endpoints/admin-broadcasts.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAeH,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkD3B,CAAA"}

package/dist/endpoints/admin-broadcasts.js

@@ -0,0 +1,60 @@
+/**
+ * Admin Broadcasts endpoints — Console operator dashboard broadcast ops.
+ * Mirrors `apps/api/src/server/platform/routes/admin/broadcasts.ts`.
+ *
+ * Production mount: `/admin/broadcasts/*`. Per-project DB is resolved from
+ * `?projectId=`, so every operation takes that query param.
+ */
+import { defineEndpoint } from '../endpoint.js';
+import { AdminBroadcastIdParams, AdminBroadcastProjectQuery, AdminCreateBroadcastInput, AdminCreateBroadcastResult, AdminDeleteBroadcastResult, AdminGetBroadcastResult, AdminListBroadcastsQuery, AdminListBroadcastsResult, AdminSendBroadcastResult, } from '../schemas/admin-broadcasts.js';
+export const adminBroadcastsEndpoints = {
+    create: defineEndpoint({
+        method: 'POST',
+        path: '/admin/broadcasts/broadcasts',
+        query: AdminBroadcastProjectQuery,
+        body: AdminCreateBroadcastInput,
+        response: AdminCreateBroadcastResult,
+        plane: 'admin',
+        summary: 'Create a new broadcast (email/push/in-app)',
+        tags: ['admin-broadcasts'],
+    }),
+    list: defineEndpoint({
+        method: 'GET',
+        path: '/admin/broadcasts/broadcasts',
+        query: AdminListBroadcastsQuery,
+        response: AdminListBroadcastsResult,
+        plane: 'admin',
+        summary: 'List broadcasts with pagination',
+        tags: ['admin-broadcasts'],
+    }),
+    get: defineEndpoint({
+        method: 'GET',
+        path: '/admin/broadcasts/broadcasts/:id',
+        params: AdminBroadcastIdParams,
+        query: AdminBroadcastProjectQuery,
+        response: AdminGetBroadcastResult,
+        plane: 'admin',
+        summary: 'Get a broadcast by ID',
+        tags: ['admin-broadcasts'],
+    }),
+    send: defineEndpoint({
+        method: 'POST',
+        path: '/admin/broadcasts/broadcasts/:id/send',
+        params: AdminBroadcastIdParams,
+        query: AdminBroadcastProjectQuery,
+        response: AdminSendBroadcastResult,
+        plane: 'admin',
+        summary: 'Send a draft or scheduled broadcast immediately',
+        tags: ['admin-broadcasts'],
+    }),
+    delete: defineEndpoint({
+        method: 'DELETE',
+        path: '/admin/broadcasts/broadcasts/:id',
+        params: AdminBroadcastIdParams,
+        query: AdminBroadcastProjectQuery,
+        response: AdminDeleteBroadcastResult,
+        plane: 'admin',
+        summary: 'Delete a draft or scheduled broadcast',
+        tags: ['admin-broadcasts'],
+    }),
+};

package/dist/endpoints/admin-builds.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Admin Builds endpoints — operator-only recovery surface (OPS-1 + OPS-7).
+ *
+ * Mirrors `apps/api/src/server/platform/routes/admin/builds.ts`. Replaces
+ * the manual `UPDATE build_records SET status='failed' …` from the
+ * `BuildRecordsStuckInBuilding` runbook (line 117–127, 141–147). The CLI
+ * (`sylphx admin builds reap`) is the canonical caller; the API is also
+ * reachable from CI / ops dashboards via service token.
+ *
+ * Auth: service token (`svc_*`) with scope `platform:builds:reap`.
+ *
+ * Plane: `admin`.
+ */
+export declare const adminBuildsEndpoints: {
+    readonly reap: import("../endpoint.js").Endpoint<"POST", "/admin/builds/reap", import("effect/Schema").Schema.AnyNoContext | undefined, import("effect/Schema").Schema.AnyNoContext | undefined, import("effect/Schema").Struct<{
+        olderThan: import("effect/Schema").filter<typeof import("effect/Schema").String>;
+        dryRun: import("effect/Schema").optional<typeof import("effect/Schema").Boolean>;
+        reason: import("effect/Schema").optional<import("effect/Schema").filter<import("effect/Schema").filter<typeof import("effect/Schema").String>>>;
+        imageDigest: import("effect/Schema").optional<import("effect/Schema").filter<typeof import("effect/Schema").String>>;
+    }>, import("effect/Schema").Struct<{
+        dryRun: typeof import("effect/Schema").Boolean;
+        reaped: typeof import("effect/Schema").Number;
+        digestCleared: typeof import("effect/Schema").Number;
+        records: import("effect/Schema").Array$<import("effect/Schema").Struct<{
+            id: typeof import("effect/Schema").String;
+            projectId: typeof import("effect/Schema").String;
+            envId: typeof import("effect/Schema").String;
+            startedAt: typeof import("effect/Schema").String;
+            ageSeconds: typeof import("effect/Schema").Number;
+        }>>;
+    }>>;
+};
+//# sourceMappingURL=admin-builds.d.ts.map

package/dist/endpoints/admin-builds.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"admin-builds.d.ts","sourceRoot":"","sources":["../../src/endpoints/admin-builds.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAKH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;CAqBvB,CAAA"}

package/dist/endpoints/admin-builds.js

@@ -0,0 +1,36 @@
+/**
+ * Admin Builds endpoints — operator-only recovery surface (OPS-1 + OPS-7).
+ *
+ * Mirrors `apps/api/src/server/platform/routes/admin/builds.ts`. Replaces
+ * the manual `UPDATE build_records SET status='failed' …` from the
+ * `BuildRecordsStuckInBuilding` runbook (line 117–127, 141–147). The CLI
+ * (`sylphx admin builds reap`) is the canonical caller; the API is also
+ * reachable from CI / ops dashboards via service token.
+ *
+ * Auth: service token (`svc_*`) with scope `platform:builds:reap`.
+ *
+ * Plane: `admin`.
+ */
+import { defineEndpoint } from '../endpoint.js';
+import { AdminBuildsReapInput, AdminBuildsReapResult } from '../schemas/admin-builds.js';
+export const adminBuildsEndpoints = {
+    reap: defineEndpoint({
+        method: 'POST',
+        path: '/admin/builds/reap',
+        body: AdminBuildsReapInput,
+        response: AdminBuildsReapResult,
+        plane: 'admin',
+        summary: 'Reap stuck `build_records` rows older than a duration window',
+        description: 'Transitions `build_records` rows where status=`building` and ' +
+            '`started_at < NOW() - olderThan` to status=`failed`, stamping ' +
+            '`finished_at = NOW()` and `failure_reason = "admin reap: " || reason`. ' +
+            'When `dryRun=true`, returns the candidate set without mutating ' +
+            'state; in that mode `reason` is optional. When `imageDigest` is ' +
+            'supplied (OPS-7), restricts the set to rows carrying that digest ' +
+            'and additionally NULLs the `image_digest` column on each reaped ' +
+            'row. Every call (success OR rejected) writes one `audit_logs` row ' +
+            'tagged `resourceType=build`, `source=api`. Requires service token ' +
+            'with scope `platform:builds:reap`.',
+        tags: ['admin-builds'],
+    }),
+};