machineconfig 5.15__py3-none-any.whl → 7.98__py3-none-any.whl

machineconfig/scripts/python/helpers_agents/agentic_frameworks/fire_cursor_agents.py

@@ -0,0 +1,22 @@
+
+
+from pathlib import Path
+# import shlex
+from machineconfig.scripts.python.helpers_agents.fire_agents_helper_types import AI_SPEC
+
+def fire_cursor(ai_spec: AI_SPEC, prompt_path: Path) -> str:
+    match ai_spec["machine"]:
+        case "local":
+            # Export the environment variable so it's available to subshells
+            cmd = f"""
+
+cursor-agent --print --output-format text {prompt_path}
+
+"""
+        case "docker":
+            cmd = f"""
+
+cursor-agent --print --output-format text {prompt_path}
+
+"""
+    return cmd

machineconfig/scripts/python/helpers_agents/agentic_frameworks/fire_gemini.py

@@ -0,0 +1,55 @@
+
+from pathlib import Path
+import shlex
+from machineconfig.scripts.python.helpers_agents.fire_agents_helper_types import AI_SPEC
+
+
+def fire_gemini(ai_spec: AI_SPEC, prompt_path: Path, repo_root: Path) -> str:
+    _ = ai_spec["provider"]
+    # model = "gemini-2.5-flash-lite"
+    # model = None  # auto-select
+    # if model is None:
+    #     model_arg = ""
+    # else:
+    model_arg = f"--model {shlex.quote(ai_spec['model'])}"
+    # Need a real shell for the pipeline; otherwise '| gemini ...' is passed as args to 'cat'
+    safe_path = shlex.quote(str(prompt_path))
+    settings_dot_json = {
+   "security": {
+    "auth": {
+      "selectedType": "gemini-api-key"
+    }
+  }
+}
+    # settings_path = Path.home().joinpath(".gemini", "settings.json")
+    from machineconfig.utils.accessories import randstr
+    settings_tmp_path = Path.home().joinpath("tmp_results", "tmp_files", "agents", f"gemini_settings_{randstr()}.json")
+    settings_tmp_path.parent.mkdir(parents=True, exist_ok=True)
+    import json
+    settings_tmp_path.write_text(json.dumps(settings_dot_json, indent=2), encoding="utf-8")
+    match ai_spec["machine"]:
+        case "local":
+            # Export the environment variable so it's available to subshells
+            api_key = ai_spec["api_spec"]["api_key"]
+            if api_key is not None:
+                define_api_key = f"""export GEMINI_API_KEY="{shlex.quote(api_key)}" """
+            else:
+                define_api_key = "echo 'Warning: No GEMINI_API_KEY provided, hoping it is set in the environment.'"
+            cmd = f"""
+{define_api_key}
+echo "Using Gemini API key $GEMINI_API_KEY"
+gemini {model_arg} --yolo --prompt {safe_path}
+"""
+
+        case "docker":
+            api_key = ai_spec["api_spec"]["api_key"]
+            assert api_key is not None, "When using docker, api_key must be provided."
+            cmd = f"""
+docker run -it --rm \
+  -v {settings_tmp_path}:/root/.gemini/settings.json \
+  -v "{repo_root}:/workspace/{repo_root.name}" \
+  -w "/workspace/{repo_root.name}" \
+  statistician/machineconfig-ai:latest  \
+  bash -c '. ~/.bashrc; export GEMINI_API_KEY="{api_key}"; gemini --model {shlex.quote(ai_spec['model'])} --yolo {prompt_path.relative_to(repo_root)}'
+  """
+    return cmd

machineconfig/scripts/python/helpers_agents/agentic_frameworks/fire_qwen.py

@@ -0,0 +1,30 @@
+
+from pathlib import Path
+import shlex
+from machineconfig.scripts.python.helpers_agents.fire_agents_helper_types import AI_SPEC
+
+
+def fire_qwen(ai_spec: AI_SPEC, prompt_path: Path, repo_root: Path, config_dir: str | None) -> str:
+    _ = ai_spec["provider"]
+    safe_path = shlex.quote(str(prompt_path))
+    match ai_spec["machine"]:
+        case "local":
+            cmd = f"""
+qwen --yolo --prompt {safe_path}
+    """
+        case "docker":
+            assert config_dir is not None, "When using docker, config_dir must be provided."
+            assert Path(config_dir).exists(), f"Provided config_dir {config_dir} does not exist."
+            oauth_creds = Path(config_dir).joinpath("oauth_creds.json")
+            settings = Path(config_dir).joinpath("settings.json")
+
+            cmd = f"""
+docker run -it --rm \
+  -v "{repo_root}:/workspace/{repo_root.name}" \
+  -v {shlex.quote(str(oauth_creds))}:/root/.qwen/oauth_creds.json \
+  -v {shlex.quote(str(settings))}:/root/.qwen/settings.json \
+  -w "/workspace/{repo_root.name}" \
+  statistician/machineconfig-ai:latest \
+  qwen --prompt "$PATH_PROMPT"
+"""
+    return cmd

machineconfig/scripts/python/helpers_agents/fire_agents_help_launch.py

@@ -0,0 +1,126 @@
+
+import random
+import shlex
+from pathlib import Path
+from machineconfig.scripts.python.helpers_agents.fire_agents_helper_types import AGENTS, AGENT_NAME_FORMATTER, HOST, PROVIDER, AI_SPEC, API_SPEC
+
+
+def get_api_keys(provider: PROVIDER) -> list[API_SPEC]:
+    from machineconfig.utils.io import read_ini
+    config = read_ini(Path.home().joinpath(f"dotfiles/creds/llm/{provider}/api_keys.ini"))
+    res: list[API_SPEC] = []
+    for a_section_name in list(config.sections()):
+        a_section = config[a_section_name]
+        if "api_key" in a_section:
+            api_key = a_section["api_key"].strip()
+            if api_key:
+                res.append(API_SPEC(
+                    api_key=api_key,
+                    api_name=a_section.get("api_name", ""),
+                    api_label=a_section_name,
+                    api_account=a_section.get("email", "")
+                ))
+    print(f"Found {len(res)} {provider} API keys configured.")
+    return res
+
+
+def prep_agent_launch(repo_root: Path, agents_dir: Path, prompts_material: list[str], prompt_prefix: str, keep_material_in_separate_file: bool,
+                      machine: HOST, model: str, provider: PROVIDER, agent: AGENTS, *, job_name: str) -> None:
+    agents_dir.mkdir(parents=True, exist_ok=True)
+    prompt_folder = agents_dir / "prompts"
+    prompt_folder.mkdir(parents=True, exist_ok=True)
+
+    for idx, a_prompt_material in enumerate(prompts_material):
+        prompt_root = prompt_folder / f"agent_{idx}"
+        prompt_root.mkdir(parents=True, exist_ok=True)
+        prompt_path = prompt_root / f"agent_{idx}_prompt.txt"
+        if keep_material_in_separate_file:
+            prompt_material_path = prompt_root / f"agent_{idx}_material.txt"
+            prompt_material_path.write_text(a_prompt_material, encoding="utf-8")
+            prompt_path.write_text(prompt_prefix + f"""\nPlease only look @ {prompt_material_path.relative_to(repo_root)}. You don't need to do any other work beside the content of this material file.""", encoding="utf-8")
+        else:
+            prompt_material_path = prompt_path
+            prompt_path.write_text(prompt_prefix + """\nPlease only look @ the following:\n""" + a_prompt_material, encoding="utf-8")
+
+        agent_cmd_launch_path = prompt_root / AGENT_NAME_FORMATTER.format(idx=idx)  # e.g., agent_0_cmd.sh
+        random_sleep_time = random.uniform(0, 5)
+        cmd_prefix = f"""#!/usr/bin/env bash
+
+echo "Using machine: {machine}, model: {model}, provider: {provider}, and agent: {agent}"
+echo "{job_name}-{idx} CMD {agent_cmd_launch_path}"
+echo "{job_name}-{idx} PROMPT {prompt_path}"
+echo "{job_name}-{idx} CONTEXT {prompt_material_path}"
+echo "Starting agent {agent} in 5 seconds... Press Ctrl+C to cancel."
+# sleep 5
+# timeout 3 copilot --banner
+
+export FIRE_AGENTS_AGENT_NAME="{agent}"
+export FIRE_AGENTS_JOB_NAME="{job_name}"
+export FIRE_AGENTS_PROMPT_FILE="{prompt_path}"
+export FIRE_AGENTS_MATERIAL_FILE="{prompt_material_path}"
+export FIRE_AGENTS_AGENT_LAUNCHER="{agent_cmd_launch_path}"
+
+
+echo "Sleeping for {random_sleep_time:.2f} seconds to stagger agent startups..."
+sleep {random_sleep_time:.2f}
+echo "--------START OF AGENT OUTPUT--------"
+sleep 0.1
+
+"""
+        match agent:
+            case "gemini":
+                assert provider == "google", "Gemini agent only works with google provider."
+                api_keys = get_api_keys(provider="google")
+                api_spec = api_keys[idx % len(api_keys)] if len(api_keys) > 0 else None
+                if api_spec is None:
+                    raise ValueError("No API keys found for Google Gemini. Please configure them in dotfiles/creds/llm/google/api_keys.ini")
+                ai_spec: AI_SPEC = AI_SPEC(provider=provider, model="gemini-2.5-pro", agent=agent, machine=machine, api_spec=api_spec)
+                from machineconfig.scripts.python.helpers_agents.agentic_frameworks.fire_gemini import fire_gemini
+                cmd = fire_gemini(ai_spec=ai_spec, prompt_path=prompt_path, repo_root=repo_root)
+            case "cursor-agent":
+                api_spec = API_SPEC(api_key=None, api_name="", api_label="", api_account="")
+                ai_spec: AI_SPEC = AI_SPEC(provider=provider, model=model, agent=agent, machine=machine, api_spec=api_spec)
+                from machineconfig.scripts.python.helpers_agents.agentic_frameworks.fire_cursor_agents import fire_cursor
+                cmd = fire_cursor(ai_spec=ai_spec, prompt_path=prompt_path)
+                raise NotImplementedError("Cursor agent is not implemented yet, api key missing")
+            case "crush":
+                api_keys = get_api_keys(provider=provider)
+                api_spec = api_keys[idx % len(api_keys)] if len(api_keys) > 0 else None
+                if api_spec is None:
+                    raise ValueError("No API keys found for Crush. Please configure them in dotfiles/creds/llm/crush/api_keys.ini")
+                ai_spec: AI_SPEC = AI_SPEC(provider=provider, model=model, agent=agent, machine=machine, api_spec=api_spec)
+                from machineconfig.scripts.python.helpers_agents.agentic_frameworks.fire_crush import fire_crush
+                cmd = fire_crush(ai_spec=ai_spec, prompt_path=prompt_path, repo_root=repo_root)
+            # case "q":
+            #     from machineconfig.scripts.python.helpers_fire.fire_q import fire_q
+            #     cmd = fire_q(api_key="", prompt_path=prompt_path, machine=machine)
+            case _:
+                raise ValueError(f"Unsupported agent type: {agent}")
+        cmd_prefix += f"""
+echo "Running with api label:   {ai_spec['api_spec']['api_label']}"
+echo "Running with api acount:  {ai_spec['api_spec']['api_account']}"
+echo "Running with api name:    {ai_spec['api_spec']['api_name']}"
+
+"""
+        cmd_postfix = """
+sleep 0.1
+echo "---------END OF AGENT OUTPUT---------"
+"""
+        agent_cmd_launch_path.write_text(cmd_prefix + cmd + cmd_postfix, encoding="utf-8")
+    return None
+
+
+def get_agents_launch_layout(session_root: Path):
+    from machineconfig.utils.schemas.layouts.layout_types import TabConfig, LayoutConfig, LayoutsFile
+
+    tab_config: list[TabConfig] = []
+    prompt_root = session_root / "prompts"
+    all_dirs_under_prompts = [d for d in prompt_root.iterdir() if d.is_dir()]
+    for a_prompt_dir in all_dirs_under_prompts:
+        idx = a_prompt_dir.name.split("_")[-1]  # e.g., agent_0 -> 0
+        agent_cmd_path = a_prompt_dir / AGENT_NAME_FORMATTER.format(idx=idx)
+        fire_cmd = f"bash {shlex.quote(str(agent_cmd_path))}"
+        tab_config.append(TabConfig(tabName=f"Agent{idx}", startDir=str(session_root.parent.parent.parent), command=fire_cmd))
+    layout = LayoutConfig(layoutName="Agents", layoutTabs=tab_config)
+    layouts_file: LayoutsFile = LayoutsFile(version="1.0", layouts=[layout])
+    return layouts_file

machineconfig/scripts/python/helpers_agents/fire_agents_helper_types.py

@@ -0,0 +1,41 @@
+
+from typing import Literal, TypeAlias, TypedDict
+
+
+# Vscode extensions for AI-assisted coding.
+# Github copilot
+# Roo
+# Cline
+# Kilocode
+# Continue
+# CodeGPT
+# qodo (and cli)
+
+# Editors based on AI
+# Kiro
+# Cursor
+# Warp
+
+AGENTS: TypeAlias = Literal["cursor-agent", "gemini", "qwen-code", "copilot", "crush", "q", "opencode", "kilocode", "cline", "auggie", "warp", "droid"]
+HOST: TypeAlias = Literal["local", "docker"]
+PROVIDER: TypeAlias = Literal["azure", "google", "aws", "openai", "anthropic", "openrouter", "xai"]
+
+
+class API_SPEC(TypedDict):
+    api_key: str | None
+    api_name: str
+    api_label: str
+    api_account: str
+
+
+class AI_SPEC(TypedDict):
+    provider: PROVIDER
+    model: str
+    agent: AGENTS
+    machine: HOST
+    api_spec: API_SPEC
+
+
+AGENT_NAME_FORMATTER = "agent_{idx}_cmd.sh"  # e.g., agent_0_cmd.sh
+SEARCH_STRATEGIES: TypeAlias = Literal["file_path", "keyword_search", "filename_pattern"]
+

machineconfig/scripts/python/helpers_agents/templates/prompt.txt

@@ -0,0 +1,10 @@
+
+Please inspect the following python files, and document which methods of PathExtended class have been used (if the class is used at all)
+please create a file next to this file on same dir called result.md and put your results in it.
+Like this:
+* File_NAME
+    * method1
+    * method2
+
+* File_NAME
+    * method x

machineconfig/scripts/python/helpers_agents/templates/template.ps1

@@ -0,0 +1,14 @@
+# Set error action preference to stop on error, like set -e
+$ErrorActionPreference = "Stop"
+
+$JOB_NAME = "outpatient_mapping"
+$REPO_ROOT = "$HOME/code/work/winter_planning/"
+$CONTEXT_PATH = "$REPO_ROOT/data/outpatient_mapping/op_services.csv"
+$PROMPT_PATH = "$REPO_ROOT/data/outpatient_mapping/prompt"
+$AGENTS_DIR = "$REPO_ROOT/.ai/agents/$JOB_NAME"
+
+agents create --agents crush --host docker --model x-ai/grok-4-fast:free --provider openrouter --context-path $CONTEXT_PATH --prompt-path $PROMPT_PATH --job-name $JOB_NAME --agents-dir $AGENTS_DIR
+sessions balance-load "$AGENTS_DIR/layout.json" --max-thresh 6 --breaking-method moreLayouts --thresh-type number --output-path "$AGENTS_DIR/layout_balanced.json"
+sessions run "$AGENTS_DIR/layout_balanced.json" --kill-upon-completion
+
+# agents collect $AGENTS_DIR "$REPO_ROOT/.ai/agents/$JOB_NAME/collected.txt"

machineconfig/scripts/python/helpers_agents/templates/template.sh

@@ -0,0 +1,32 @@
+
+#!/bin/bash
+# set -e # Exit immediately if a command exits with a non-zero status.
+
+REPO_ROOT="$HOME/code/machineconfig"
+
+JOB_NAME="agentsTrial"
+CONTEXT_PATH="$REPO_ROOT/.ai/agents/files.md"
+PROMPT_PATH="$REPO_ROOT/.ai/agents/prompt.txt"
+AGENTS_DIR="$REPO_ROOT/.ai/agents/$JOB_NAME"
+
+agents create \
+    --agents crush \
+    --host docker \
+    --model gemini-2.5-pro \
+    --provider google \
+    --agent-load 5 \
+    --context-path $CONTEXT_PATH \
+    --prompt-path $PROMPT_PATH \
+    --job-name $JOB_NAME \
+    --agents-dir $AGENTS_DIR
+
+sessions balance-load "$AGENTS_DIR/layout.json" \
+    --max-threshold 4 \
+    --breaking-method moreLayouts \
+    --threshold-type number \
+    --output-path "$AGENTS_DIR/layout_balanced.json"
+
+sessions run "$AGENTS_DIR/layout_balanced.json" --kill-upon-completion
+
+
+# agents collect $AGENTS_DIR "$REPO_ROOT/.ai/agents/$JOB_NAME/collected.txt"

machineconfig/scripts/python/{cloud_copy.py → helpers_cloud/cloud_copy.py}

@@ -2,26 +2,24 @@
 CC
 """
 
-from machineconfig.utils.path_extended import PathExtended
-from tenacity import retry, stop_after_attempt, wait_chain, wait_fixed
-import getpass
-import os
 from typing import Optional, Annotated
-
 import typer
 
-from machineconfig.scripts.python.helpers.helpers2 import parse_cloud_source_target
-from machineconfig.scripts.python.helpers.cloud_helpers import ArgsDefaults, Args
-from rich.console import Console
-from rich.panel import Panel
-from rich.progress import Progress
-from machineconfig.utils.accessories import pprint
+from tenacity import retry, stop_after_attempt, wait_chain, wait_fixed
 
-console = Console()
 
 
 @retry(stop=stop_after_attempt(3), wait=wait_chain(wait_fixed(1), wait_fixed(4), wait_fixed(9)))
 def get_securely_shared_file(url: Optional[str] = None, folder: Optional[str] = None) -> None:
+    from rich.console import Console
+    from rich.panel import Panel
+    from rich.progress import Progress
+    import getpass
+    import os
+    from machineconfig.utils.path_extended import PathExtended
+
+    console = Console()
+
     console.print(Panel("🚀 Secure File Downloader", title="[bold blue]Downloader[/bold blue]", border_style="blue"))
 
     folder_obj = PathExtended.cwd() if folder is None else PathExtended(folder)
@@ -62,22 +60,31 @@ def get_securely_shared_file(url: Optional[str] = None, folder: Optional[str] =
                 tmp_folder.delete()
 
 
+
 def main(
     source: Annotated[str, typer.Argument(help="📂 file/folder path to be taken from here.")],
     target: Annotated[str, typer.Argument(help="🎯 file/folder path to be be sent to here.")],
-    overwrite: Annotated[bool, typer.Option(help="✍️ Overwrite existing file.")] = ArgsDefaults.overwrite,
-    share: Annotated[bool, typer.Option(help="🔗 Share file / directory")] = ArgsDefaults.share,
-    rel2home: Annotated[bool, typer.Option(help="🏠 Relative to `myhome` folder")] = ArgsDefaults.rel2home,
-    root: Annotated[Optional[str], typer.Option(help="🌳 Remote root. None is the default, unless rel2home is raied, making the default `myhome`.")] = ArgsDefaults.root,
-    key: Annotated[Optional[str], typer.Option(help="🔑 Key for encryption")] = ArgsDefaults.key,
-    pwd: Annotated[Optional[str], typer.Option(help="🔒 Password for encryption")] = ArgsDefaults.pwd,
-    encrypt: Annotated[bool, typer.Option(help="🔐 Encrypt before sending.")] = ArgsDefaults.encrypt,
-    zip_: Annotated[bool, typer.Option("--zip", "-z", help="📦 unzip after receiving.")] = ArgsDefaults.zip_,
-    os_specific: Annotated[bool, typer.Option(help="💻 choose path specific for this OS.")] = ArgsDefaults.os_specific,
-    config: Annotated[Optional[str], typer.Option(help="⚙️ path to cloud.json file.")] = None,
+    overwrite: Annotated[bool, typer.Option("--overwrite", "-o", help="✍️ Overwrite existing file.")] = False,
+    share: Annotated[bool, typer.Option("--share", "-s", help="🔗 Share file / directory")] = False,
+    rel2home: Annotated[bool, typer.Option("--relative2home", "-r", help="🏠 Relative to `myhome` folder")] = False,
+    root: Annotated[Optional[str], typer.Option("--root", "-R", help="🌳 Remote root. None is the default, unless rel2home is raied, making the default `myhome`.")] = None,
+    key: Annotated[Optional[str], typer.Option("--key", "-k", help="🔑 Key for encryption")] = None,
+    pwd: Annotated[Optional[str], typer.Option("--password", "-p", help="🔒 Password for encryption")] = None,
+    encrypt: Annotated[bool, typer.Option("--encrypt", "-e", help="🔐 Encrypt before sending.")] = False,
+    zip_: Annotated[bool, typer.Option("--zip", "-z", help="📦 unzip after receiving.")] = False,
+    os_specific: Annotated[bool, typer.Option("--os-specific", "-O", help="💻 choose path specific for this OS.")] = False,
+    config: Annotated[Optional[str], typer.Option("--config", "-c", help="⚙️ path to cloud.json file.")] = None,
 ) -> None:
+    """📤 Upload or 📥 Download files/folders to/from cloud storage services like Google Drive, Dropbox, OneDrive, etc."""
+    from rich.console import Console
+    from rich.panel import Panel
+    from machineconfig.utils.path_extended import PathExtended
+    from machineconfig.scripts.python.helpers_cloud.helpers2 import parse_cloud_source_target
+    from machineconfig.scripts.python.helpers_cloud.cloud_helpers import Args
+    from machineconfig.utils.accessories import pprint
+
+    console = Console()
     console.print(Panel("☁️  Cloud Copy Utility", title="[bold blue]Cloud Copy[/bold blue]", border_style="blue", width=152))
-
     args_obj = Args(
         overwrite=overwrite,
         share=share,

machineconfig/scripts/python/{cloud_mount.py → helpers_cloud/cloud_mount.py}

@@ -1,32 +1,27 @@
 """Cloud mount script"""
 
-from machineconfig.utils.options import choose_from_options
-from machineconfig.utils.io import read_ini
-from machineconfig.utils.path_extended import PathExtended
-
-import platform
-from typing import Optional, Annotated
 import typer
-from rich.console import Console
-from rich.panel import Panel
-
-console = Console()
-
-
-DEFAULT_MOUNT = "~/data/rclone"
+from typing import Optional, Annotated
 
 
 def get_rclone_config():
+    from machineconfig.utils.io import read_ini
+    from pathlib import Path
+    import platform
     if platform.system() == "Windows":
-        config = read_ini(PathExtended.home().joinpath("AppData/Roaming/rclone/rclone.conf"))
+        config = read_ini(Path.home().joinpath("AppData/Roaming/rclone/rclone.conf"))
     elif platform.system() in ["Linux", "Darwin"]:
-        config = read_ini(PathExtended.home().joinpath(".config/rclone/rclone.conf"))
+        config = read_ini(Path.home().joinpath(".config/rclone/rclone.conf"))
     else:
         raise ValueError("unsupported platform")
     return config
 
 
 def get_mprocs_mount_txt(cloud: str, rclone_cmd: str, cloud_brand: str):  # cloud_brand = config[cloud]["type"]
+    from machineconfig.utils.path_extended import PathExtended
+    import platform
+    DEFAULT_MOUNT = "~/data/rclone"
+
     header = f"{' ' + cloud + ' | ' + cloud_brand + ' '}".center(50, "=")
     if platform.system() == "Windows":
         sub_text_path = PathExtended.tmpfile(suffix=".ps1")
@@ -52,7 +47,19 @@ mprocs "echo 'see {DEFAULT_MOUNT}/{cloud} for the mounted cloud'; rclone about {
     return txt
 
 
-def mount(cloud: Optional[str], network: Optional[str], destination: Optional[str]) -> None:
+def mount(
+    cloud: Annotated[Optional[str], typer.Option(help="cloud to mount")] = None,
+    destination: Annotated[Optional[str], typer.Option(help="destination to mount")] = None,
+    network: Annotated[Optional[str], typer.Option(help="mount network drive")] = None,
+) -> None:
+    from machineconfig.utils.options import choose_from_options
+    from pathlib import Path
+    import platform
+    from rich.console import Console
+    from rich.panel import Panel
+    console = Console()
+    DEFAULT_MOUNT = "~/data/rclone"
+
     # draw header box dynamically
     title = "☁️  Cloud Mount Utility"
     console.print(Panel(title, title_align="left", border_style="blue"))
@@ -68,9 +75,9 @@ def mount(cloud: Optional[str], network: Optional[str], destination: Optional[st
 
     if network is None:
         if destination is None:
-            mount_loc = PathExtended(DEFAULT_MOUNT).expanduser().joinpath(cloud)
+            mount_loc = Path(DEFAULT_MOUNT).expanduser().joinpath(cloud)
         else:
-            mount_loc = PathExtended(destination)
+            mount_loc = Path(destination)
 
         mount_info = f"📂 Mount location: {mount_loc}"
         console.print(Panel(mount_info, border_style="blue"))
@@ -153,21 +160,8 @@ zellij action move-focus up
     console.print(Panel(f"{title1}\n{title2}", title="Success", border_style="green"))
 
 
-def main(
-    cloud: Annotated[Optional[str], typer.Option(help="cloud to mount")] = None,
-    destination: Annotated[Optional[str], typer.Option(help="destination to mount")] = None,
-    network: Annotated[Optional[str], typer.Option(help="mount network drive")] = None,
-) -> None:
-    # draw main title box dynamically
-    main_title = "☁️  RCLONE CLOUD MOUNT"
-    console.print(Panel(main_title, title_align="left", border_style="blue"))
-
-    mount(cloud=cloud, network=network, destination=destination)
-
-
-def arg_parser() -> None:
-    typer.run(main)
-
 
-if __name__ == "__main__":
-    arg_parser()
+def get_app():
+    app = typer.Typer(name="cloud-mount", help="Cloud mount utility")
+    app.command(name="mount", no_args_is_help=True)(mount)
+    return app

machineconfig/scripts/python/{cloud_sync.py → helpers_cloud/cloud_sync.py}

@@ -2,16 +2,9 @@
 TODO: use typer or typed-argument-parser to parse args
 """
 
-from machineconfig.scripts.python.helpers.helpers2 import parse_cloud_source_target
-from machineconfig.scripts.python.helpers.cloud_helpers import Args
-from machineconfig.scripts.python.cloud_mount import get_mprocs_mount_txt
 
 from typing import Annotated, Optional
 import typer
-from rich.console import Console
-from rich.panel import Panel
-
-console = Console()
 
 
 def main(
@@ -27,6 +20,14 @@ def main(
     delete: Annotated[bool, typer.Option("--delete", "-D", help="Delete files in remote that are not in local.")] = False,
     verbose: Annotated[bool, typer.Option("--verbose", "-v", help="Verbosity of mprocs to show details of syncing.")] = False,
 ) -> None:
+
+    from machineconfig.scripts.python.helpers_cloud.helpers2 import parse_cloud_source_target
+    from machineconfig.scripts.python.helpers_cloud.cloud_helpers import Args
+    from machineconfig.scripts.python.helpers_cloud.cloud_mount import get_mprocs_mount_txt
+    from rich.console import Console
+    from rich.panel import Panel
+    console = Console()
+
     title = "☁️  Cloud Sync Utility"
     console.print(Panel(title, title_align="left", border_style="blue"))
 
@@ -73,15 +74,8 @@ def main(
     cmd_line = f"{rclone_cmd[:65]}..."
     console.print(Panel(f"{title}\n{cmd_line}", title="[bold blue]Command[/bold blue]", expand=False))
 
-    # PROGRAM_PATH.write_text(txt, encoding="utf-8")
-    import subprocess
-
-    subprocess.run(txt, shell=True, check=True)
-
-
-def arg_parser() -> None:
-    typer.run(main)
-
+    # import subprocess
+    # subprocess.run(txt, shell=True, check=True)
+    from machineconfig.utils.code import run_shell_script
+    run_shell_script(txt)
 
-if __name__ == "__main__":
-    arg_parser()

machineconfig/scripts/python/{helpers → helpers_cloud}/helpers2.py

@@ -1,4 +1,4 @@
-from machineconfig.scripts.python.helpers.cloud_helpers import Args, ArgsDefaults, absolute, find_cloud_config, get_secure_share_cloud_config
+from machineconfig.scripts.python.helpers_cloud.cloud_helpers import Args, ArgsDefaults, absolute, find_cloud_config, get_secure_share_cloud_config
 from machineconfig.utils.io import read_ini
 from machineconfig.utils.source_of_truth import DEFAULTS_PATH
 from machineconfig.utils.accessories import pprint

machineconfig/scripts/python/helpers_croshell/crosh.py

@@ -0,0 +1,39 @@
+
+
+def get_read_python_file_pycode(path: str, title: str):
+    from pathlib import Path
+    print("Reading code from path:", path)
+    pycode = Path(path).read_text(encoding="utf-8")
+    pycode = pycode.split("except Exception: print(pycode)")[2]
+    try:
+        # from rich.text import Text
+        from rich.panel import Panel
+        from rich.console import Console
+        from rich.syntax import Syntax
+        console = Console()
+        if pycode.strip() != "":
+            console.print(Panel(Syntax(pycode, lexer="python"), title=title), style="bold red")
+    except Exception: print(pycode)
+
+
+def get_read_data_pycode(path: str):
+    from rich.panel import Panel
+    from rich.text import Text
+    from rich.console import Console
+    from pathlib import Path
+    console = Console()
+    p = Path(path).absolute()
+    try:
+        from machineconfig.utils.files.read import Read
+        from machineconfig.utils.accessories import pprint
+        dat = Read.read(p)
+        if isinstance(dat, dict):
+            panel_title = f"📄 File Data: {p.name}"
+            console.print(Panel(Text(str(dat), justify="left"), title=panel_title, expand=False))
+            pprint(dat, p.name)
+        else:
+            panel_title = f"📄 Successfully read the file: {p.name}"
+            console.print(Panel(Text(str(dat), justify="left"), title=panel_title, expand=False))
+    except Exception as e:
+        error_message = f'''❌ ERROR READING FILE\nFile: {p.name}\nError: {e}'''
+        console.print(Panel(Text(error_message, justify="left"), title="Error", expand=False, border_style="red"))

machineconfig/scripts/python/{start_slidev.py → helpers_croshell/start_slidev.py}

@@ -2,7 +2,7 @@
 slidev
 """
 
-from machineconfig.utils.source_of_truth import CONFIG_PATH
+from machineconfig.utils.source_of_truth import CONFIG_ROOT
 from machineconfig.utils.code import print_code
 from machineconfig.utils.path_extended import PathExtended
 from machineconfig.utils.terminal import Response
@@ -13,7 +13,7 @@ import platform
 
 PORT_DEFAULT = 3030
 
-SLIDEV_REPO = PathExtended(CONFIG_PATH).joinpath(".cache/slidev")
+SLIDEV_REPO = PathExtended(CONFIG_ROOT).joinpath(".cache/slidev")
 if not SLIDEV_REPO.joinpath("components").exists():
     print("📦 Initializing Slidev repository...")
     subprocess.run(f"cd {SLIDEV_REPO.parent};npm init slidev@latest", check=False, shell=True, text=True)
@@ -95,13 +95,12 @@ def main(
     if md_file.name != "slides.md":
         SLIDEV_REPO.joinpath(md_file.name).with_name(name="slides.md", inplace=True, overwrite=True)
 
-    import socket
-
-    try:
-        local_ip_v4 = socket.gethostbyname(socket.gethostname() + ".local")
-    except Exception:
-        print("⚠️ Warning: Could not get local_ip_v4. This might be due to running in a WSL instance.")
-        local_ip_v4 = socket.gethostbyname(socket.gethostname())
+    import machineconfig.scripts.python.helpers_network.address as helper
+    res = helper.select_lan_ipv4(prefer_vpn=False)
+    if res is None:
+        print("❌ Error: Could not determine local LAN IPv4 address for presentation.")
+        raise typer.Exit(code=1)
+    local_ip_v4 = res
 
     print("🌐 Presentation will be served at:")
     print(f"   - http://{platform.node()}:{port}")