@laplace.live/internal 1.3.13 → 1.3.15

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@laplace.live/internal",
-  "version": "1.3.13",
+  "version": "1.3.15",
   "module": "src/index.d.ts",
   "exports": {
     ".": "./src/index.d.ts",

package/src/namespaces/laplace.d.ts

@@ -979,6 +979,12 @@ export declare namespace LaplaceInternal {
         /** ISO timestamp string */
         reviewedAt?: string
         rejectReason?: string
+        /** AI review state (see FertilityAiStatus). Null when never checked. */
+        aiStatus?: FertilityAiStatus | null
+        /** AI review verdict (see FertilityAiVerdict). Null when running, errored, or skipped without a verdict. */
+        aiVerdict?: FertilityAiVerdict | null
+        /** AI review per-attempt payload (see FertilityAiData). Null when never checked. */
+        aiData?: FertilityAiData | null
       }
 
       /**
@@ -1073,6 +1079,92 @@ export declare namespace LaplaceInternal {
         avgProcessingTimeHours: number | null
       }
 
+      // ============================================
+      // Fertility AI Check Types
+      // ============================================
+
+      /**
+       * AI review session lifecycle on our side.
+       * - `running`  — Browser Use session dispatched, waiting for terminal status
+       * - `done`     — verdict landed (see aiVerdict)
+       * - `errored`  — Browser Use failed or returned non-conforming output
+       * - `skipped`  — source URL was off-list (e.g. not a Bilibili page); never dispatched
+       */
+      export type FertilityAiStatus = 'running' | 'done' | 'errored' | 'skipped'
+
+      /** Verdict produced by evaluating the AI's structured output against the contribution's claim. */
+      export type FertilityAiVerdict = 'valid' | 'invalid' | 'inconclusive'
+
+      /**
+       * What the system did automatically based on the verdict.
+       * - `approved`                   — verdict was `valid`; approveFertilityContribution succeeded
+       * - `flagged`                    — verdict was `invalid` or `inconclusive`; row stays pending for admin review
+       * - `approve_failed_duplicate`   — verdict was `valid` but approval bounced because the period already exists in production
+       * - `skipped_unsupported`        — source URL was not Bilibili; no AI call made
+       */
+      export type FertilityAiAutoActionResult =
+        | 'approved'
+        | 'flagged'
+        | 'approve_failed_duplicate'
+        | 'skipped_unsupported'
+
+      /**
+       * Structured output the Browser Use agent returns (matches FERTILITY_AI_OUTPUT_SCHEMA).
+       */
+      export interface FertilityAiEvidence {
+        extractedUid: number | null
+        uidMatches: boolean
+        /**
+         * YYYY-MM-DD in Asia/Shanghai; the date the content claims the period began.
+         *
+         * Disambiguation rules baked into the AI prompt:
+         * - Explicit qualifier ("今天/昨天/上周三") → resolved against post date.
+         * - No qualifier at all ("魔法期来了") → treated as "now", uses post date.
+         * - Vague non-anchorable past ("前几天/最近/上周") → null.
+         */
+        extractedPeriodStartDate: string | null
+        /** YYYY-MM-DD in Asia/Shanghai; the post's publish date (auxiliary). */
+        postedAt: string | null
+        contentMentionsPeriod: boolean
+        evidenceQuote: string | null
+        pageType: 'video' | 'dynamic' | 'livestream_replay' | 'space' | 'unknown'
+        confidence: number
+        notes: string | null
+      }
+
+      /**
+       * Payload stored in bilibili_fertility_contributions.ai_data (jsonb).
+       * Used both by the workers and by Drizzle via $type<>().
+       */
+      export interface FertilityAiData {
+        sessionId: string
+        model: string
+        liveUrl?: string
+        /** ISO 8601 */
+        startedAt: string
+        /** ISO 8601, set when status leaves 'running' */
+        checkedAt?: string
+        costUsd?: string
+        confidence?: number
+        evidence?: FertilityAiEvidence
+        autoActionResult?: FertilityAiAutoActionResult
+        errorMessage?: string
+      }
+
+      /**
+       * Response shape for POST /laplace/fertility-contribution-ai-check/:id
+       * and GET /laplace/fertility-contribution-ai-check/:id.
+       */
+      export interface FertilityAiCheckResponse {
+        id: number
+        contributionStatus: ContributionStatus
+        ai: {
+          status: FertilityAiStatus | null
+          verdict: FertilityAiVerdict | null
+          data: FertilityAiData | null
+        }
+      }
+
       // ============================================
       // Meme Types
       // ============================================