@j-o-r/hello-dave 0.1.1 → 0.1.5

package/types/API/mureka/music.d.ts

@@ -0,0 +1,472 @@
+export type MurekaWord = {
+    /**
+     * - Start time in milliseconds
+     */
+    start: number;
+    /**
+     * - End time in milliseconds
+     */
+    end: number;
+    /**
+     * - The word text
+     */
+    text: string;
+};
+export type MurekaLine = {
+    /**
+     * - Start time in milliseconds
+     */
+    start: number;
+    /**
+     * - End time in milliseconds
+     */
+    end: number;
+    /**
+     * - Full line text
+     */
+    text: string;
+    /**
+     * - Word-level timing (optional)
+     */
+    words?: MurekaWord[] | undefined;
+};
+export type MurekaLyricsSection = {
+    /**
+     * - e.g. "intro", "verse", "chorus", "bridge"
+     */
+    section_type: string;
+    /**
+     * - Section start time (ms)
+     */
+    start?: number | undefined;
+    /**
+     * - Section end time (ms)
+     */
+    end?: number | undefined;
+    /**
+     * - Lines with timing
+     */
+    lines?: MurekaLine[] | undefined;
+};
+export type MurekaChoice = {
+    /**
+     * - Primary MP3 URL
+     */
+    url: string;
+    /**
+     * - FLAC version
+     */
+    flac_url?: string | undefined;
+    /**
+     * - WAV version
+     */
+    wav_url?: string | undefined;
+    /**
+     * - Duration in milliseconds
+     */
+    duration: number;
+    /**
+     * - Choice-specific ID
+     */
+    id?: string | undefined;
+    /**
+     * - Choice index (0-based)
+     */
+    index?: number | undefined;
+    /**
+     * - Detailed timed lyrics
+     */
+    lyrics_sections?: MurekaLyricsSection[] | undefined;
+    /**
+     * - Locally saved MP3 path (added by wrapper)
+     */
+    local_path?: string | undefined;
+    /**
+     * - Locally saved FLAC path (added by wrapper)
+     */
+    local_flac_path?: string | undefined;
+    /**
+     * - Locally saved WAV path (added by wrapper)
+     */
+    local_wav_path?: string | undefined;
+};
+export type MurekaGenerationResult = {
+    /**
+     * - Main task/result ID
+     */
+    id: string;
+    /**
+     * - Unix timestamp (seconds)
+     */
+    created_at: number;
+    /**
+     * - Unix timestamp when finished
+     */
+    finished_at?: number | undefined;
+    /**
+     * - Model used (e.g. "mureka-9")
+     */
+    model?: string | undefined;
+    /**
+     * - "succeeded", "processing", "failed", etc.
+     */
+    status: string;
+    /**
+     * - Array of generated audio variants (ALL auto-saved)
+     */
+    choices?: MurekaChoice[] | undefined;
+    /**
+     * - Request trace ID for debugging
+     */
+    trace_id?: string | undefined;
+    /**
+     * - Legacy top-level MP3 (for backward compatibility)
+     */
+    mp3_url?: string | undefined;
+    /**
+     * - Legacy top-level audio URL
+     */
+    audio_url?: string | undefined;
+    /**
+     * - Array of all locally saved MP3 paths (added by wrapper)
+     */
+    local_paths?: string[] | undefined;
+    /**
+     * - Original raw API response
+     */
+    raw?: Object | undefined;
+};
+/**
+ * Returns authentication headers for Mureka API requests.
+ * @returns {{'Authorization': string}}
+ * @throws {Error} If MUREKA_API_KEY is not set.
+ * @see https://platform.mureka.ai/docs/
+ */
+export function getHeaders(): {
+    "Authorization": string;
+};
+/**
+ * Saves audio data (URL or base64) to a local file.
+ * @param {string|Buffer} audioData
+ * @param {string} [filenamePrefix='mureka']
+ * @returns {Promise<string>} Local file path
+ */
+/**
+ * Saves audio data (URL or base64) to a local file in the .cache/mureka directory.
+ * @param {string|Buffer} audioData - URL, base64 string, or Buffer of the audio.
+ * @param {string} [filenamePrefix="mureka"] - Prefix for the saved filename.
+ * @returns {Promise<string>} The local file path of the saved audio.
+ */
+export function saveAudioToLocal(audioData: string | Buffer, filenamePrefix?: string): Promise<string>;
+/**
+ * Poll until task completes.
+ * @param {string} taskId
+ * @param {string} [type='song']
+ * @returns {Promise<MurekaGenerationResult>}
+ */
+/**
+ * Polls a task until it completes or fails.
+ * @param {string} taskId - The task ID to poll.
+ * @param {string} [type="song"] - Task type (song, instrumental, tts, etc.).
+ * @returns {Promise<MurekaGenerationResult>} The completed result.
+ */
+export function pollUntilDone(taskId: string, type?: string): Promise<MurekaGenerationResult>;
+/**
+ * Generate a complete song with both lyrics and vocals (text-to-song).
+ * Supports reference_id, vocal_id, motif_id, etc.
+ * Automatically polls until completion and saves audio locally.
+ *
+ * @param {Object} [params={}]
+ * @param {string} params.prompt - Style/mood/genre description (required).
+ * @param {string} [params.lyrics] - Structured lyrics with [Verse], [Chorus], etc.
+ * @param {string} [params.model="auto"] - Model to use.
+ * @param {string} [params.reference_id] - Reference audio file_id (purpose=reference).
+ * @param {string} [params.vocal_id] - Cloned voice ID.
+ * @param {string} [params.motif_id] - Melody motif file_id.
+ * @returns {Promise<MurekaGenerationResult>} Generation result with choices and local paths.
+ */
+export function generateSong(params?: {
+    prompt: string;
+    lyrics?: string | undefined;
+    model?: string | undefined;
+    reference_id?: string | undefined;
+    vocal_id?: string | undefined;
+    motif_id?: string | undefined;
+}): Promise<MurekaGenerationResult>;
+/**
+ * Generate pure instrumental music (no vocals).
+ *
+ * @param {Object} [params={}]
+ * @param {string} params.prompt - Instrumental style/mood description (required).
+ * @param {string} [params.model="auto"]
+ * @param {string} [params.reference_id] - Reference audio (purpose=reference or instrumental).
+ * @returns {Promise<MurekaGenerationResult>}
+ */
+export function generateInstrumental(params?: {
+    prompt: string;
+    model?: string | undefined;
+    reference_id?: string | undefined;
+}): Promise<MurekaGenerationResult>;
+/**
+ * Generate a musical soundtrack matching an image or video.
+ *
+ * @param {Object} [params={}]
+ * @param {string} [params.image] - Image URL or file_id.
+ * @param {string} [params.video] - Video URL or file_id.
+ * @param {string} [params.prompt] - Optional style guidance.
+ * @returns {Promise<MurekaGenerationResult>}
+ */
+export function generateSoundtrack(params?: {
+    image?: string | undefined;
+    video?: string | undefined;
+    prompt?: string | undefined;
+}): Promise<MurekaGenerationResult>;
+/**
+ * Analyze an existing audio file and return structured description (genre, mood, structure, etc.).
+ *
+ * @param {Object} [params={}]
+ * @param {string} params.url - Audio URL or base64 (required).
+ * @returns {Promise<Object>} Description result.
+ */
+export function describeSong(params?: {
+    url: string;
+}): Promise<Object>;
+/**
+ * Extend an existing song by adding more sections.
+ *
+ * @param {Object} [params={}]
+ * @param {string} params.song_id - ID from previous generation (required).
+ * @param {string} [params.lyrics] - Additional lyrics.
+ * @returns {Promise<MurekaGenerationResult>}
+ */
+export function extendSong(params?: {
+    song_id: string;
+    lyrics?: string | undefined;
+}): Promise<MurekaGenerationResult>;
+/**
+ * Regenerate a song (or specific parts).
+ *
+ * @param {Object} [params={}]
+ * @returns {Promise<MurekaGenerationResult>}
+ */
+export function regenerateSong(params?: Object): Promise<MurekaGenerationResult>;
+/**
+ * Separate a song into stems (vocals, drums, bass, etc.).
+ *
+ * @param {Object} [params={}]
+ * @param {string} params.url - Audio URL or base64 (required).
+ * @param {string} [params.model] - Separation model.
+ * @returns {Promise<MurekaGenerationResult>}
+ */
+export function stemSong(params?: {
+    url: string;
+    model?: string | undefined;
+}): Promise<MurekaGenerationResult>;
+/**
+ * Recognize/identify a song from audio.
+ *
+ * @param {Object} [params={}]
+ * @param {string} params.url - Audio URL or base64 (required).
+ * @returns {Promise<Object>}
+ */
+export function recognizeSong(params?: {
+    url: string;
+}): Promise<Object>;
+/**
+ * Edit a specific time region of a song (replace lyrics/melody in a section).
+ *
+ * @param {Object} [params={}]
+ * @param {string} params.song_id - Song ID (required).
+ * @param {number} params.start_milliseconds - Start time (ms).
+ * @param {number} params.end_milliseconds - End time (ms).
+ * @param {string} [params.lyrics] - New lyrics for the region.
+ * @returns {Promise<MurekaGenerationResult>}
+ */
+export function regionEditSong(params?: {
+    song_id: string;
+    start_milliseconds: number;
+    end_milliseconds: number;
+    lyrics?: string | undefined;
+}): Promise<MurekaGenerationResult>;
+/**
+ * Generate a lyrics video from lyrics and background image.
+ *
+ * @param {Object} [params={}]
+ * @returns {Promise<MurekaGenerationResult>}
+ */
+export function generateLyricsVideo(params?: Object): Promise<MurekaGenerationResult>;
+/**
+ * Generate a specific track type (Vocals, Instrumental, Drums, etc.) from a song or uploaded audio.
+ *
+ * @param {Object} [params={}]
+ * @param {string} [params.song_id] - Song ID (mutually exclusive with upload_audio_id).
+ * @param {string} [params.upload_audio_id] - Upload ID from purpose="audio".
+ * @param {string} params.type - Track type (Vocals, Instrumental, Drums, Bass, Guitar, Keyboard, Percussion, Strings, Synth, FX, Brass, Woodwinds).
+ * @param {string} [params.generate_type] - Legacy alias for type.
+ * @param {string} params.prompt - Control prompt (required).
+ * @param {number} [params.generate_start] - Start time (ms).
+ * @param {number} [params.generate_end] - End time (ms).
+ * @param {string} [params.lyrics] - Lyrics (for Vocals).
+ * @param {string} [params.vocal_gender] - "male" or "female".
+ * @returns {Promise<MurekaGenerationResult>}
+ */
+export function generateTrack(params?: {
+    song_id?: string | undefined;
+    upload_audio_id?: string | undefined;
+    type: string;
+    generate_type?: string | undefined;
+    prompt: string;
+    generate_start?: number | undefined;
+    generate_end?: number | undefined;
+    lyrics?: string | undefined;
+    vocal_gender?: string | undefined;
+}): Promise<MurekaGenerationResult>;
+/**
+ * Create a remix of an existing song.
+ *
+ * @param {Object} [params={}]
+ * @param {string} [params.song_id] - Song ID.
+ * @param {string} [params.upload_audio_id] - Upload ID from purpose="remix".
+ * @param {string} params.prompt - Remix style prompt (required).
+ * @param {string} params.lyrics - Full lyrics of the target song (required).
+ * @param {number} [params.n=2] - Number of variants.
+ * @param {string} [params.model="auto"]
+ * @returns {Promise<MurekaGenerationResult>}
+ */
+export function remixSong(params?: {
+    song_id?: string | undefined;
+    upload_audio_id?: string | undefined;
+    prompt: string;
+    lyrics: string;
+    n?: number | undefined;
+    model?: string | undefined;
+}): Promise<MurekaGenerationResult>;
+/**
+ * Generate brand new song lyrics from a theme or style prompt.
+ *
+ * @param {Object} [params={}]
+ * @param {string} params.prompt - Theme/style instructions (required).
+ * @returns {Promise<Object>} Generated lyrics.
+ */
+export function generateLyrics(params?: {
+    prompt: string;
+}): Promise<Object>;
+/**
+ * Extend or continue existing lyrics.
+ *
+ * @param {Object} [params={}]
+ * @param {string} params.lyrics - Existing lyrics (required).
+ * @param {string} params.prompt - Instructions for extension (required).
+ * @returns {Promise<Object>}
+ */
+export function extendLyrics(params?: {
+    lyrics: string;
+    prompt: string;
+}): Promise<Object>;
+/**
+ * Convert text to natural-sounding speech (single-speaker or multi-speaker).
+ *
+ * @param {Object} [params={}]
+ * @param {string} [params.text] - Text for single-speaker mode.
+ * @param {Array} [params.script] - Array of {speaker, text} for podcast mode.
+ * @param {string} [params.voice_id] - Voice ID for single-speaker.
+ * @param {Object} [params.voices] - Map of speaker -> voice_id for podcast.
+ * @param {number} [params.speed=1.0]
+ * @param {number} [params.pitch=0]
+ * @returns {Promise<MurekaGenerationResult>}
+ */
+export function generateTTS(params?: {
+    text?: string | undefined;
+    script?: any[] | undefined;
+    voice_id?: string | undefined;
+    voices?: Object | undefined;
+    speed?: number | undefined;
+    pitch?: number | undefined;
+}): Promise<MurekaGenerationResult>;
+/**
+ * Generate a multi-speaker podcast.
+ *
+ * @param {Object} [params={}]
+ * @returns {Promise<MurekaGenerationResult>}
+ */
+export function generatePodcast(params?: Object): Promise<MurekaGenerationResult>;
+/**
+ * Create a custom voice clone from a short vocal sample.
+ *
+ * @param {Object} [params={}]
+ * @param {string} params.file - URL or base64 of vocal sample (5-15s recommended).
+ * @param {string} [params.name] - Friendly name for the voice.
+ * @returns {Promise<Object>} Result containing voice_id.
+ */
+export function cloneVocal(params?: {
+    file: string;
+    name?: string | undefined;
+}): Promise<Object>;
+/**
+ * Upload a file for use as reference (audio, image, video, MIDI).
+ * Supports multiple purposes (reference, vocal, melody, audio, remix, soundtrack, lyrics-video, etc.).
+ *
+ * @param {Object} [params={}]
+ * @param {string} params.url - Public URL of the file (required).
+ * @param {string} params.purpose - Purpose of upload (required).
+ * @returns {Promise<Object>} Upload result with file_id.
+ */
+export function uploadFile(params?: {
+    url: string;
+    purpose: string;
+}): Promise<Object>;
+/**
+ * Create a new upload session.
+ *
+ * @param {Object} [params={}]
+ * @returns {Promise<Object>}
+ */
+export function uploadsCreate(params?: Object): Promise<Object>;
+/**
+ * Add data to an upload session.
+ *
+ * @param {Object} [params={}]
+ * @returns {Promise<Object>}
+ */
+export function uploadsAdd(params?: Object): Promise<Object>;
+/**
+ * Complete an upload session.
+ *
+ * @param {Object} [params={}]
+ * @returns {Promise<Object>}
+ */
+export function uploadsComplete(params?: Object): Promise<Object>;
+/**
+ * Manually query the status of a task.
+ *
+ * @param {string} taskId - Task ID.
+ * @param {string} [type="song"] - Task type.
+ * @returns {Promise<Object>} Task status.
+ */
+export function queryTask(taskId: string, type?: string): Promise<Object>;
+/**
+ * Retrieve current account billing information (balance, credits, usage).
+ *
+ * @returns {Promise<Object>}
+ */
+export function getBilling(): Promise<Object>;
+/**
+ * Retrieve account profile information.
+ *
+ * @returns {Promise<Object>}
+ */
+export function getProfile(): Promise<Object>;
+/**
+ * Create a fine-tuning task.
+ *
+ * @param {Object} [params={}]
+ * @returns {Promise<MurekaGenerationResult>}
+ */
+export function createFineTune(params?: Object): Promise<MurekaGenerationResult>;
+/**
+ * Query the status of a fine-tuning task.
+ *
+ * @param {string} taskId - Fine-tune task ID.
+ * @returns {Promise<Object>}
+ */
+export function queryFineTune(taskId: string): Promise<Object>;

package/types/API/openai.com/index.d.ts

@@ -0,0 +1,7 @@
+declare namespace _default {
+    export { video };
+    export { videoToolset };
+}
+export default _default;
+import * as video from './video.js';
+import videoToolset from './videoToolset.js';

package/types/API/openai.com/{reponses/text.d.ts → responses.d.ts}

@@ -1,5 +1,5 @@
-export type Prompt = import("../../../Prompt.js").default;
-export type ToolSet = import("../../../ToolSet.js").default;
+export type Prompt = any;
+export type ToolSet = any;
 export type Includes = "code_interpreter_call.outputs" | "computer_call_output.output.image_url" | "file_search_call.results" | "message.input_image.image_url" | "message.output_text.logprobs" | "reasoning.encrypted_conten";
 export type OAOptions = {
     /**
@@ -33,7 +33,7 @@ export type OAOptions = {
     /**
      * - Model version to use.
      */
-    model?: "gpt-5.4" | "gpt-5-mini" | "gpt-5-nano" | "gpt-5-pro" | undefined;
+    model?: "gpt-5.5" | "gpt-5.4" | "gpt-5.4-mini" | undefined;
     /**
      * - Reusable prompt string.
      */
@@ -54,7 +54,7 @@ export type OAOptions = {
     /**
      * - Convenience: Adds `{type: "web_search_preview", search_context_size: search}` tool.
      */
-    search?: "low" | "high" | "medium" | undefined;
+    search?: "low" | "medium" | "high" | undefined;
     /**
      * - Service tier option, default is auto-selected.
      */
@@ -93,13 +93,13 @@ export type OAOptions = {
      */
     tools?: OpenAITool[] | undefined;
     /**
-     * =null An integer between 0 and 20 specifying the number of most likely tokens to return at each token position, each with an associated log probability.
+     * An integer between 0 and 20 specifying the number of most likely tokens to return at each token position, each with an associated log probability.
      */
-    top_logprobs: number | null;
+    top_logprobs?: number | null | undefined;
     /**
-     * =1 Top-p sampling value between 0 and 1.
+     * Top-p sampling value between 0 and 1.
      */
-    top_p: number | null;
+    top_p?: number | null | undefined;
     /**
      * - Needed reponse_id to validate tool calls on the next request
      */
@@ -137,7 +137,7 @@ export type OABuiltinTool = {
     /**
      * - Context size for `web_search_preview` only.
      */
-    search_context_size?: "low" | "high" | "medium" | undefined;
+    search_context_size?: "low" | "medium" | "high" | undefined;
 };
 export type OpenAITool = OAToolCall | OABuiltinTool;
 export type OAParameterProperty = {
@@ -227,7 +227,7 @@ export function generateRequest(prompt: Prompt, toolset?: ToolSet, options?: OAO
 * @param {import('../../../request.js').FetchResponse} res
 * @param {import('../../../ToolSet.js').default} [toolset]
 */
-export function parseResponse(duration: number, prompt: Prompt, res: any, toolset?: import("../../../ToolSet.js").default): Promise<void>;
+export function parseResponse(duration: number, prompt: Prompt, res: any, toolset?: any): Promise<void>;
 /**
 * Do a request
 * @param {Prompt} prompt
@@ -236,4 +236,4 @@ export function parseResponse(duration: number, prompt: Prompt, res: any, toolse
 * @param {number} [counter] - leave empty this counts the number of requests when doing recursive request calls
 * @return {Promise<import('../../../Session.js').Message>}
 */
-export function request(prompt: Prompt, toolset?: ToolSet | null, options?: OAOptions, counter?: number): Promise<import("../../../Session.js").Message>;
+export function request(prompt: Prompt, toolset?: ToolSet | null, options?: OAOptions, counter?: number): Promise<any>;