simo 2.11.4__py3-none-any.whl → 3.0.4__py3-none-any.whl

simo/mcp_server/migrations/0002_alter_instanceaccesstoken_date_expired.py

@@ -0,0 +1,18 @@
+# Generated by Django 4.2.10 on 2025-09-24 07:04
+
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ('mcp_server', '0001_initial'),
+    ]
+
+    operations = [
+        migrations.AlterField(
+            model_name='instanceaccesstoken',
+            name='date_expired',
+            field=models.DateTimeField(blank=True, db_index=True, null=True),
+        ),
+    ]

simo/mcp_server/migrations/0003_instanceaccesstoken_issuer.py

@@ -0,0 +1,18 @@
+# Generated by Django 4.2.10 on 2025-09-24 08:07
+
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ('mcp_server', '0002_alter_instanceaccesstoken_date_expired'),
+    ]
+
+    operations = [
+        migrations.AddField(
+            model_name='instanceaccesstoken',
+            name='issuer',
+            field=models.CharField(db_index=True, editable=False, null=True),
+        ),
+    ]

simo/mcp_server/models.py

@@ -0,0 +1,27 @@
+from django.db import models
+from simo.core.models import Instance
+from simo.core.utils.helpers import get_random_string
+from simo.core.middleware import get_current_instance
+
+
+def get_new_token():
+    token = get_random_string(size=20)
+    instance = get_current_instance()
+    if InstanceAccessToken.objects.filter(
+        instance=instance, token=token
+    ).first():
+        return get_new_token()
+    return token
+
+
+class InstanceAccessToken(models.Model):
+    instance = models.ForeignKey(Instance, on_delete=models.CASCADE)
+    date_created = models.DateTimeField(auto_now_add=True, db_index=True)
+    token = models.CharField(
+        max_length=20, unique=True, db_index=True, default=get_new_token
+    )
+    date_expired = models.DateTimeField(null=True, blank=True, db_index=True)
+    user = models.ForeignKey(
+        'users.User', null=True, blank=True, on_delete=models.SET_NULL
+    )
+    issuer = models.CharField(db_index=True, editable=False, null=True)

simo/mcp_server/server.py

@@ -0,0 +1,60 @@
+import os
+import logging
+import django
+
+os.environ.setdefault("DJANGO_SETTINGS_MODULE", "settings")
+django.setup()
+
+from django.apps import apps
+from simo.mcp_server.app import mcp
+from starlette.middleware import Middleware
+from starlette.middleware.base import BaseHTTPMiddleware
+from fastmcp.server.http import create_streamable_http_app
+
+
+log = logging.getLogger("simo")
+logging.basicConfig(
+    level=logging.INFO,
+    format="%(asctime)s %(levelname).1s %(name)s: %(message)s",
+)
+
+
+def load_tools_from_apps() -> None:
+    import importlib.util
+
+    for cfg in apps.get_app_configs():
+        mod_name = f"{cfg.name}.mcp"
+
+        # Only attempt import if module exists
+        if importlib.util.find_spec(mod_name) is None:
+            continue
+
+        try:
+            importlib.import_module(mod_name)
+            log.info("Loaded MCP tools: %s", mod_name)
+        except Exception:
+            # Keep the server up; log full traceback and continue
+            log.exception("Failed to import %s", mod_name)
+
+
+class LogExceptions(BaseHTTPMiddleware):
+    async def dispatch(self, request, call_next):
+        try:
+            return await call_next(request)
+        except Exception:
+            log.exception("Unhandled exception in %s %s", request.method, request.url.path)
+            raise  # Let Starlette/Uvicorn still return 500
+
+
+def create_app():
+    load_tools_from_apps()
+    app = create_streamable_http_app(
+        server=mcp,
+        streamable_http_path="/",
+        auth=mcp.auth,
+        json_response=True,
+        stateless_http=True,
+        debug=True,
+        middleware=[Middleware(LogExceptions)],
+    )
+    return app

simo/mcp_server/tasks.py

@@ -0,0 +1,19 @@
+import datetime
+from django.utils import timezone
+from celeryc import celery_app
+
+
+@celery_app.task
+def auto_expire_tokens():
+    """Auto expire instance access tokens that are older than one day"""
+    from .models import InstanceAccessToken
+    InstanceAccessToken.objects.filter(
+        date_created__lt=timezone.now() - datetime.timedelta(days=1),
+        date_expired=None
+    ).update(date_expired=timezone.now())
+
+
+
+@celery_app.on_after_finalize.connect
+def setup_periodic_tasks(sender, **kwargs):
+    sender.add_periodic_task(60 * 60, auto_expire_tokens.s()) # hourly cron

simo/multimedia/base_types.py

@@ -1,6 +1,31 @@
 from django.utils.translation import gettext_lazy as _
+from simo.core.base_types import BaseComponentType
 
-BASE_TYPES = {
-    'audio-player': _("Audio Player"),
-    'video-player': _("Video Player"),
-}
+
+class AudioPlayerType(BaseComponentType):
+    slug = 'audio-player'
+    name = _("Audio Player")
+    description = _("Playback control for audio sources.")
+    purpose = _("Use to play/pause/stop audio and adjust playback.")
+    required_methods = ('play', 'pause', 'stop')
+
+
+class VideoPlayerType(BaseComponentType):
+    slug = 'video-player'
+    name = _("Video Player")
+    description = _("Playback control for video sources.")
+    purpose = _("Use to control video playback in the app.")
+    required_methods = ('play', 'pause', 'stop')
+
+
+def _export_base_types_dict():
+    import inspect as _inspect
+    mapping = {}
+    for _name, _obj in globals().items():
+        if _inspect.isclass(_obj) and issubclass(_obj, BaseComponentType) \
+                and _obj is not BaseComponentType and getattr(_obj, 'slug', None):
+            mapping[_obj.slug] = _obj.name
+    return mapping
+
+
+BASE_TYPES = _export_base_types_dict()

simo/multimedia/controllers.py

@@ -1,6 +1,7 @@
 from django.utils.translation import gettext_lazy as _
 from simo.core.controllers import Switch, TimerMixin
 from .app_widgets import AudioPlayerWidget, VideoPlayerWidget
+from .base_types import AudioPlayerType, VideoPlayerType
 
 
 class BasePlayer(Switch):
@@ -32,60 +33,103 @@ class BasePlayer(Switch):
     def _validate_val(self, value, occasion=None):
         return value
 
+    def send(self, value):
+        """Control playback.
+
+        Parameters:
+        - value (str): one of 'play', 'pause', 'stop', 'next', 'previous', or
+        - value (dict): one of {'seek': seconds}, {'set_volume': 0-100},
+                        {'shuffle': bool}, {'loop': bool}, {'alert': id|None},
+                        {'play_from_library': id, 'volume': int|None, 'fade_in': seconds|None},
+                        {'play_uri': uri, 'volume': int|None}.
+        Prefer using the convenience methods (`play()`, `pause()`, `seek()`, ...).
+        """
+        return super().send(value)
+
     def play(self):
+        """Start or resume playback."""
         self.send('play')
 
     def pause(self):
+        """Pause playback (keeps current position)."""
         self.send('pause')
 
     def stop(self):
+        """Stop playback and reset position to start (if supported)."""
         self.send('stop')
 
     def seek(self, second):
+        """Seek to the specified position in seconds.
+
+        Parameters:
+        - second (int|float): Absolute position from start.
+        """
         self.send({'seek': second})
 
     def next(self):
+        """Skip to the next item in the queue/playlist."""
         self.send('next')
 
     def previous(self):
+        """Return to the previous item in the queue/playlist."""
         self.send('previous')
 
     def set_volume(self, val):
+        """Set output volume.
+
+        Parameters:
+        - val (int): Volume percent 0–100.
+        """
         assert 0 <= val <= 100
         self.component.meta['volume'] = val
         self.component.save()
         self.send({'set_volume': val})
 
     def get_volume(self):
-        '''override of possible with something more reliable'''
+        """Get the last known volume (0–100).
+
+        Note: This reads cached meta; device may differ if gateway does not
+        report volume changes.
+        """
         return self.component.meta['volume']
 
     def set_shuffle_play(self, val):
+        """Enable or disable shuffle mode.
+
+        Parameters:
+        - val (bool|int): Truthy to enable, falsy to disable.
+        """
         self.component.meta['shuffle'] = bool(val)
         self.component.save()
         self.send({'shuffle': bool(val)})
 
     def set_loop_play(self, val):
+        """Enable or disable loop/repeat mode.
+
+        Parameters:
+        - val (bool|int): Truthy to enable, falsy to disable.
+        """
         self.component.meta['loop'] = bool(val)
         self.component.save()
         self.send({'loop': bool(val)})
 
     def play_library_item(self, id, volume=None, fade_in=None):
-        '''
-        :param id: Library item ID
-        :param volume: Volume to play at. Current volume will be used if not provided
-        :param fade_in: number of seconds to fade in
-        :return:
-        '''
+        """Play an item from the controller's library.
+
+        Parameters:
+        - id: Library item identifier as provided by the gateway.
+        - volume (int|None): Optional volume 0–100; keep current if None.
+        - fade_in (int|float|None): Optional seconds to fade in.
+        """
         self.send({'play_from_library': id, 'volume': volume, 'fade_in': fade_in})
 
     def play_uri(self, uri, volume=None):
-        '''
-        Replace que with this single uri and play it immediately
-        :param uri: playable uri or url
-        :param volume: volume at which to play
-        :return:
-        '''
+        """Replace the queue with a single URI and play immediately.
+
+        Parameters:
+        - uri (str): Playable URI/URL (e.g. file://, http://, spotify:...).
+        - volume (int|None): Optional volume 0–100; keep current if None.
+        """
         if volume:
             assert 0 <= volume <= 100
         self.send({"play_uri": uri, 'volume': volume})
@@ -105,13 +149,19 @@ class BasePlayer(Switch):
 
 
     def play_alert(self, id):
+        """Play a one-shot alert sound by id, then resume previous playback.
+
+        Parameters:
+        - id: Alert sound identifier.
+        """
         self.send({"alert": id})
 
     def cancel_alert(self):
-        '''Cancel alert if it's currently playing'''
+        """Cancel an in-progress alert and resume previous playback."""
         self.send({"alert": None})
 
     def toggle(self):
+        """Toggle between play and pause based on current state."""
         if self.component.value == 'playing':
             self.pause()
         else:
@@ -121,15 +171,12 @@ class BasePlayer(Switch):
 class BaseAudioPlayer(BasePlayer):
     """Base class for audio players"""
     name = _("Audio Player")
-    base_type = 'audio-player'
+    base_type = AudioPlayerType
     app_widget = AudioPlayerWidget
 
 
 class BaseVideoPlayer(BasePlayer):
     """Base class for video players"""
     name = _("Video Player")
-    base_type = 'video-player'
+    base_type = VideoPlayerType
     app_widget = VideoPlayerWidget
-
-
-

simo/settings.py

@@ -76,6 +76,7 @@ INSTALLED_APPS = [
     'simo.multimedia',
     'simo.fleet',
     'simo.backups',
+    'simo.mcp_server',
 
     'django.contrib.admin',
     'adminsortable2',

simo/users/utils.py

@@ -30,6 +30,16 @@ def get_device_user():
     return device
 
 
+def get_ai_user():
+    from .models import User
+    device, new = User.objects.get_or_create(
+        email='ai@simo.io', defaults={
+            'name': "AI"
+        }
+    )
+    return device
+
+
 def rebuild_authorized_keys():
     from .models import User
     try:

{simo-2.11.4.dist-info → simo-3.0.4.dist-info}/METADATA

@@ -1,14 +1,14 @@
 Metadata-Version: 2.4
 Name: simo
-Version: 2.11.4
+Version: 3.0.4
 Summary: Smart Home Supremacy
-Author-email: Simanas Venčkauskas <simanas@simo.io>
+Author-email: "Simon V." <simon@simo.io>
 Project-URL: Homepage, https://simo.io
-Project-URL: Issues, https://github.com/pypa/sampleproject/issues
+Project-URL: Issues, https://github.com/SIMO-io/simo/issues
 Classifier: Programming Language :: Python :: 3
 Classifier: License :: OSI Approved :: MIT License
 Classifier: Operating System :: OS Independent
-Requires-Python: >=3.8
+Requires-Python: >=3.12
 Description-Content-Type: text/markdown
 License-File: LICENSE.md
 Requires-Dist: Django==4.2.10
@@ -44,14 +44,21 @@ Requires-Dist: django-location-field==2.1.0
 Requires-Dist: slugify==0.0.1
 Requires-Dist: django-countries==7.5.1
 Requires-Dist: librosa==0.10.1
+Requires-Dist: lameenc==1.8.1
 Requires-Dist: daphne==4.1.2
 Requires-Dist: Pillow==9.5.0
 Requires-Dist: django-markdownify==0.9.5
 Requires-Dist: django-activity-stream==2.0.0
 Requires-Dist: gunicorn==23.0.0
 Requires-Dist: python-crontab==3.2.0
+Requires-Dist: pydub==0.25.1
 Requires-Dist: django-object-actions==4.3.0
 Requires-Dist: tqdm==4.67.0
 Requires-Dist: bs4==0.0.2
 Requires-Dist: lxml==5.3.0
+Requires-Dist: websockets==15.0.1
+Requires-Dist: lameenc==1.8.1
+Requires-Dist: pydub==0.25.1
+Requires-Dist: fastmcp==2.12.3
+Requires-Dist: uvicorn==0.35.0
 Dynamic: license-file