PyPI - scitex - Versions diffs - 2.14.0__py3-none-any.whl → 2.15.3__py3-none-any.whl - Mend

scitex 2.14.0py3-none-any.whl → 2.15.3py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (264) hide show

scitex/__init__.py +71 -17
scitex/_env_loader.py +156 -0
scitex/_mcp_resources/__init__.py +37 -0
scitex/_mcp_resources/_cheatsheet.py +135 -0
scitex/_mcp_resources/_figrecipe.py +138 -0
scitex/_mcp_resources/_formats.py +102 -0
scitex/_mcp_resources/_modules.py +337 -0
scitex/_mcp_resources/_session.py +149 -0
scitex/_mcp_tools/__init__.py +4 -0
scitex/_mcp_tools/audio.py +66 -0
scitex/_mcp_tools/diagram.py +11 -95
scitex/_mcp_tools/introspect.py +210 -0
scitex/_mcp_tools/plt.py +260 -305
scitex/_mcp_tools/scholar.py +74 -0
scitex/_mcp_tools/social.py +27 -0
scitex/_mcp_tools/template.py +24 -0
scitex/_mcp_tools/writer.py +17 -210
scitex/ai/_gen_ai/_PARAMS.py +10 -7
scitex/ai/classification/reporters/_SingleClassificationReporter.py +45 -1603
scitex/ai/classification/reporters/_mixins/__init__.py +36 -0
scitex/ai/classification/reporters/_mixins/_constants.py +67 -0
scitex/ai/classification/reporters/_mixins/_cv_summary.py +387 -0
scitex/ai/classification/reporters/_mixins/_feature_importance.py +119 -0
scitex/ai/classification/reporters/_mixins/_metrics.py +275 -0
scitex/ai/classification/reporters/_mixins/_plotting.py +179 -0
scitex/ai/classification/reporters/_mixins/_reports.py +153 -0
scitex/ai/classification/reporters/_mixins/_storage.py +160 -0
scitex/ai/classification/timeseries/_TimeSeriesSlidingWindowSplit.py +30 -1550
scitex/ai/classification/timeseries/_sliding_window_core.py +467 -0
scitex/ai/classification/timeseries/_sliding_window_plotting.py +369 -0
scitex/audio/README.md +40 -36
scitex/audio/__init__.py +129 -61
scitex/audio/_branding.py +185 -0
scitex/audio/_mcp/__init__.py +32 -0
scitex/audio/_mcp/handlers.py +59 -6
scitex/audio/_mcp/speak_handlers.py +238 -0
scitex/audio/_relay.py +225 -0
scitex/audio/_tts.py +18 -10
scitex/audio/engines/base.py +17 -10
scitex/audio/engines/elevenlabs_engine.py +7 -2
scitex/audio/mcp_server.py +228 -75
scitex/canvas/README.md +1 -1
scitex/canvas/editor/_dearpygui/__init__.py +25 -0
scitex/canvas/editor/_dearpygui/_editor.py +147 -0
scitex/canvas/editor/_dearpygui/_handlers.py +476 -0
scitex/canvas/editor/_dearpygui/_panels/__init__.py +17 -0
scitex/canvas/editor/_dearpygui/_panels/_control.py +119 -0
scitex/canvas/editor/_dearpygui/_panels/_element_controls.py +190 -0
scitex/canvas/editor/_dearpygui/_panels/_preview.py +43 -0
scitex/canvas/editor/_dearpygui/_panels/_sections.py +390 -0
scitex/canvas/editor/_dearpygui/_plotting.py +187 -0
scitex/canvas/editor/_dearpygui/_rendering.py +504 -0
scitex/canvas/editor/_dearpygui/_selection.py +295 -0
scitex/canvas/editor/_dearpygui/_state.py +93 -0
scitex/canvas/editor/_dearpygui/_utils.py +61 -0
scitex/canvas/editor/flask_editor/_core/__init__.py +27 -0
scitex/canvas/editor/flask_editor/_core/_bbox_extraction.py +200 -0
scitex/canvas/editor/flask_editor/_core/_editor.py +173 -0
scitex/canvas/editor/flask_editor/_core/_export_helpers.py +353 -0
scitex/canvas/editor/flask_editor/_core/_routes_basic.py +190 -0
scitex/canvas/editor/flask_editor/_core/_routes_export.py +332 -0
scitex/canvas/editor/flask_editor/_core/_routes_panels.py +252 -0
scitex/canvas/editor/flask_editor/_core/_routes_save.py +218 -0
scitex/canvas/editor/flask_editor/_core.py +25 -1684
scitex/canvas/editor/flask_editor/templates/__init__.py +32 -70
scitex/cli/__init__.py +38 -43
scitex/cli/audio.py +160 -41
scitex/cli/capture.py +133 -20
scitex/cli/introspect.py +488 -0
scitex/cli/main.py +200 -109
scitex/cli/mcp.py +60 -34
scitex/cli/plt.py +414 -0
scitex/cli/repro.py +15 -8
scitex/cli/resource.py +15 -8
scitex/cli/scholar/__init__.py +154 -8
scitex/cli/scholar/_crossref_scitex.py +296 -0
scitex/cli/scholar/_fetch.py +25 -3
scitex/cli/social.py +355 -0
scitex/cli/stats.py +136 -11
scitex/cli/template.py +129 -12
scitex/cli/tex.py +15 -8
scitex/cli/writer.py +49 -299
scitex/cloud/__init__.py +41 -2
scitex/config/README.md +1 -1
scitex/config/__init__.py +16 -2
scitex/config/_env_registry.py +256 -0
scitex/context/__init__.py +22 -0
scitex/dev/__init__.py +20 -1
scitex/diagram/__init__.py +42 -19
scitex/diagram/mcp_server.py +13 -125
scitex/gen/__init__.py +50 -14
scitex/gen/_list_packages.py +4 -4
scitex/introspect/__init__.py +82 -0
scitex/introspect/_call_graph.py +303 -0
scitex/introspect/_class_hierarchy.py +163 -0
scitex/introspect/_core.py +41 -0
scitex/introspect/_docstring.py +131 -0
scitex/introspect/_examples.py +113 -0
scitex/introspect/_imports.py +271 -0
scitex/{gen/_inspect_module.py → introspect/_list_api.py} +48 -56
scitex/introspect/_mcp/__init__.py +41 -0
scitex/introspect/_mcp/handlers.py +233 -0
scitex/introspect/_members.py +155 -0
scitex/introspect/_resolve.py +89 -0
scitex/introspect/_signature.py +131 -0
scitex/introspect/_source.py +80 -0
scitex/introspect/_type_hints.py +172 -0
scitex/io/_save.py +1 -2
scitex/io/bundle/README.md +1 -1
scitex/logging/_formatters.py +19 -9
scitex/mcp_server.py +98 -5
scitex/os/__init__.py +4 -0
scitex/{gen → os}/_check_host.py +4 -5
scitex/plt/__init__.py +245 -550
scitex/plt/_subplots/_AxisWrapperMixins/_SeabornMixin/_wrappers.py +5 -10
scitex/plt/docs/EXTERNAL_PACKAGE_BRANDING.md +149 -0
scitex/plt/gallery/README.md +1 -1
scitex/plt/utils/_hitmap/__init__.py +82 -0
scitex/plt/utils/_hitmap/_artist_extraction.py +343 -0
scitex/plt/utils/_hitmap/_color_application.py +346 -0
scitex/plt/utils/_hitmap/_color_conversion.py +121 -0
scitex/plt/utils/_hitmap/_constants.py +40 -0
scitex/plt/utils/_hitmap/_hitmap_core.py +334 -0
scitex/plt/utils/_hitmap/_path_extraction.py +357 -0
scitex/plt/utils/_hitmap/_query.py +113 -0
scitex/plt/utils/_hitmap.py +46 -1616
scitex/plt/utils/_metadata/__init__.py +80 -0
scitex/plt/utils/_metadata/_artists/__init__.py +25 -0
scitex/plt/utils/_metadata/_artists/_base.py +195 -0
scitex/plt/utils/_metadata/_artists/_collections.py +356 -0
scitex/plt/utils/_metadata/_artists/_extract.py +57 -0
scitex/plt/utils/_metadata/_artists/_images.py +80 -0
scitex/plt/utils/_metadata/_artists/_lines.py +261 -0
scitex/plt/utils/_metadata/_artists/_patches.py +247 -0
scitex/plt/utils/_metadata/_artists/_text.py +106 -0
scitex/plt/utils/_metadata/_csv.py +416 -0
scitex/plt/utils/_metadata/_detect.py +225 -0
scitex/plt/utils/_metadata/_legend.py +127 -0
scitex/plt/utils/_metadata/_rounding.py +117 -0
scitex/plt/utils/_metadata/_verification.py +202 -0
scitex/schema/README.md +1 -1
scitex/scholar/__init__.py +8 -0
scitex/scholar/_mcp/crossref_handlers.py +265 -0
scitex/scholar/core/Scholar.py +63 -1700
scitex/scholar/core/_mixins/__init__.py +36 -0
scitex/scholar/core/_mixins/_enrichers.py +270 -0
scitex/scholar/core/_mixins/_library_handlers.py +100 -0
scitex/scholar/core/_mixins/_loaders.py +103 -0
scitex/scholar/core/_mixins/_pdf_download.py +375 -0
scitex/scholar/core/_mixins/_pipeline.py +312 -0
scitex/scholar/core/_mixins/_project_handlers.py +125 -0
scitex/scholar/core/_mixins/_savers.py +69 -0
scitex/scholar/core/_mixins/_search.py +103 -0
scitex/scholar/core/_mixins/_services.py +88 -0
scitex/scholar/core/_mixins/_url_finding.py +105 -0
scitex/scholar/crossref_scitex.py +367 -0
scitex/scholar/docs/EXTERNAL_PACKAGE_BRANDING.md +149 -0
scitex/scholar/examples/00_run_all.sh +120 -0
scitex/scholar/jobs/_executors.py +27 -3
scitex/scholar/pdf_download/ScholarPDFDownloader.py +38 -416
scitex/scholar/pdf_download/_cli.py +154 -0
scitex/scholar/pdf_download/strategies/__init__.py +11 -8
scitex/scholar/pdf_download/strategies/manual_download_fallback.py +80 -3
scitex/scholar/pipelines/ScholarPipelineBibTeX.py +73 -121
scitex/scholar/pipelines/ScholarPipelineParallel.py +80 -138
scitex/scholar/pipelines/ScholarPipelineSingle.py +43 -63
scitex/scholar/pipelines/_single_steps.py +71 -36
scitex/scholar/storage/_LibraryManager.py +97 -1695
scitex/scholar/storage/_mixins/__init__.py +30 -0
scitex/scholar/storage/_mixins/_bibtex_handlers.py +128 -0
scitex/scholar/storage/_mixins/_library_operations.py +218 -0
scitex/scholar/storage/_mixins/_metadata_conversion.py +226 -0
scitex/scholar/storage/_mixins/_paper_saving.py +456 -0
scitex/scholar/storage/_mixins/_resolution.py +376 -0
scitex/scholar/storage/_mixins/_storage_helpers.py +121 -0
scitex/scholar/storage/_mixins/_symlink_handlers.py +226 -0
scitex/security/README.md +3 -3
scitex/session/README.md +1 -1
scitex/session/__init__.py +26 -7
scitex/session/_decorator.py +1 -1
scitex/sh/README.md +1 -1
scitex/sh/__init__.py +7 -4
scitex/social/__init__.py +155 -0
scitex/social/docs/EXTERNAL_PACKAGE_BRANDING.md +149 -0
scitex/stats/_mcp/_handlers/__init__.py +31 -0
scitex/stats/_mcp/_handlers/_corrections.py +113 -0
scitex/stats/_mcp/_handlers/_descriptive.py +78 -0
scitex/stats/_mcp/_handlers/_effect_size.py +106 -0
scitex/stats/_mcp/_handlers/_format.py +94 -0
scitex/stats/_mcp/_handlers/_normality.py +110 -0
scitex/stats/_mcp/_handlers/_posthoc.py +224 -0
scitex/stats/_mcp/_handlers/_power.py +247 -0
scitex/stats/_mcp/_handlers/_recommend.py +102 -0
scitex/stats/_mcp/_handlers/_run_test.py +279 -0
scitex/stats/_mcp/_handlers/_stars.py +48 -0
scitex/stats/_mcp/handlers.py +19 -1171
scitex/stats/auto/_stat_style.py +175 -0
scitex/stats/auto/_style_definitions.py +411 -0
scitex/stats/auto/_styles.py +22 -620
scitex/stats/descriptive/__init__.py +11 -8
scitex/stats/descriptive/_ci.py +39 -0
scitex/stats/power/_power.py +15 -4
scitex/str/__init__.py +2 -1
scitex/str/_title_case.py +63 -0
scitex/template/README.md +1 -1
scitex/template/__init__.py +25 -10
scitex/template/_code_templates.py +147 -0
scitex/template/_mcp/handlers.py +81 -0
scitex/template/_mcp/tool_schemas.py +55 -0
scitex/template/_templates/__init__.py +51 -0
scitex/template/_templates/audio.py +233 -0
scitex/template/_templates/canvas.py +312 -0
scitex/template/_templates/capture.py +268 -0
scitex/template/_templates/config.py +43 -0
scitex/template/_templates/diagram.py +294 -0
scitex/template/_templates/io.py +107 -0
scitex/template/_templates/module.py +53 -0
scitex/template/_templates/plt.py +202 -0
scitex/template/_templates/scholar.py +267 -0
scitex/template/_templates/session.py +130 -0
scitex/template/_templates/session_minimal.py +43 -0
scitex/template/_templates/session_plot.py +67 -0
scitex/template/_templates/session_stats.py +77 -0
scitex/template/_templates/stats.py +323 -0
scitex/template/_templates/writer.py +296 -0
scitex/template/clone_writer_directory.py +5 -5
scitex/ui/_backends/_email.py +10 -2
scitex/ui/_backends/_webhook.py +5 -1
scitex/web/_search_pubmed.py +10 -6
scitex/writer/README.md +1 -1
scitex/writer/__init__.py +43 -34
scitex/writer/_mcp/handlers.py +11 -744
scitex/writer/_mcp/tool_schemas.py +5 -335
scitex-2.15.3.dist-info/METADATA +667 -0
{scitex-2.14.0.dist-info → scitex-2.15.3.dist-info}/RECORD +241 -120
scitex/canvas/editor/flask_editor/templates/_scripts.py +0 -4933
scitex/canvas/editor/flask_editor/templates/_styles.py +0 -1658
scitex/diagram/_compile.py +0 -312
scitex/diagram/_diagram.py +0 -355
scitex/diagram/_mcp/__init__.py +0 -4
scitex/diagram/_mcp/handlers.py +0 -400
scitex/diagram/_mcp/tool_schemas.py +0 -157
scitex/diagram/_presets.py +0 -173
scitex/diagram/_schema.py +0 -182
scitex/diagram/_split.py +0 -278
scitex/gen/_ci.py +0 -12
scitex/gen/_title_case.py +0 -89
scitex/plt/_mcp/__init__.py +0 -4
scitex/plt/_mcp/_handlers_annotation.py +0 -102
scitex/plt/_mcp/_handlers_figure.py +0 -195
scitex/plt/_mcp/_handlers_plot.py +0 -252
scitex/plt/_mcp/_handlers_style.py +0 -219
scitex/plt/_mcp/handlers.py +0 -74
scitex/plt/_mcp/tool_schemas.py +0 -497
scitex/plt/mcp_server.py +0 -231
scitex/scholar/examples/SUGGESTIONS.md +0 -865
scitex/scholar/examples/dev.py +0 -38
scitex-2.14.0.dist-info/METADATA +0 -1238
/scitex/{gen → context}/_detect_environment.py +0 -0
/scitex/{gen → context}/_get_notebook_path.py +0 -0
/scitex/{gen/_shell.py → sh/_shell_legacy.py} +0 -0
{scitex-2.14.0.dist-info → scitex-2.15.3.dist-info}/WHEEL +0 -0
{scitex-2.14.0.dist-info → scitex-2.15.3.dist-info}/entry_points.txt +0 -0
{scitex-2.14.0.dist-info → scitex-2.15.3.dist-info}/licenses/LICENSE +0 -0

scitex/canvas/editor/flask_editor/templates/__init__.py CHANGED Viewed

@@ -1,35 +1,20 @@
 #!/usr/bin/env python3
-# -*- coding: utf-8 -*-
 # File: ./src/scitex/vis/editor/flask_editor/templates/__init__.py
 """Template components for Flask editor.
-Supports two modes:
-- Static files mode (default): Uses external CSS/JS files from static/
-- Inline mode (fallback): Embeds CSS/JS directly in HTML
+Uses external CSS/JS files from static/ directory.
 """
 from ._html import HTML_BODY
-# Configuration flag - set to False to use inline mode for debugging
-USE_STATIC_FILES = True
-def build_html_template(use_static: bool = None) -> str:
-    """Build the complete HTML template from components.
-    Args:
-        use_static: Override static file usage. If None, uses USE_STATIC_FILES.
+def build_html_template() -> str:
+    """Build the complete HTML template.
     Returns:
         Complete HTML template string.
     """
-    if use_static is None:
-        use_static = USE_STATIC_FILES
-    if use_static:
-        return _build_static_template()
-    else:
-        return _build_inline_template()
+    return _build_static_template()
 def _build_static_template() -> str:
@@ -37,42 +22,44 @@ def _build_static_template() -> str:
     # Get list of JS files in correct load order
     js_files = [
         # Dev tools (load first to capture console logs)
-        'js/dev/element-inspector.js',
+        "js/dev/element-inspector.js",
         # Core modules first (dependencies)
-        'js/core/state.js',
-        'js/core/utils.js',
-        'js/core/api.js',
+        "js/core/state.js",
+        "js/core/utils.js",
+        "js/core/api.js",
         # Editor modules
-        'js/editor/bbox.js',
-        'js/editor/overlay.js',
-        'js/editor/preview.js',
-        'js/editor/element-drag.js',
+        "js/editor/bbox.js",
+        "js/editor/overlay.js",
+        "js/editor/preview.js",
+        "js/editor/element-drag.js",
         # Canvas modules
-        'js/canvas/selection.js',
-        'js/canvas/resize.js',
-        'js/canvas/dragging.js',
-        'js/canvas/canvas.js',
+        "js/canvas/selection.js",
+        "js/canvas/resize.js",
+        "js/canvas/dragging.js",
+        "js/canvas/canvas.js",
         # Alignment modules
-        'js/alignment/basic.js',
-        'js/alignment/axis.js',
-        'js/alignment/distribute.js',
+        "js/alignment/basic.js",
+        "js/alignment/axis.js",
+        "js/alignment/distribute.js",
         # UI modules
-        'js/ui/theme.js',
-        'js/ui/help.js',
-        'js/ui/download.js',
-        'js/ui/controls.js',
+        "js/ui/theme.js",
+        "js/ui/help.js",
+        "js/ui/download.js",
+        "js/ui/controls.js",
         # Shortcuts
-        'js/shortcuts/context-menu.js',
-        'js/shortcuts/keyboard.js',
+        "js/shortcuts/context-menu.js",
+        "js/shortcuts/keyboard.js",
         # Main entry (last)
-        'js/main.js',
+        "js/main.js",
     ]
     # Generate script tags
-    script_tags = '\n    '.join([
-        f'<script src="{{{{ url_for(\'static\', filename=\'{f}\') }}}}"></script>'
-        for f in js_files
-    ])
+    script_tags = "\n    ".join(
+        [
+            f"<script src=\"{{{{ url_for('static', filename='{f}') }}}}\"></script>"
+            for f in js_files
+        ]
+    )
     return f"""<!DOCTYPE html>
 <html lang="en" data-theme="dark">
@@ -95,29 +82,4 @@ def _build_static_template() -> str:
 """
-def _build_inline_template() -> str:
-    """Build template with inline CSS/JS (fallback mode)."""
-    from ._styles import CSS_STYLES
-    from ._scripts import JS_SCRIPTS
-    return f"""<!DOCTYPE html>
-<html lang="en" data-theme="dark">
-<head>
-    <meta charset="UTF-8">
-    <meta name="viewport" content="width=device-width, initial-scale=1.0">
-    <title>SciTeX Figure Editor - {{{{ filename }}}}</title>
-    <style>
-{CSS_STYLES}
-    </style>
-</head>
-<body>
-{HTML_BODY}
-    <script>
-{JS_SCRIPTS}
-    </script>
-</body>
-</html>
-"""
 # EOF

scitex/cli/__init__.py CHANGED Viewed

@@ -16,49 +16,44 @@ import click
 from .main import cli
-def add_help_recursive(group: click.Group, parent_name: str = "scitex") -> None:
-    """Add help-recursive command to a click group.
+def print_help_recursive(ctx, group: click.Group) -> None:
+    """Print help for a group and all its subcommands.
     Args:
-        group: The click group to add the command to
-        parent_name: The parent command name for display (e.g., "scitex writer")
+        ctx: The click context
+        group: The click group to print help for
     """
-    @group.command("help-recursive")
-    @click.pass_context
-    def help_recursive(ctx):
-        """Show help for all commands recursively."""
-        # Create a fake parent context to show correct command path in Usage
-        fake_parent = click.Context(click.Group(), info_name="scitex")
-        parent_ctx = click.Context(group, info_name=group.name, parent=fake_parent)
-        click.secho(f"━━━ scitex {group.name} ━━━", fg="cyan", bold=True)
-        click.echo(group.get_help(parent_ctx))
-        for name in sorted(group.list_commands(ctx) or []):
-            cmd = group.get_command(ctx, name)
-            if cmd is None or name == "help-recursive":
-                continue
-            click.echo()
-            click.secho(f"━━━ scitex {group.name} {name} ━━━", fg="cyan", bold=True)
-            with click.Context(cmd, info_name=name, parent=parent_ctx) as sub_ctx:
-                click.echo(cmd.get_help(sub_ctx))
-                # Handle nested subgroups
-                if isinstance(cmd, click.Group):
-                    for sub_name in sorted(cmd.list_commands(sub_ctx) or []):
-                        sub_cmd = cmd.get_command(sub_ctx, sub_name)
-                        if sub_cmd is None:
-                            continue
-                        click.echo()
-                        click.secho(
-                            f"━━━ scitex {group.name} {name} {sub_name} ━━━",
-                            fg="cyan",
-                            bold=True,
-                        )
-                        with click.Context(
-                            sub_cmd, info_name=sub_name, parent=sub_ctx
-                        ) as sub_sub_ctx:
-                            click.echo(sub_cmd.get_help(sub_sub_ctx))
-__all__ = ["cli", "add_help_recursive"]
+    # Create a fake parent context to show correct command path in Usage
+    fake_parent = click.Context(click.Group(), info_name="scitex")
+    parent_ctx = click.Context(group, info_name=group.name, parent=fake_parent)
+    click.secho(f"━━━ scitex {group.name} ━━━", fg="cyan", bold=True)
+    click.echo(group.get_help(parent_ctx))
+    for name in sorted(group.list_commands(ctx) or []):
+        cmd = group.get_command(ctx, name)
+        if cmd is None:
+            continue
+        click.echo()
+        click.secho(f"━━━ scitex {group.name} {name} ━━━", fg="cyan", bold=True)
+        with click.Context(cmd, info_name=name, parent=parent_ctx) as sub_ctx:
+            click.echo(cmd.get_help(sub_ctx))
+            # Handle nested subgroups
+            if isinstance(cmd, click.Group):
+                for sub_name in sorted(cmd.list_commands(sub_ctx) or []):
+                    sub_cmd = cmd.get_command(sub_ctx, sub_name)
+                    if sub_cmd is None:
+                        continue
+                    click.echo()
+                    click.secho(
+                        f"━━━ scitex {group.name} {name} {sub_name} ━━━",
+                        fg="cyan",
+                        bold=True,
+                    )
+                    with click.Context(
+                        sub_cmd, info_name=sub_name, parent=sub_ctx
+                    ) as sub_sub_ctx:
+                        click.echo(sub_cmd.get_help(sub_sub_ctx))
+__all__ = ["cli", "print_help_recursive"]

scitex/cli/audio.py CHANGED Viewed

@@ -10,8 +10,13 @@ import sys
 import click
-@click.group(context_settings={"help_option_names": ["-h", "--help"]})
-def audio():
+@click.group(
+    context_settings={"help_option_names": ["-h", "--help"]},
+    invoke_without_command=True,
+)
+@click.option("--help-recursive", is_flag=True, help="Show help for all subcommands")
+@click.pass_context
+def audio(ctx, help_recursive):
     """
     Text-to-speech utilities
@@ -28,25 +33,13 @@ def audio():
       scitex audio backends              # List available backends
       scitex audio check                 # Check audio status (WSL)
     """
-    pass
+    if help_recursive:
+        from . import print_help_recursive
-@audio.command("help-recursive")
-@click.pass_context
-def help_recursive(ctx):
-    """Show help for all commands recursively."""
-    fake_parent = click.Context(click.Group(), info_name="scitex")
-    parent_ctx = click.Context(audio, info_name="audio", parent=fake_parent)
-    click.secho("━━━ scitex audio ━━━", fg="cyan", bold=True)
-    click.echo(audio.get_help(parent_ctx))
-    for name in sorted(audio.list_commands(ctx) or []):
-        cmd = audio.get_command(ctx, name)
-        if cmd is None or name == "help-recursive":
-            continue
-        click.echo()
-        click.secho(f"━━━ scitex audio {name} ━━━", fg="cyan", bold=True)
-        with click.Context(cmd, info_name=name, parent=parent_ctx) as sub_ctx:
-            click.echo(cmd.get_help(sub_ctx))
+        print_help_recursive(ctx, audio)
+        ctx.exit(0)
+    elif ctx.invoked_subcommand is None:
+        click.echo(ctx.get_help())
 @audio.command()
@@ -247,7 +240,28 @@ def stop():
         sys.exit(1)
-@audio.command()
+@audio.group(invoke_without_command=True)
+@click.pass_context
+def mcp(ctx):
+    """
+    MCP (Model Context Protocol) server operations
+    \b
+    Commands:
+      start      - Start the MCP server
+      doctor     - Check MCP server health
+      list-tools - List available MCP tools
+    \b
+    Examples:
+      scitex audio mcp start
+      scitex audio mcp start -t http --port 31293
+    """
+    if ctx.invoked_subcommand is None:
+        click.echo(ctx.get_help())
+@mcp.command()
 @click.option(
     "-t",
     "--transport",
@@ -262,13 +276,13 @@ def stop():
 )
 @click.option(
     "--port",
-    default=8084,
+    default=31293,
     type=int,
-    help="Port for HTTP/SSE transport (default: 8084)",
+    help="Port for HTTP/SSE transport (default: 31293)",
 )
-def serve(transport, host, port):
+def start(transport, host, port):
     """
-    Run MCP server for remote audio playback
+    Start the MCP server for remote audio playback
     Enables remote agents (via SSH) to play audio on local speakers.
@@ -280,22 +294,9 @@ def serve(transport, host, port):
     \b
     Examples:
-      # Local stdio (Claude Desktop)
-      scitex audio serve
-      # HTTP server for remote agents
-      scitex audio serve -t http --port 8084
-      # SSE server
-      scitex audio serve -t sse --port 8084
-    \b
-    Remote Setup:
-      1. Local:  scitex audio serve -t http --port 8084
-      2. SSH:    Add to ~/.ssh/config:
-                   LocalForward 8084 127.0.0.1:8084
-      3. Remote MCP config:
-                   {"type": "sse", "url": "http://localhost:8084/sse"}
+      scitex audio mcp start
+      scitex audio mcp start -t http --port 31293
+      scitex audio mcp start -t sse --port 31293
     """
     try:
         from scitex.audio.mcp_server import FASTMCP_AVAILABLE, run_server
@@ -327,5 +328,123 @@ def serve(transport, host, port):
         sys.exit(1)
+@mcp.command()
+def doctor():
+    """
+    Check MCP server health and dependencies
+    \b
+    Example:
+      scitex audio mcp doctor
+    """
+    click.secho("Audio MCP Server Health Check", fg="cyan", bold=True)
+    click.echo()
+    # Check fastmcp
+    click.echo("Checking FastMCP... ", nl=False)
+    try:
+        from scitex.audio.mcp_server import FASTMCP_AVAILABLE
+        if FASTMCP_AVAILABLE:
+            click.secho("OK", fg="green")
+        else:
+            click.secho("NOT INSTALLED", fg="red")
+            click.echo("  Install with: pip install fastmcp")
+    except ImportError:
+        click.secho("FAIL", fg="red")
+    # Check audio backends
+    click.echo("Checking audio backends... ", nl=False)
+    try:
+        from scitex.audio import available_backends
+        backends = available_backends()
+        if backends:
+            click.secho(f"OK ({', '.join(backends)})", fg="green")
+        else:
+            click.secho("NONE AVAILABLE", fg="yellow")
+    except Exception as e:
+        click.secho(f"FAIL ({e})", fg="red")
+@mcp.command("list-tools")
+def list_tools():
+    """
+    List available MCP tools
+    \b
+    Example:
+      scitex audio mcp list-tools
+    """
+    click.secho("Audio MCP Tools", fg="cyan", bold=True)
+    click.echo()
+    tools = [
+        ("audio_speak", "Convert text to speech and play audio"),
+        ("audio_generate_audio", "Generate audio file without playing"),
+        ("audio_list_backends", "List available TTS backends"),
+        ("audio_list_voices", "List available voices for a backend"),
+        ("audio_play_audio", "Play an audio file"),
+        ("audio_check_audio_status", "Check audio system status"),
+    ]
+    for name, desc in tools:
+        click.echo(f"  {name}: {desc}")
+@audio.command()
+@click.option(
+    "--host",
+    default="0.0.0.0",
+    help="Host to bind (default: 0.0.0.0)",
+)
+@click.option(
+    "--port",
+    default=31293,
+    type=int,
+    help="Port to bind (default: 31293)",
+)
+def relay(host, port):
+    """
+    Run simple HTTP relay server for remote audio playback
+    Unlike 'serve' (MCP server), this exposes simple REST endpoints
+    that remote agents can POST to for audio playback.
+    \b
+    Endpoints:
+      POST /speak        - Play text-to-speech
+      GET  /health       - Health check
+      GET  /list_backends - List available backends
+    \b
+    Example:
+      # On your local machine (where you want audio)
+      scitex audio relay --port 31293
+      # On remote server, set env var
+      export SCITEX_AUDIO_RELAY_URL=http://YOUR_LOCAL_IP:31293
+      # Or use SSH reverse tunnel
+      ssh -R 31293:localhost:31293 remote-server
+    """
+    try:
+        from scitex.audio.mcp_server import run_relay_server
+        click.secho("Starting audio relay server", fg="cyan")
+        click.echo(f"  Host: {host}")
+        click.echo(f"  Port: {port}")
+        click.echo()
+        click.echo("Endpoints:")
+        click.echo("  POST /speak       - Play text-to-speech")
+        click.echo("  GET  /health      - Health check")
+        click.echo("  GET  /list_backends - List backends")
+        click.echo()
+        run_relay_server(host=host, port=port)
+    except Exception as e:
+        click.secho(f"Error: {e}", fg="red", err=True)
+        sys.exit(1)
 if __name__ == "__main__":
     audio()

scitex/cli/capture.py CHANGED Viewed

@@ -10,8 +10,13 @@ import sys
 import click
-@click.group(context_settings={"help_option_names": ["-h", "--help"]})
-def capture():
+@click.group(
+    context_settings={"help_option_names": ["-h", "--help"]},
+    invoke_without_command=True,
+)
+@click.option("--help-recursive", is_flag=True, help="Show help for all subcommands")
+@click.pass_context
+def capture(ctx, help_recursive):
     """
     Screen capture and monitoring utilities
@@ -33,25 +38,13 @@ def capture():
       scitex capture gif                      # Create GIF from latest session
       scitex capture info                     # List monitors and windows
     """
-    pass
+    if help_recursive:
+        from . import print_help_recursive
-@capture.command("help-recursive")
-@click.pass_context
-def help_recursive(ctx):
-    """Show help for all commands recursively."""
-    fake_parent = click.Context(click.Group(), info_name="scitex")
-    parent_ctx = click.Context(capture, info_name="capture", parent=fake_parent)
-    click.secho("━━━ scitex capture ━━━", fg="cyan", bold=True)
-    click.echo(capture.get_help(parent_ctx))
-    for name in sorted(capture.list_commands(ctx) or []):
-        cmd = capture.get_command(ctx, name)
-        if cmd is None or name == "help-recursive":
-            continue
-        click.echo()
-        click.secho(f"━━━ scitex capture {name} ━━━", fg="cyan", bold=True)
-        with click.Context(cmd, info_name=name, parent=parent_ctx) as sub_ctx:
-            click.echo(cmd.get_help(sub_ctx))
+        print_help_recursive(ctx, capture)
+        ctx.exit(0)
+    elif ctx.invoked_subcommand is None:
+        click.echo(ctx.get_help())
 @capture.command()
@@ -321,5 +314,125 @@ def window(handle, output, quality):
         sys.exit(1)
+@capture.group(invoke_without_command=True)
+@click.pass_context
+def mcp(ctx):
+    """
+    MCP (Model Context Protocol) server operations
+    \b
+    Commands:
+      start      - Start the MCP server
+      doctor     - Check MCP server health
+      list-tools - List available MCP tools
+    \b
+    Examples:
+      scitex capture mcp start
+      scitex capture mcp list-tools
+    """
+    if ctx.invoked_subcommand is None:
+        click.echo(ctx.get_help())
+@mcp.command("start")
+@click.option(
+    "-t",
+    "--transport",
+    type=click.Choice(["stdio", "sse", "http"]),
+    default="stdio",
+    help="Transport protocol (default: stdio)",
+)
+@click.option("--host", default="0.0.0.0", help="Host for HTTP/SSE (default: 0.0.0.0)")
+@click.option(
+    "--port", default=8096, type=int, help="Port for HTTP/SSE (default: 8096)"
+)
+def mcp_start(transport, host, port):
+    """
+    Start the capture MCP server
+    \b
+    Examples:
+      scitex capture mcp start
+      scitex capture mcp start -t http --port 8096
+    """
+    try:
+        from scitex.capture.mcp_server import main as run_server
+        if transport != "stdio":
+            click.secho(f"Starting capture MCP server ({transport})", fg="cyan")
+            click.echo(f"  Host: {host}")
+            click.echo(f"  Port: {port}")
+        run_server()
+    except ImportError as e:
+        click.secho(f"Error: {e}", fg="red", err=True)
+        click.echo("\nInstall dependencies: pip install fastmcp")
+        sys.exit(1)
+    except Exception as e:
+        click.secho(f"Error: {e}", fg="red", err=True)
+        sys.exit(1)
+@mcp.command()
+def doctor():
+    """
+    Check MCP server health and dependencies
+    \b
+    Example:
+      scitex capture mcp doctor
+    """
+    click.secho("Capture MCP Server Health Check", fg="cyan", bold=True)
+    click.echo()
+    click.echo("Checking FastMCP... ", nl=False)
+    try:
+        import fastmcp  # noqa: F401
+        click.secho("OK", fg="green")
+    except ImportError:
+        click.secho("NOT INSTALLED", fg="red")
+        click.echo("  Install with: pip install fastmcp")
+    click.echo("Checking capture module... ", nl=False)
+    try:
+        from scitex import capture as _  # noqa: F401
+        click.secho("OK", fg="green")
+    except ImportError as e:
+        click.secho(f"FAIL ({e})", fg="red")
+@mcp.command("list-tools")
+def list_tools():
+    """
+    List available MCP tools
+    \b
+    Example:
+      scitex capture mcp list-tools
+    """
+    click.secho("Capture MCP Tools", fg="cyan", bold=True)
+    click.echo()
+    tools = [
+        ("capture_capture_screenshot", "Capture screenshot"),
+        ("capture_capture_window", "Capture specific window"),
+        ("capture_start_monitoring", "Start continuous capture"),
+        ("capture_stop_monitoring", "Stop monitoring"),
+        ("capture_get_monitoring_status", "Get monitoring status"),
+        ("capture_analyze_screenshot", "Analyze screenshot for errors"),
+        ("capture_list_recent_screenshots", "List recent screenshots"),
+        ("capture_clear_cache", "Clear screenshot cache"),
+        ("capture_create_gif", "Create animated GIF"),
+        ("capture_list_sessions", "List monitoring sessions"),
+        ("capture_get_info", "Get monitor/window info"),
+        ("capture_list_windows", "List visible windows"),
+    ]
+    for name, desc in tools:
+        click.echo(f"  {name}: {desc}")
 if __name__ == "__main__":
     capture()

scitex 2.14.0__py3-none-any.whl → 2.15.3__py3-none-any.whl

scitex 2.14.0py3-none-any.whl → 2.15.3py3-none-any.whl