flow-frame-core 0.1.0

package/dist/constants.d.ts

@@ -0,0 +1,109 @@
+export declare const SUNO_SELECTORS: {
+    title: string;
+    lyrics: string;
+    styles: string;
+    styles_tags: string;
+    createbtn: string;
+};
+export declare const YOUTUBE_SELECTORS: {
+    createtn: string;
+    uploadVideo: string;
+    uploadVideoPopup: string;
+    selectFilesButton: string;
+    titleInput: string;
+    descriptionInput: string;
+    notKidsRadioButton: string;
+    yesKidsRadioButton: string;
+    nextButton: string;
+    scheduleButton: string;
+    dateField: string;
+    scheduleNavButton: string;
+    closeButton: string;
+};
+export declare const MODES: {
+    MIDJOURNEY: string;
+    MIDJOURNEY_IMAGES_TO_VIDEO: string;
+    MIDJOURNEY_DOWNLOAD_MEDIA: string;
+    MIDJOURNEY_DOWNLOAD_PUBLIC_MEDIA: string;
+    CLEAR_MIDJOURNEY_IMAGES: string;
+    SUNO: string;
+    SUNO_FILM: string;
+    YOUTUBE: string;
+    FLOW_FRAME: string;
+};
+export declare const KEYS: {
+    VARIABLE_POOL_PATH: string;
+    is_in_house: string;
+    run_flow_folder: string;
+    LastMidjourneyToImages: string;
+    speed: string;
+    workflow_folder: string;
+    learning_dir: string;
+    extension_folders: string;
+    learning_context: string;
+    SETTINGS_FILE: string;
+    workflow_model_folder: string;
+    flow_frame_text_positions: string;
+    workflow_trained_model_folder: string;
+    media_folder: string;
+    boxes: string;
+    element_selectors: string;
+    pdf_folder_path: string;
+    sourceFile: string;
+    mode: string;
+    ui_map_folder: string;
+    prompt_lib_folder: string;
+    useratio: string;
+    procedure: string;
+    processing_types: string;
+    elements: string;
+    current_folder: string;
+    suno_film_audio_tracks_per: string;
+    jobs_folder: string;
+    renders_folder: string;
+    images_folder: string;
+    text_images_folder: string;
+    animation_folder: string;
+    screen_shot_folder: string;
+    annotations_folder: string;
+    yolo_training_data: string;
+    yolo_capture_data: string;
+    days_offset: string;
+    audio_folder: string;
+    video_folder: string;
+    suno_current_name: string;
+    sunoDescription: string;
+    sunoTitle: string;
+    publishPerDay: string;
+    sunofileName: string;
+    firstVideoForUpload: string;
+    sunoDownloadFolder: string;
+    music_folder: string;
+    current_song_name: string;
+    training_jobs_folder: string;
+    training_progress_folder: string;
+    training_results_folder: string;
+    song_list: string;
+    song_lyrics: string;
+    suno_state: string;
+    song_incoming: string;
+    midjourney_style: string;
+    idea_template: string;
+    ideas: string;
+    sunoPrompt: string;
+    project_names: string;
+    config_folder: string;
+    project_characters: string;
+    project_character: string;
+    ignoreCharacters: string;
+    ratio: string;
+    ignoreStyle: string;
+    videoResourceFolder: string;
+    topTenVideoHorizontal: string;
+    topTenVideoVertical: string;
+    topTenAnimationDescription: string;
+    "chrome-requests": string;
+    default_llm_model: string;
+    default_llm_multi_modal_model: string;
+};
+//# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,cAAc;;;;;;CAM1B,CAAC;AAEF,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;CAc7B,CAAC;AACF,eAAO,MAAM,KAAK;;;;;;;;;;CAUjB,CAAC;AACF,eAAO,MAAM,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA0EhB,CAAC"}

package/dist/constants.js

@@ -0,0 +1,110 @@
+// const input_bar = '[id="desktop_input_bar"]';
+export const SUNO_SELECTORS = {
+    title: 'input[placeholder="Enter song title"]',
+    lyrics: 'textarea[placeholder="Add your own lyrics here"]',
+    styles: 'textarea[placeholder="Enter style description"]',
+    styles_tags: 'textarea[placeholder="Enter style tags"]',
+    createbtn: 'button||Create'
+};
+export const YOUTUBE_SELECTORS = {
+    createtn: "button||Create",
+    uploadVideo: '.right-container yt-formatted-string||Upload videos',
+    uploadVideoPopup: 'p||Drag and drop video files to upload',
+    selectFilesButton: 'button||Select files',
+    titleInput: '[id="input"]',
+    descriptionInput: '[id="description-textarea"]',
+    notKidsRadioButton: `[id="radioLabel"]||No, it's not made for kids`,
+    yesKidsRadioButton: `[id="radioLabel"]||^Yes, it's made for kids`,
+    nextButton: `button||Next`,
+    scheduleButton: `[id="visibility-title"]||Schedule`,
+    dateField: `.date-timezone-container`,
+    scheduleNavButton: `button||Schedule`,
+    closeButton: `[id="close-button"] button||Close`
+};
+export const MODES = {
+    MIDJOURNEY: 'MIDJOURNEY',
+    MIDJOURNEY_IMAGES_TO_VIDEO: 'MIDJOURNEY_IMAGES_TO_VIDEO',
+    MIDJOURNEY_DOWNLOAD_MEDIA: 'MIDJOURNEY_DOWNLOAD_MEDIA',
+    MIDJOURNEY_DOWNLOAD_PUBLIC_MEDIA: 'MIDJOURNEY_DOWNLOAD_PUBLIC_MEDIA',
+    CLEAR_MIDJOURNEY_IMAGES: 'CLEAR_MIDJOURNEY_IMAGES',
+    SUNO: 'SUNO',
+    SUNO_FILM: 'SUNO_FILM',
+    YOUTUBE: 'YOUTUBE',
+    FLOW_FRAME: 'FLOW_FRAME'
+};
+export const KEYS = {
+    VARIABLE_POOL_PATH: 'variable_pool_path',
+    is_in_house: 'is_in_house',
+    run_flow_folder: 'run_flow_folder',
+    LastMidjourneyToImages: 'LastMidjourneyToImages',
+    speed: 'speed',
+    workflow_folder: 'workflow_folder',
+    learning_dir: 'learning_dir',
+    extension_folders: 'extension_folders',
+    learning_context: 'learning_context',
+    SETTINGS_FILE: 'SETTINGS_FILE',
+    workflow_model_folder: 'workflow_model_folder',
+    flow_frame_text_positions: 'flow_frame_text_positions',
+    workflow_trained_model_folder: 'workflow_trained_model_folder',
+    media_folder: 'media_folder',
+    boxes: 'boxes',
+    element_selectors: 'element_selectors',
+    pdf_folder_path: 'pdf_folder_path',
+    sourceFile: 'sourceFile',
+    mode: 'mode',
+    ui_map_folder: 'ui_map_folder',
+    prompt_lib_folder: 'prompt_lib_folder',
+    useratio: 'useratio',
+    procedure: 'procedure',
+    processing_types: 'processing_types',
+    elements: 'elements',
+    current_folder: 'current_folder',
+    suno_film_audio_tracks_per: 'suno_film_audio_tracks_per',
+    jobs_folder: 'jobs_folder',
+    renders_folder: 'renders_folder',
+    images_folder: 'images_folder',
+    text_images_folder: 'text_images_folder',
+    animation_folder: 'animation_folder',
+    screen_shot_folder: 'screen_shot_folder',
+    annotations_folder: 'annotations_folder',
+    yolo_training_data: 'yolo_training_data',
+    yolo_capture_data: 'yolo_capture_data',
+    days_offset: 'days_offset',
+    audio_folder: 'audio_folder',
+    video_folder: 'video_folder',
+    suno_current_name: 'suno_current_name',
+    sunoDescription: 'sunoDescription',
+    sunoTitle: 'sunoTitle',
+    publishPerDay: 'publishPerDay',
+    sunofileName: 'sunofileName',
+    firstVideoForUpload: 'firstVideoForUpload',
+    sunoDownloadFolder: 'sunoDownloadFolder',
+    music_folder: 'music_folder',
+    current_song_name: 'current_song_name',
+    training_jobs_folder: 'training_jobs_folder',
+    training_progress_folder: 'training_progress_folder',
+    training_results_folder: 'training_results_folder',
+    song_list: 'song_list',
+    song_lyrics: 'song_lyrics',
+    suno_state: 'suno_state',
+    song_incoming: 'song_incoming',
+    midjourney_style: 'midjourney_style',
+    idea_template: 'idea_template',
+    ideas: 'ideas',
+    sunoPrompt: 'sunoPrompt',
+    project_names: 'project_names',
+    config_folder: 'config_folder',
+    project_characters: 'project_characters',
+    project_character: 'project_character',
+    ignoreCharacters: 'ignoreCharacters',
+    ratio: 'ratio',
+    ignoreStyle: 'ignoreStyle',
+    videoResourceFolder: 'videoResourceFolder',
+    topTenVideoHorizontal: 'topTenVideoHorizontal',
+    topTenVideoVertical: 'topTenVideoVertical',
+    topTenAnimationDescription: 'topten-animations-description',
+    ['chrome-requests']: 'chrome-requests',
+    default_llm_model: 'default_llm_model',
+    default_llm_multi_modal_model: 'default_llm_multi_modal_model'
+};
+//# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"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"}

package/dist/docs/workflow_nodes.md

@@ -0,0 +1,257 @@
+# Workflow Node Reference
+
+This document describes the available node types in the workflow executor and their functionality. These nodes are used to construct workflows and automations.
+
+## General Concepts
+
+### Execution Context
+- **Local Context (`ctx`)**: Data flows between nodes via a local context object. The output of a node is stored in `ctx[node.id]`. Downstream nodes access this data via connections (edges).
+- **Global Context**: A shared state accessible across the entire workflow execution, including inside loops and sub-workflows. Use `globalNode` to set and `globalGetNode` to retrieve values.
+- **Model Context**: System-level configuration and shared state, often used for server URLs or environment variables.
+
+### Input Resolution
+Most nodes follow a standard pattern for resolving inputs:
+1. **Edge Connection**: If a handle is connected, the value from the source node is used.
+2. **Configuration**: If no edge is connected, the static value configured in the node's data is used.
+3. **Default**: If neither is present, a default value (or `undefined`) is used.
+
+## Core Logic Nodes
+
+### `setNode`
+Sets a value in the shared `modelContext` and the local execution context.
+- **Inputs**:
+  - `in`: The value to set (optional, can be provided via node data).
+- **Configuration**:
+  - `key`: The key to set in the model context.
+  - `value`: Static value to set if no input is provided.
+- **Behavior**: Updates `modelContext[key]` with the provided value.
+
+### `getNode`
+Retrieves a value from the shared `modelContext`.
+- **Configuration**:
+  - `selectedKey`: The key to retrieve from the model context.
+- **Output**: The value associated with the key.
+
+### `switchNode`
+Routes logic based on an input value matching defined cases.
+- **Inputs**:
+  - `input`: The value to test.
+- **Configuration**:
+  - `cases`: Array of cases, each with a `matchText` and an `id`.
+- **Behavior**: Checks if `input` matches any case's `matchText`. If a match is found, it retrieves the value from the corresponding handle (`case-{id}`). If no match, it uses the `default` handle.
+
+### `ifNode`
+Executes one of two embedded sub-graphs based on a condition.
+- **Inputs**:
+  - `input`: Boolean condition.
+- **Configuration**:
+  - `trueGraph`: The graph configuration to execute if input is truthy.
+  - `falseGraph`: The graph configuration to execute if input is falsy.
+- **Behavior**: Iterates over the input (if array) or single item, executing the selected sub-graph.
+
+### `execJSNode`
+Executes custom JavaScript code.
+- **Inputs**:
+  - Dynamic inputs (e.g., `a`, `b`, `c`...) mapped to variables in the script.
+- **Configuration**:
+  - `code`: The JavaScript code to execute.
+- **Context**: Has access to a `utils` library (lodash functions, formatting, etc.) and `global` context.
+- **Output**: The return value of the script.
+
+## Data Manipulation
+
+### `propertyNode`
+Extracts a nested property from an object.
+- **Inputs**:
+  - `input`: The source object.
+- **Configuration**:
+  - `property`: Dot-notation path (e.g., `user.address.city`).
+- **Output**: The value at the specified path.
+
+### `arrayItemNode`
+Retrieves an item from an array at a specific index.
+- **Inputs**:
+  - `input`: The array.
+- **Configuration**:
+  - `index`: The numeric index to access.
+- **Output**: The element at the index.
+
+### `inputArrayNode`
+Parses or provides an array.
+- **Configuration**:
+  - `parsed`: The array data.
+  - `raw`: JSON string representation (fallback).
+- **Output**: The array.
+
+## AI & Prompts
+
+### `promptNode`
+Executes an LLM prompt.
+- **Inputs**:
+  - `system`: System prompt (optional override).
+  - `user`: User prompt (optional override).
+- **Configuration**:
+  - `systemPrompt`: Default system prompt.
+  - `userPrompt`: Default user prompt.
+  - `model`: The LLM model to use.
+- **Output**: The LLM response (attempts to parse as JSON, falls back to string).
+
+### `autoPromptOptimizerNode`
+Optimizes a prompt for a specific task using iterative testing.
+- **Inputs**:
+  - `name`, `taskDescription`, `dataset`, etc.
+- **Configuration**:
+  - `maxIterations`, `promptsPerRound`, `model`.
+- **Output**: Object containing `bestPrompt` and `allResults`.
+
+## Network & I/O
+
+### `fetchNode`
+Performs an HTTP request.
+- **Inputs**:
+  - `body`: Request body (optional).
+- **Configuration**:
+  - `url`: Target URL.
+  - `method`: HTTP method (GET, POST, etc.).
+  - `responseType`: 'json' or 'text'.
+  - `timeoutMinutes`: Request timeout (default 10).
+- **Output**: The response data.
+
+### `outputNode`
+Sends data to an external endpoint (webhook).
+- **Inputs**:
+  - `in`: The payload data.
+- **Configuration**:
+  - `url`: Destination URL.
+  - `method`: HTTP method (default POST).
+- **Behavior**: POSTs `{ ...nodeData, data: payload }` to the URL.
+
+### `gmailNode`
+Fetches emails manually (mostly for testing).
+- **Configuration**:
+  - `subjectPrefix`: Filter by subject.
+  - `labelNames`: Filter by labels.
+- **Output**: Array of email objects `{ id, body, subject }`.
+
+### `pollerNode`
+Advanced email processing node.
+- **Configuration**:
+  - `enableContinuous`: Whether to loop continuously.
+  - `subjectPrefix`, `labelNames`: Filters.
+  - `inputs`: Mappings of letters (A, B, C...) to task descriptions and sub-graphs.
+- **Behavior**:
+  1. Polls emails.
+  2. Uses LLM to match emails against task descriptions defined in `inputs`.
+  3. Validates matches.
+  4. Executes the specific sub-graph associated with the matched task.
+  5. Optionally moves/deletes processed emails.
+
+## Flow Control & Sub-Workflows
+
+### `workflowNode`
+Executes a separate, named workflow configuration.
+- **Inputs**:
+  - `a`, `b`, `c`: Inputs passed to the sub-workflow.
+- **Configuration**:
+  - `workflow` or `workflowName`: ID of the workflow to run.
+- **Output**: The result of the sub-workflow.
+
+### `graphNode`
+Loads and executes a dynamic graph configuration.
+- **Inputs**:
+  - `input`: Item to process.
+- **Configuration**:
+  - `graph`: Name of the configuration to load.
+- **Behavior**: Executes the loaded graph for the input item.
+
+### `ifWorkflowNode`
+Conditionally executes one of two named workflows.
+- **Inputs**:
+  - `condition`: Boolean value.
+  - `in`: Input data for the workflow.
+- **Configuration**:
+  - `trueWorkflow`: Workflow name if condition is true.
+  - `falseWorkflow`: Workflow name if condition is false.
+
+### `ifGraphNode`
+Conditionally executes one of two named automations (graphs).
+- **Inputs**:
+  - `condition`: Boolean value.
+  - `input`: Input data.
+- **Configuration**:
+  - `trueAutomation`: Automation ID if true.
+  - `falseAutomation`: Automation ID if false.
+
+### `forEachNode`
+Iterates over an array, executing a loaded graph for each item.
+- **Inputs**:
+  - `input`: Array of items.
+- **Configuration**:
+  - `graphNodeId`: Name of the graph configuration to load.
+  - `limitItems`, `limitCount`: Optional limits on iteration.
+- **Output**: Array of results.
+
+### `forLoopNode`
+Iterates over an array, executing an *embedded* sub-graph for each item.
+- **Inputs**:
+  - `input`: Array of items.
+- **Configuration**:
+  - `bodyGraph`: The embedded graph structure.
+- **Output**: Array of results.
+
+## Context & Globals
+
+### `globalNode`
+Updates the global execution context.
+- **Inputs**:
+  - Dynamic inputs mapped to keys.
+- **Configuration**:
+  - `pairs`: Array of `{ key, value, inputHandleId }`.
+- **Behavior**: Merges values into `globalContext`.
+
+### `globalGetNode`
+Retrieves a value from the global context.
+- **Inputs**:
+  - `in`: Key to retrieve (optional override).
+  - `value`: Default value (optional override).
+- **Configuration**:
+  - `key`: Dot-notation path to retrieve.
+  - `defaultValue`: Fallback value.
+- **Output**: The retrieved value.
+
+### `inputNode`
+Entry point for data within a sub-graph or loop.
+- **Configuration**:
+  - `name`: The context key to read (e.g., 'item', 'index', 'array').
+  - `value`: Default value.
+- **Output**: The value from context.
+
+### `resultNode`
+Defines the output of a sub-graph or workflow.
+- **Inputs**:
+  - `in`: The value to return.
+- **Behavior**: Sets the result for the parent node.
+
+## Extensions
+
+### `extensionNode`
+Executes an external extension capability.
+- **Inputs**:
+  - Dynamic inputs defined by the extension capability.
+- **Configuration**:
+  - `extensionPath`: Path to the extension.
+  - `capabilityId`: ID of the specific capability to execute.
+- **Behavior**:
+  1. Resolves extension path (checking `extension_folders`).
+  2. Installs dependencies via `/installDependencies`.
+  3. Executes the capability via `/runWorkflowCLI`.
+  4. Returns the CLI output.
+
+## Utilities
+
+### `pauseNode`
+Pauses execution.
+- **Inputs**:
+  - `seconds`: Duration (optional override).
+- **Configuration**:
+  - `seconds`: Duration in seconds.

package/dist/download.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Download a single file via the Python helper.
+ *
+ * @param {string} url          – remote file URL
+ * @param {string} targetDir    – local folder to save into
+ * @param {string} [prepend=""] – optional string to prepend to the filename
+ * @returns {Promise<void>}     – resolves if download succeeds
+ */
+declare function downloadWithPython(url: any, targetDir: any, prepend?: string): Promise<unknown>;
+export { downloadWithPython };
+//# sourceMappingURL=download.d.ts.map

package/dist/download.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"download.d.ts","sourceRoot":"","sources":["../src/download.ts"],"names":[],"mappings":"AAGA;;;;;;;GAOG;AACH,iBAAS,kBAAkB,CAAC,GAAG,KAAA,EAAE,SAAS,KAAA,EAAE,OAAO,SAAK,oBAkBvD;AAED,OAAO,EAAE,kBAAkB,EAAE,CAAC"}

package/dist/download.js

@@ -0,0 +1,31 @@
+import { spawn } from "child_process";
+import path from "path";
+/**
+ * Download a single file via the Python helper.
+ *
+ * @param {string} url          – remote file URL
+ * @param {string} targetDir    – local folder to save into
+ * @param {string} [prepend=""] – optional string to prepend to the filename
+ * @returns {Promise<void>}     – resolves if download succeeds
+ */
+function downloadWithPython(url, targetDir, prepend = "") {
+    return new Promise((resolve, reject) => {
+        const script = path.resolve(__dirname, "download.py");
+        const args = [
+            script,
+            "--url", url,
+            "--target-dir", targetDir,
+            "--prepend", prepend
+        ];
+        const py = spawn("python", args, { stdio: "inherit" });
+        py.on("error", err => reject(err));
+        py.on("close", code => {
+            if (code === 0)
+                resolve();
+            else
+                reject(new Error(`download.py exited with code ${code}`));
+        });
+    });
+}
+export { downloadWithPython };
+//# sourceMappingURL=download.js.map

package/dist/download.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"download.js","sourceRoot":"","sources":["../src/download.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AACtC,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB;;;;;;;GAOG;AACH,SAAS,kBAAkB,CAAC,GAAG,EAAE,SAAS,EAAE,OAAO,GAAG,EAAE;IACpD,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACnC,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;QACtD,MAAM,IAAI,GAAG;YACT,MAAM;YACN,OAAO,EAAE,GAAG;YACZ,cAAc,EAAE,SAAS;YACzB,WAAW,EAAE,OAAO;SACvB,CAAC;QAEF,MAAM,EAAE,GAAG,KAAK,CAAC,QAAQ,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;QAEvD,EAAE,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;QACnC,EAAE,CAAC,EAAE,CAAC,OAAO,EAAE,IAAI,CAAC,EAAE;YAClB,IAAI,IAAI,KAAK,CAAC;gBAAE,OAAO,EAAE,CAAC;;gBACrB,MAAM,CAAC,IAAI,KAAK,CAAC,gCAAgC,IAAI,EAAE,CAAC,CAAC,CAAC;QACnE,CAAC,CAAC,CAAC;IACP,CAAC,CAAC,CAAC;AACP,CAAC;AAED,OAAO,EAAE,kBAAkB,EAAE,CAAC"}

package/dist/download.py

@@ -0,0 +1,61 @@
+#!/usr/bin/env python3
+import argparse
+import os
+import requests
+from pathlib import Path
+from urllib.parse import urlparse
+
+def parse_args():
+    p = argparse.ArgumentParser(
+        description="Download a single file from a URL into a target folder with an optional prepend."
+    )
+    p.add_argument(
+        "--url", "-u",
+        required=True,
+        help="The URL of the file to download."
+    )
+    p.add_argument(
+        "--target-dir", "-t",
+        type=Path,
+        default=Path("."),
+        help="Directory where the file will be saved (will be created if needed)."
+    )
+    p.add_argument(
+        "--prepend", "-p",
+        default="",
+        help="String to prepend to the downloaded filename."
+    )
+    return p.parse_args()
+
+def main():
+    args = parse_args()
+    args.target_dir.mkdir(parents=True, exist_ok=True)
+
+    # Derive original filename
+    print(f"downloading: {args.url}")
+    parsed = urlparse(args.url)
+    orig = os.path.basename(parsed.path)
+    if not orig:
+        raise ValueError(f"Cannot determine filename from URL: {args.url}")
+
+    dest = os.path.join(args.target_dir, args.prepend, orig)
+
+    if os.path.exists(dest):
+        print(f"Skipping download, file already exists: {dest}")
+        return
+    
+    target_path = os.path.join(args.target_dir, args.prepend)
+    if not os.path.isdir(target_path):
+        os.mkdir(target_path)
+
+    resp = requests.get(args.url, stream=True)
+    resp.raise_for_status()
+    with open(dest, "wb") as f:
+        for chunk in resp.iter_content(chunk_size=8192):
+            if chunk:
+                f.write(chunk)
+
+    print(f"Downloaded → {dest}")
+
+if __name__ == "__main__":
+    main()

package/dist/ecosystem.config.json

@@ -0,0 +1,63 @@
+{
+  "apps": [
+    {
+      "name": "server",
+      "script": "server.js",
+      "args": "--port 8080 --docker true",
+      "env": {
+        "NODE_ENV": "production"
+      },
+      "instances": 1,
+      "autorestart": true,
+      "max_restarts": 10,
+      "min_uptime": "10s",
+      "max_memory_restart": "1G",
+      "restart_delay": 5000,
+      "error_log": "./logs/server-error.log",
+      "out_log": "./logs/server-out.log",
+      "log_log": "./logs/server-combined.log",
+      "merge_logs": true,
+      "time": true,
+      "env_production": {
+        "NODE_ENV": "production",
+        "PORT": 8080
+      },
+      "health_check": {
+        "enabled": true,
+        "url": "http://localhost:8080/health",
+        "interval": 30000,
+        "timeout": 5000,
+        "fails": 3
+      }
+    },
+    {
+      "name": "trainer",
+      "script": "trainer/yolo-job-processor.py",
+      "args": "--config_file=/app/storage.json",
+      "interpreter": "python",
+      "instances": 1,
+      "autorestart": true,
+      "max_restarts": 5,
+      "min_uptime": "30s",
+      "restart_delay": 10000,
+      "error_log": "./logs/trainer-error.log",
+      "out_log": "./logs/trainer-out.log",
+      "log_log": "./logs/trainer-combined.log",
+      "merge_logs": true,
+      "time": true,
+      "env": {
+        "PYTHONUNBUFFERED": "1"
+      }
+    }
+  ],
+  "deploy": {
+    "production": {
+      "user": "node",
+      "host": ["your-server.com"],
+      "ref": "origin/main",
+      "repo": "git@github.com:your-username/your-repo.git",
+      "path": "/var/www/production",
+      "post-deploy": "npm install && pm2 reload ecosystem.config.json --env production"
+    }
+  }
+}

package/dist/email-body-extractor.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Extracts readable text from email body parts
+ * @param {Array} parts - Array of email MIME parts
+ * @returns {string} - Readable text content
+ */
+declare function extractEmailBodyText(parts: any): string;
+/**
+ * Alternative function for Gmail API response format
+ * @param {Object} message - Gmail API message object
+ * @returns {string} - Readable text content
+ */
+declare function extractGmailBodyText(message: any): string;
+/**
+ * Function to decode base64url encoded strings (Gmail format)
+ * @param {string} base64url - Base64url encoded string
+ * @returns {string} - Decoded string
+ */
+declare function decodeBase64Url(base64url: any): string;
+export { extractEmailBodyText, extractGmailBodyText, decodeBase64Url };
+//# sourceMappingURL=email-body-extractor.d.ts.map

package/dist/email-body-extractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"email-body-extractor.d.ts","sourceRoot":"","sources":["../src/email-body-extractor.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,iBAAS,oBAAoB,CAAC,KAAK,KAAA,UA4DlC;AAED;;;;GAIG;AACH,iBAAS,oBAAoB,CAAC,OAAO,KAAA,UAMpC;AAED;;;;GAIG;AACH,iBAAS,eAAe,CAAC,SAAS,KAAA,UAWjC;AAaD,OAAO,EACH,oBAAoB,EACpB,oBAAoB,EACpB,eAAe,EAClB,CAAC"}