model-compose 0.4.26__tar.gz → 0.4.28__tar.gz

{model_compose-0.4.26/src/model_compose.egg-info → model_compose-0.4.28}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: model-compose
-Version: 0.4.26
+Version: 0.4.28
 Summary: model-compose: Declarative AI Workflow Orchestrator
 Author-email: Hanyeol Cho <hanyeol.cho@gmail.com>
 License-Expression: MIT
@@ -62,6 +62,12 @@ Define complex AI workflows entirely in YAML—no Python, no JavaScript, no codi
 ### 🔗 **Universal AI Service Integration**
 Connect to any AI provider out of the box—OpenAI, Anthropic Claude, Google Gemini, ElevenLabs, Stability AI, Replicate, or any custom HTTP API. Mix and match services in a single workflow.
 
+### 🤖 **Agent Components**
+Build autonomous AI agents that use workflows as tools. Agents can reason, plan, and execute multi-step tasks by dynamically invoking other workflows—all defined declaratively in YAML.
+
+### ✋ **Human-in-the-Loop**
+Add approval gates and user input steps to any workflow with interrupt configuration. Workflows pause, prompt for human input via CLI, Web UI, or API, and resume seamlessly—perfect for review, moderation, and supervised AI pipelines.
+
 ### 🖥️ **Local Model Execution**
 Run models from HuggingFace and other sources locally with native support for transformers, PyTorch, and model serving frameworks. Fine-tune models with LoRA/PEFT, train with custom datasets, all through YAML configuration.
 
@@ -124,6 +130,12 @@ controller:
   webui:
     port: 8081
 
+workflows:
+  - id: chat
+    default: true
+    jobs:
+      - component: chatgpt
+
 components:
   - id: chatgpt
     type: http-client
@@ -137,12 +149,6 @@ components:
       messages:
         - role: user
           content: ${input.prompt}
-
-workflows:
-  - id: chat
-    default: true
-    jobs:
-      - component: chatgpt
 ```
 
 Create a `.env` file:
@@ -211,7 +217,7 @@ pip install -e .[dev]
 ---
 
 ## 📄 License
-MIT License © 2025 Hanyeol Cho.
+MIT License © 2025-2026 Hanyeol Cho.
 
 ---
 

{model_compose-0.4.26 → model_compose-0.4.28}/README.md

@@ -36,6 +36,12 @@ Define complex AI workflows entirely in YAML—no Python, no JavaScript, no codi
 ### 🔗 **Universal AI Service Integration**
 Connect to any AI provider out of the box—OpenAI, Anthropic Claude, Google Gemini, ElevenLabs, Stability AI, Replicate, or any custom HTTP API. Mix and match services in a single workflow.
 
+### 🤖 **Agent Components**
+Build autonomous AI agents that use workflows as tools. Agents can reason, plan, and execute multi-step tasks by dynamically invoking other workflows—all defined declaratively in YAML.
+
+### ✋ **Human-in-the-Loop**
+Add approval gates and user input steps to any workflow with interrupt configuration. Workflows pause, prompt for human input via CLI, Web UI, or API, and resume seamlessly—perfect for review, moderation, and supervised AI pipelines.
+
 ### 🖥️ **Local Model Execution**
 Run models from HuggingFace and other sources locally with native support for transformers, PyTorch, and model serving frameworks. Fine-tune models with LoRA/PEFT, train with custom datasets, all through YAML configuration.
 
@@ -98,6 +104,12 @@ controller:
   webui:
     port: 8081
 
+workflows:
+  - id: chat
+    default: true
+    jobs:
+      - component: chatgpt
+
 components:
   - id: chatgpt
     type: http-client
@@ -111,12 +123,6 @@ components:
       messages:
         - role: user
           content: ${input.prompt}
-
-workflows:
-  - id: chat
-    default: true
-    jobs:
-      - component: chatgpt
 ```
 
 Create a `.env` file:
@@ -185,7 +191,7 @@ pip install -e .[dev]
 ---
 
 ## 📄 License
-MIT License © 2025 Hanyeol Cho.
+MIT License © 2025-2026 Hanyeol Cho.
 
 ---
 

{model_compose-0.4.26 → model_compose-0.4.28}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "model-compose"
-version = "0.4.26"
+version = "0.4.28"
 description = "model-compose: Declarative AI Workflow Orchestrator"
 authors = [
     { name = "Hanyeol Cho", email = "hanyeol.cho@gmail.com" }

{model_compose-0.4.26 → model_compose-0.4.28}/src/mindor/cli/compose.py

@@ -302,6 +302,8 @@ def validate_command(
                 summary_parts.append(f"{len(config.listeners)} listener(s)")
             if config.gateways:
                 summary_parts.append(f"{len(config.gateways)} gateway(s)")
+            if config.systems:
+                summary_parts.append(f"{len(config.systems)} system(s)")
             if config.loggers:
                 summary_parts.append(f"{len(config.loggers)} logger(s)")
             click.echo(f"✅ Configuration is valid ({', '.join(summary_parts)})")

{model_compose-0.4.26 → model_compose-0.4.28}/src/mindor/core/component/base.py

@@ -8,6 +8,7 @@ from mindor.dsl.schema.workflow import WorkflowConfig
 from mindor.dsl.schema.runtime import ProcessRuntimeConfig
 from mindor.core.foundation import AsyncService
 from mindor.core.utils.work_queue import WorkQueue
+from mindor.core.utils.active_counter import ActiveCounter
 from mindor.core.logger import logging
 from .context import ComponentActionContext
 
@@ -52,6 +53,7 @@ class ComponentService(AsyncService):
         self.global_configs: ComponentGlobalConfigs = global_configs
         self.work_queue: Optional[WorkQueue] = None
         self._process_manager = None
+        self._active_counter: ActiveCounter = ActiveCounter()
 
         if self.config.max_concurrent_count > 0:
             self.work_queue = WorkQueue(self.config.max_concurrent_count, self._run)
@@ -82,7 +84,11 @@ class ComponentService(AsyncService):
         if self.work_queue:
             return await (await self.work_queue.schedule(action, context))
 
-        return await self._run(action, context)
+        self._active_counter.acquire()
+        try:
+            return await self._run(action, context)
+        finally:
+            self._active_counter.release()
 
     async def stop(self) -> None:
         if self._process_manager:
@@ -101,6 +107,7 @@ class ComponentService(AsyncService):
         if self.work_queue:
             await self.work_queue.stop()
 
+        await self._active_counter.wait_for_zero()
         await super()._stop()
 
     async def _serve(self) -> None:

{model_compose-0.4.26 → model_compose-0.4.28}/src/mindor/core/component/services/__init__.py

@@ -10,4 +10,5 @@ from .shell import *
 from .text_splitter import *
 from .image_processor import *
 from .web_scraper import *
+from .web_browser import *
 from .agent import *

{model_compose-0.4.26 → model_compose-0.4.28}/src/mindor/core/component/services/model/base/common.py

@@ -19,6 +19,8 @@ class ModelTaskService(AsyncService):
 
         self.id: str = id
         self.config: ModelComponentConfig = config
+        self._model_loaded: bool = False
+        self._model_load_lock: asyncio.Lock = asyncio.Lock()
 
     def get_setup_requirements(self) -> Optional[List[str]]:
         return [ "torch" ]
@@ -26,11 +28,41 @@ class ModelTaskService(AsyncService):
     async def run(self, action: ModelActionConfig, context: ComponentActionContext) -> Any:
         loop: asyncio.AbstractEventLoop = asyncio.get_running_loop()
 
+        if not self._model_loaded:
+            async with self._model_load_lock:
+                if not self._model_loaded:
+                    self._load_model_on_demand()
+
         async def _run():
             return await self._run(action, context, loop)
 
         return await self.run_in_thread(_run)
 
+    async def _serve(self) -> None:
+        if self.config.preload:
+            self._load_model()
+            self._model_loaded = True
+        else:
+            logging.info(f"Component '{self.id}': model will be loaded on demand")
+
+    async def _shutdown(self) -> None:
+        if self._model_loaded:
+            self._unload_model()
+            self._model_loaded = False
+
+    def _load_model_on_demand(self) -> None:
+        logging.info(f"Component '{self.id}': loading model on demand...")
+        self._load_model()
+        self._model_loaded = True
+
+    @abstractmethod
+    def _load_model(self) -> None:
+        pass
+
+    @abstractmethod
+    def _unload_model(self) -> None:
+        pass
+
     @abstractmethod
     async def _run(self, action: ModelActionConfig, context: ComponentActionContext, loop: asyncio.AbstractEventLoop) -> Any:
         pass

{model_compose-0.4.26 → model_compose-0.4.28}/src/mindor/core/component/services/model/base/huggingface.py

@@ -129,17 +129,12 @@ class HuggingfaceLanguageModelTaskService(HuggingfaceModelTaskService):
             "accelerate"
         ]
 
-    async def _serve(self) -> None:
-        try:
-            self.model = self._load_pretrained_model()
-            self.tokenizer = self._load_pretrained_tokenizer()
-            self.device = self._get_model_device(self.model)
-            logging.info(f"Model and tokenizer loaded successfully on device '{self.device}': {self.config.model}")
-        except Exception as e:
-            logging.error(f"Failed to load model '{self.config.model}': {e}")
-            raise
-
-    async def _shutdown(self) -> None:
+    def _load_model(self) -> None:
+        self.model = self._load_pretrained_model()
+        self.tokenizer = self._load_pretrained_tokenizer()
+        self.device = self._get_model_device(self.model)
+
+    def _unload_model(self) -> None:
         self.model = None
         self.tokenizer = None
         self.device = None
@@ -202,17 +197,12 @@ class HuggingfaceMultimodalModelTaskService(HuggingfaceModelTaskService):
             "accelerate"
         ]
 
-    async def _serve(self) -> None:
-        try:
-            self.model = self._load_pretrained_model()
-            self.processor = self._load_pretrained_processor()
-            self.device = self._get_model_device(self.model)
-            logging.info(f"Model and processor loaded successfully on device '{self.device}': {self.config.model}")
-        except Exception as e:
-            logging.error(f"Failed to load model '{self.config.model}': {e}")
-            raise
-
-    async def _shutdown(self) -> None:
+    def _load_model(self) -> None:
+        self.model = self._load_pretrained_model()
+        self.processor = self._load_pretrained_processor()
+        self.device = self._get_model_device(self.model)
+
+    def _unload_model(self) -> None:
         self.model = None
         self.processor = None
         self.device = None

{model_compose-0.4.26 → model_compose-0.4.28}/src/mindor/core/component/services/model/base/unsloth.py

@@ -3,7 +3,6 @@ from typing import TYPE_CHECKING
 
 from typing import Type, Union, Literal, Optional, Dict, List, Tuple, Set, Annotated, Callable, Any
 from mindor.dsl.schema.component import ModelComponentConfig, DeviceMode
-from mindor.core.logger import logging
 from .common import ModelTaskService
 
 if TYPE_CHECKING:
@@ -22,18 +21,12 @@ class UnslothModelTaskService(ModelTaskService):
             "torch"
         ]
 
-    async def _serve(self) -> None:
-        try:
-            self.model, self.tokenizer = self._load_pretrained_model()
-            logging.info(f"Model and tokenizer loaded successfully: {self.config.model}")
-        except Exception as e:
-            logging.error(f"Failed to load model '{self.config.model}': {e}")
-            raise
+    def _load_model(self) -> None:
+        self.model, self.tokenizer = self._load_pretrained_model()
 
-    async def _shutdown(self) -> None:
+    def _unload_model(self) -> None:
         self.model = None
         self.tokenizer = None
-        self.device = None
 
     def _load_pretrained_model(self) -> Tuple[PreTrainedModel, PreTrainedTokenizer]:
         from unsloth import FastLanguageModel