@read-frog/api-contract 0.26.0 → 0.28.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@read-frog/api-contract",
-  "version": "0.26.0",
+  "version": "0.28.0",
   "private": false,
   "repository": {
     "type": "git",
@@ -25,7 +25,7 @@
   },
   "dependencies": {
     "@orpc/contract": "^1.16.1",
-    "@read-frog/definitions": "0.14.0",
+    "@read-frog/definitions": "0.15.1",
     "zod": "^4.6.7"
   },
   "devDependencies": {

package/src/contracts/speech.ts

@@ -1,5 +1,8 @@
 import { oc } from "@orpc/contract";
+import { z } from "zod";
 import {
+  speechDeleteAllAudioOutputSchema,
+  speechDeleteAudioInputSchema,
   speechPreferencesSchema,
   speechPreferencesUpdateInputSchema,
   speechSynthesizeInputSchema,
@@ -42,4 +45,21 @@ export const speechContract = {
     })
     .input(speechSynthesizeInputSchema)
     .output(speechSynthesizeOutputSchema),
+  deleteAudio: oc
+    .route({
+      method: "POST",
+      path: "/speech/audio/delete",
+      summary: "Forget the audio kept for some texts, so each is read anew next time",
+      tags: ["Speech"],
+    })
+    .input(speechDeleteAudioInputSchema)
+    .output(z.void()),
+  deleteAllAudio: oc
+    .route({
+      method: "DELETE",
+      path: "/speech/audio",
+      summary: "Forget all the audio kept for the authenticated user's texts",
+      tags: ["Speech"],
+    })
+    .output(speechDeleteAllAudioOutputSchema),
 };

package/src/schemas/hosted-ai.ts

@@ -280,14 +280,6 @@ export const HostedAiTierStatusSchema = z.strictObject({
    * signing in. Clients badge an option with it and offer that plan.
    */
   upgradeTo: HostedAiUpgradePlanSchema.nullable(),
-  /**
-   * @deprecated Read `upgradeTo`. Viewer-independent product fact: no
-   * non-Ultra account can ever use this feature/tier. Extensions released
-   * before `upgradeTo` badge options with it, including for Ultra accounts.
-   *
-   * TODO(2026-11-21): remove once those extensions have drained (#710).
-   */
-  requiresUltra: z.boolean(),
   modelRevision: z.string().trim().min(1),
 });
 
@@ -297,15 +289,6 @@ export const HostedAiFeatureStatusSchema = z.strictObject({
 });
 
 export const HostedAiStatusOutputSchema = z.strictObject({
-  /**
-   * @deprecated Read `pools`. This lists the recurring pools only, never a
-   * one-time one: extensions released before mengxi-ream/read-frog#2395 look
-   * up a label for every entry's `periodKind`, and one they do not know
-   * crashes their usage page. They also throw if the field is missing.
-   *
-   * TODO(2026-11-07): remove once those extensions have drained (#710).
-   */
-  credits: z.array(HostedAiRecurringCreditStatusSchema),
   /**
    * Everything that can pay for a feature, in the order the server draws on it:
    * the plan's recurring pools first, then one-time pools by soonest expiry. A

package/src/schemas/speech.ts

@@ -109,6 +109,29 @@ export const speechSynthesizeInputSchema = z
   .strict();
 export type SpeechSynthesizeInput = z.infer<typeof speechSynthesizeInputSchema>;
 
+/** The most texts one request forgets the audio of. */
+export const SPEECH_DELETE_AUDIO_MAX_TEXTS = 50;
+
+/**
+ * Texts whose kept audio to forget, each as it is asked to be read aloud
+ * (`speech.synthesize`): the next time one is, it is read anew. Audio for a
+ * text that has none kept is no error.
+ */
+export const speechDeleteAudioInputSchema = z
+  .object({
+    texts: z.array(speechSynthesizeInputSchema).min(1).max(SPEECH_DELETE_AUDIO_MAX_TEXTS),
+  })
+  .strict();
+export type SpeechDeleteAudioInput = z.infer<typeof speechDeleteAudioInputSchema>;
+
+export const speechDeleteAllAudioOutputSchema = z
+  .object({
+    // How many audio files there were.
+    deleted: z.number().int().nonnegative(),
+  })
+  .strict();
+export type SpeechDeleteAllAudioOutput = z.infer<typeof speechDeleteAllAudioOutputSchema>;
+
 /**
  * Where to download the audio, an MP3: a link to fetch at once, which stops
  * working at `expiresAt`.