@steipete/summarize-core 0.11.1 → 0.13.0

package/dist/types/transcription/whisper/provider-setup.d.ts

@@ -0,0 +1,30 @@
+type Env = Record<string, string | undefined>;
+export declare const DEFAULT_GEMINI_TRANSCRIPTION_MODEL = "gemini-2.5-flash";
+export declare const GEMINI_TRANSCRIPTION_MODEL_ENV = "SUMMARIZE_GEMINI_TRANSCRIPTION_MODEL";
+export declare const TRANSCRIPTION_PROVIDER_ENV_LIST: readonly ["GROQ_API_KEY", "ASSEMBLYAI_API_KEY", "GEMINI_API_KEY", "OPENAI_API_KEY", "FAL_KEY"];
+export declare const TRANSCRIPTION_PROVIDER_ENV_LABEL = "GROQ_API_KEY, ASSEMBLYAI_API_KEY, GEMINI_API_KEY, OPENAI_API_KEY, or FAL_KEY";
+export declare function normalizeApiKey(raw: string | null | undefined): string | null;
+export declare function resolveGeminiApiKey({ env, geminiApiKey, }: {
+    env?: Env;
+    geminiApiKey?: string | null;
+}): string | null;
+export declare function resolveGroqApiKey({ env, groqApiKey, }: {
+    env?: Env;
+    groqApiKey?: string | null;
+}): string | null;
+export declare function resolveAssemblyAiApiKey({ env, assemblyaiApiKey, }: {
+    env?: Env;
+    assemblyaiApiKey?: string | null;
+}): string | null;
+export declare function resolveOpenAiTranscriptionApiKey({ env, openaiApiKey, }: {
+    env?: Env;
+    openaiApiKey?: string | null;
+}): string | null;
+export declare function resolveFalApiKey({ env, falApiKey, }: {
+    env?: Env;
+    falApiKey?: string | null;
+}): string | null;
+export declare function resolveGeminiTranscriptionModel(env?: Env): string;
+export declare function buildMissingTranscriptionProviderMessage(): string;
+export declare function buildMissingTranscriptionProviderNote(): string;
+export {};

package/dist/types/transcription/whisper/remote-provider-attempts.d.ts

@@ -0,0 +1,51 @@
+import type { CloudProvider } from "./cloud-providers.js";
+import type { WhisperProgressEvent, WhisperTranscriptionResult } from "./types.js";
+type Env = Record<string, string | undefined>;
+export type RemoteByteState = {
+    bytes: Uint8Array;
+    mediaType: string;
+    filename: string | null;
+};
+type RemoteByteAttemptResult = {
+    state: RemoteByteState;
+    result: WhisperTranscriptionResult | null;
+    error: Error | null;
+    skipped?: boolean;
+};
+type RemoteFileAttemptResult = {
+    kind: "result";
+    result: WhisperTranscriptionResult;
+} | {
+    kind: "error";
+    error: Error;
+} | {
+    kind: "delegate-to-bytes";
+};
+type TranscribeOversizedBytesWithChunking = (args: {
+    bytes: Uint8Array;
+    mediaType: string;
+    filename: string | null;
+    onProgress?: ((event: WhisperProgressEvent) => void) | null;
+}) => Promise<WhisperTranscriptionResult>;
+export declare function attemptRemoteBytesProvider(args: {
+    provider: CloudProvider;
+    state: RemoteByteState;
+    assemblyaiApiKey: string | null;
+    geminiApiKey: string | null;
+    openaiApiKey: string | null;
+    falApiKey: string | null;
+    env: Env;
+    notes: string[];
+    onProgress?: ((event: WhisperProgressEvent) => void) | null;
+    transcribeOversizedBytesWithChunking?: TranscribeOversizedBytesWithChunking;
+}): Promise<RemoteByteAttemptResult>;
+export declare function attemptRemoteFileProvider(args: {
+    provider: CloudProvider;
+    filePath: string;
+    mediaType: string;
+    filename: string | null;
+    assemblyaiApiKey: string | null;
+    geminiApiKey: string | null;
+    env: Env;
+}): Promise<RemoteFileAttemptResult>;
+export {};

package/dist/types/transcription/whisper/remote.d.ts

@@ -0,0 +1,51 @@
+import type { WhisperProgressEvent, WhisperTranscriptionResult } from "./types.js";
+type Env = Record<string, string | undefined>;
+type CloudArgs = {
+    groqApiKey: string | null;
+    groqError?: Error | null;
+    assemblyaiApiKey: string | null;
+    geminiApiKey: string | null;
+    openaiApiKey: string | null;
+    falApiKey: string | null;
+    env: Env;
+};
+export declare function transcribeBytesWithRemoteFallbacks({ bytes, mediaType, filename, notes, groqApiKey, groqError, assemblyaiApiKey, geminiApiKey, openaiApiKey, falApiKey, env, onProgress, transcribeOversizedBytesWithChunking, }: {
+    bytes: Uint8Array;
+    mediaType: string;
+    filename: string | null;
+    notes: string[];
+    onProgress?: ((event: WhisperProgressEvent) => void) | null;
+    transcribeOversizedBytesWithChunking: (args: {
+        bytes: Uint8Array;
+        mediaType: string;
+        filename: string | null;
+        onProgress?: ((event: WhisperProgressEvent) => void) | null;
+    }) => Promise<WhisperTranscriptionResult>;
+} & CloudArgs): Promise<WhisperTranscriptionResult>;
+export declare function transcribeFileWithRemoteFallbacks({ filePath, mediaType, filename, notes, groqApiKey, groqError, assemblyaiApiKey, geminiApiKey, openaiApiKey, falApiKey, env, totalDurationSeconds, onProgress, transcribeChunkedFile, }: {
+    filePath: string;
+    mediaType: string;
+    filename: string | null;
+    notes: string[];
+    totalDurationSeconds: number | null;
+    onProgress?: ((event: WhisperProgressEvent) => void) | null;
+    transcribeChunkedFile: (args: {
+        filePath: string;
+        segmentSeconds: number;
+        totalDurationSeconds: number | null;
+        onProgress?: ((event: WhisperProgressEvent) => void) | null;
+    }) => Promise<WhisperTranscriptionResult>;
+} & CloudArgs): Promise<WhisperTranscriptionResult>;
+export declare function transcribeOversizedBytesViaTempFile({ bytes, mediaType, filename, onProgress, transcribeFile, }: {
+    bytes: Uint8Array;
+    mediaType: string;
+    filename: string | null;
+    onProgress?: ((event: WhisperProgressEvent) => void) | null;
+    transcribeFile: (args: {
+        filePath: string;
+        mediaType: string;
+        filename: string | null;
+        onProgress?: ((event: WhisperProgressEvent) => void) | null;
+    }) => Promise<WhisperTranscriptionResult>;
+}): Promise<WhisperTranscriptionResult>;
+export {};

package/dist/types/transcription/whisper/types.d.ts

@@ -1,4 +1,4 @@
-export type TranscriptionProvider = "groq" | "openai" | "fal" | "whisper.cpp" | "onnx-parakeet" | "onnx-canary";
+export type TranscriptionProvider = "groq" | "assemblyai" | "gemini" | "openai" | "fal" | "whisper.cpp" | "onnx-parakeet" | "onnx-canary";
 export type WhisperTranscriptionResult = {
     text: string | null;
     provider: TranscriptionProvider | null;

package/dist/types/transcription/whisper/whisper-cpp.d.ts

@@ -1,9 +1,10 @@
 import type { WhisperProgressEvent, WhisperTranscriptionResult } from "./types.js";
-export declare function isWhisperCppReady(): Promise<boolean>;
-export declare function resolveWhisperCppModelNameForDisplay(): Promise<string | null>;
-export declare function transcribeWithWhisperCppFile({ filePath, mediaType, totalDurationSeconds, onProgress, }: {
+export declare function isWhisperCppReady(env?: Record<string, string | undefined>): Promise<boolean>;
+export declare function resolveWhisperCppModelNameForDisplay(env?: Record<string, string | undefined>): Promise<string | null>;
+export declare function transcribeWithWhisperCppFile({ filePath, mediaType, totalDurationSeconds, onProgress, env, }: {
     filePath: string;
     mediaType: string;
     totalDurationSeconds: number | null;
     onProgress?: ((event: WhisperProgressEvent) => void) | null;
+    env?: Record<string, string | undefined>;
 }): Promise<WhisperTranscriptionResult>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@steipete/summarize-core",
-  "version": "0.11.1",
+  "version": "0.13.0",
   "description": "Summarize core library (content extraction + prompts).",
   "files": [
     "dist",
@@ -23,6 +23,10 @@
       "types": "./dist/types/content/url.d.ts",
       "import": "./dist/esm/content/url.js"
     },
+    "./content/local-file": {
+      "types": "./dist/types/content/local-file.d.ts",
+      "import": "./dist/esm/content/local-file.js"
+    },
     "./prompts": {
       "types": "./dist/types/prompts/index.d.ts",
       "import": "./dist/esm/prompts/index.js"
@@ -37,19 +41,19 @@
     }
   },
   "dependencies": {
-    "@fal-ai/client": "^1.9.1",
+    "@fal-ai/client": "^1.9.5",
     "@mozilla/readability": "0.6.0",
     "cheerio": "^1.2.0",
-    "es-toolkit": "^1.44.0",
-    "jsdom": "28.0.0",
-    "sanitize-html": "^2.17.0"
+    "es-toolkit": "^1.45.1",
+    "jsdom": "29.0.2",
+    "sanitize-html": "^2.17.2"
   },
   "devDependencies": {
-    "@types/jsdom": "^27.0.0",
-    "@types/node": "^25.2.3",
-    "@types/sanitize-html": "^2.16.0",
-    "rimraf": "^6.1.2",
-    "typescript": "^5.9.3"
+    "@types/jsdom": "^28.0.1",
+    "@types/node": "^25.5.2",
+    "@types/sanitize-html": "^2.16.1",
+    "rimraf": "^6.1.3",
+    "typescript": "^6.0.2"
   },
   "engines": {
     "node": ">=22"