agent-assembler 0.2.0__py3-none-any.whl

agent_assembler/__init__.py

@@ -0,0 +1,7 @@
+
+from .assembler import Assembler
+from .recipe import Recipe
+
+__version__ = "0.2.0.dev1"
+
+__all__ = ["Assembler", "Recipe"]

agent_assembler/adapters/__init__.py

@@ -0,0 +1,5 @@
+from .base import BaseAdapter
+from .coze import CozeAdapter
+from .qianwen import QianwenAdapter
+
+__all__ = ["BaseAdapter", "CozeAdapter", "QianwenAdapter"]

agent_assembler/adapters/base.py

@@ -0,0 +1,23 @@
+
+from abc import ABC, abstractmethod
+from typing import Any, Dict, List
+from ..recipe import Recipe
+
+class BaseAdapter(ABC):
+    """Base class for all platform adapters."""
+    
+    PLATFORM_NAME = "Base"
+    
+    @abstractmethod
+    def export(self, recipe: Recipe) -> Dict[str, Any]:
+        """Export recipe to target platform format."""
+        pass
+
+    @abstractmethod
+    def validate(self, recipe: Recipe) -> List[str]:
+        """Validate recipe against platform constraints."""
+        pass
+
+    def deploy(self, recipe: Recipe) -> bool:
+        """Deploy agent to platform."""
+        raise NotImplementedError("Deploy not implemented.")

agent_assembler/adapters/coze.py

@@ -0,0 +1,91 @@
+from typing import Any, Dict, List, Optional
+from ..recipe import Recipe
+from .base import BaseAdapter
+import os
+
+
+class CozeAdapter(BaseAdapter):
+    """Map Agent Assembler Recipe to Coze Bot Configuration.
+    
+    Coze Bots require:
+    - bot_info.name
+    - bot_info.description
+    - bot_info.prompt_info.prompt (system instruction)
+    - bot_info.onboarding_info.prologue (welcome message)
+    
+    This adapter injects Recipe + Skills content into the Coze DSL format.
+    """
+
+    PLATFORM_NAME = "Coze"
+
+    def __init__(self, skills_dir: Optional[str] = None):
+        """Initialize with optional skills directory for JIT loading."""
+        self.skills_dir = skills_dir
+
+    def _load_skills(self, recipe: Recipe) -> str:
+        """Load skill contents and format as prompt section."""
+        if not self.skills_dir:
+            return "(Skills directory not configured)"
+
+        sections = []
+        for skill_name in recipe.skills:
+            skill_path = os.path.join(self.skills_dir, skill_name, "SKILL.md")
+            if os.path.exists(skill_path):
+                with open(skill_path, "r", encoding="utf-8") as f:
+                    sections.append(f"### Skill: {skill_name}\n{f.read()}")
+            else:
+                sections.append(f"### Skill: {skill_name}\n[Warning: Skill file not found]")
+
+        return "\n\n".join(sections)
+
+    def export(self, recipe: Recipe) -> Dict[str, Any]:
+        """Export recipe as Coze-compatible bot configuration."""
+        # Build system prompt
+        system_prompt = f"# Role\nYou are an AI assistant specialized in **{recipe.name}**.\n\n"
+
+        if recipe.notes:
+            system_prompt += f"## Context\n{recipe.notes}\n\n"
+
+        system_prompt += "## Skills & Instructions\n"
+        skills_content = self._load_skills(recipe)
+        system_prompt += skills_content
+
+        system_prompt += "\n\n## Execution Rules\n"
+        system_prompt += "- Follow the skill instructions strictly.\n"
+        system_prompt += "- If user query doesn\'t match any skill, fall back to general assistance.\n"
+
+        # Construct Coze DSL
+        bot_config = {
+            "bot_info": {
+                "name": recipe.name,
+                "description": recipe.notes or f"Agent for {recipe.name}",
+                "prompt_info": {
+                    "prompt": system_prompt
+                },
+                "onboarding_info": {
+                    "prologue": f"你好，我是{recipe.name}助手。请告诉我你需要什么帮助？"
+                }
+            },
+            "model_info": {
+                "model_name": "coze-pro"
+            },
+            "metadata": {
+                "source": "agent-assembler",
+                "recipe_name": recipe.name,
+                "trigger_keywords": recipe.trigger_keywords,
+                "skills_count": len(recipe.skills)
+            }
+        }
+
+        return bot_config
+
+    def validate(self, recipe: Recipe) -> List[str]:
+        """Validate recipe against Coze platform constraints."""
+        errors = []
+        if len(recipe.name) > 50:
+            errors.append(f"Bot name \'{recipe.name}\' exceeds 50 characters limit.")
+        if not recipe.name:
+            errors.append("Bot name cannot be empty.")
+        if len(recipe.notes) > 500:
+            errors.append("Bot description exceeds 500 characters limit.")
+        return errors

agent_assembler/adapters/qianwen.py

@@ -0,0 +1,98 @@
+from typing import Any, Dict, List, Optional
+from ..recipe import Recipe
+from .base import BaseAdapter
+import os
+
+
+class QianwenAdapter(BaseAdapter):
+    """Map Agent Assembler Recipe to Qianwen (Tongyi) Agent Format.
+    
+    Qianwen agents (百炼/通义) require:
+    - name: Agent name
+    - description: Brief description
+    - system_prompt: Core instructions
+    - model: LLM model selection
+    
+    This adapter generates Chinese-optimized prompts.
+    """
+
+    PLATFORM_NAME = "Qianwen"
+
+    def __init__(self, skills_dir: Optional[str] = None):
+        """Initialize with optional skills directory for JIT loading."""
+        self.skills_dir = skills_dir
+
+    def _load_skills(self, recipe: Recipe) -> str:
+        """Load skill contents and format as prompt section."""
+        if not self.skills_dir:
+            return "(未配置技能目录)"
+
+        sections = []
+        for skill_name in recipe.skills:
+            skill_path = os.path.join(self.skills_dir, skill_name, "SKILL.md")
+            if os.path.exists(skill_path):
+                with open(skill_path, "r", encoding="utf-8") as f:
+                    sections.append(f"### 技能: {skill_name}\n{f.read()}")
+            else:
+                sections.append(f"### 技能: {skill_name}\n[警告: 技能文件未找到]")
+
+        return "\n\n".join(sections)
+
+    def export(self, recipe: Recipe) -> Dict[str, Any]:
+        """Export recipe as Qianwen-compatible agent configuration."""
+        # Build system prompt in Chinese
+        system_prompt = f"# 角色设定\n你是一个专业的 **{recipe.name}** 助手。\n\n"
+
+        if recipe.notes:
+            system_prompt += f"## 背景信息\n{recipe.notes}\n\n"
+
+        system_prompt += "## 可用技能与指令\n"
+        skills_content = self._load_skills(recipe)
+        system_prompt += skills_content
+
+        system_prompt += "\n\n## 执行规则\n"
+        system_prompt += "- 严格按照技能指令执行任务\n"
+        system_prompt += "- 如果用户请求不匹配任何技能，提供通用帮助\n"
+        system_prompt += "- 保持回答简洁、专业、准确\n"
+
+        # Construct Qianwen DSL
+        agent_config = {
+            "name": recipe.name,
+            "description": recipe.notes or f"智能体: {recipe.name}",
+            "system_prompt": system_prompt,
+            "welcome_message": f"你好，我是{recipe.name}助手，请问有什么可以帮您？",
+            "model": "qwen-max",
+            "parameters": {
+                "temperature": 0.7,
+                "top_p": 0.8,
+                "max_tokens": 2000
+            },
+            "metadata": {
+                "source": "agent-assembler",
+                "recipe_name": recipe.name,
+                "trigger_keywords": recipe.trigger_keywords,
+                "skills_count": len(recipe.skills),
+                "routing": recipe.routing
+            }
+        }
+
+        return agent_config
+
+    def validate(self, recipe: Recipe) -> List[str]:
+        """Validate recipe against Qianwen platform constraints."""
+        errors = []
+        if len(recipe.name) > 30:
+            errors.append(f"智能体名称 \'{recipe.name}\' 超过 30 字符限制。")
+        if not recipe.name:
+            errors.append("智能体名称不能为空。")
+        # Check for valid routing if specified
+        valid_routings = [
+            None, "engineering-stage-agent", "finance-agent",
+            "operations-venue-agent", "project-pmo-agent",
+            "digital-tech-agent", "planning-agent",
+            "marketing-promotion-agent", "legal-agent",
+            "agriculture-agent", "guandan-agent", "gr-agent", "media-agent"
+        ]
+        if recipe.routing and recipe.routing not in valid_routings:
+            errors.append(f"路由目标 \'{recipe.routing}\' 不在有效 Agent 列表中。")
+        return errors

agent_assembler/assembler.py

@@ -0,0 +1,85 @@
+
+import os
+import json
+import re
+from typing import List, Optional, Dict
+from .recipe import Recipe
+
+class Assembler:
+    """The core engine of Agent Assembler."""
+    
+    def __init__(self, recipes_dir: str, skills_dir: str):
+        self.recipes_dir = os.path.abspath(recipes_dir)
+        self.skills_dir = os.path.abspath(skills_dir)
+        self.recipes: List[Recipe] = []
+        
+        self._load_recipes()
+
+    def _load_recipes(self):
+        """Load all recipes from the configured directory."""
+        if not os.path.exists(self.recipes_dir):
+            raise FileNotFoundError(f"Recipes directory not found: {self.recipes_dir}")
+            
+        for root, _, files in os.walk(self.recipes_dir):
+            for file in files:
+                if file.endswith('.json'):
+                    path = os.path.join(root, file)
+                    try:
+                        recipe = Recipe.from_json(path)
+                        # Pre-load skills? No, JIT load them when matched to save time/memory.
+                        # But for SDK v1, maybe eager load is fine for small datasets.
+                        # Let's do lazy loading in assemble() for better performance.
+                        self.recipes.append(recipe)
+                    except Exception as e:
+                        print(f"Error loading recipe {path}: {e}")
+
+    def match_recipe(self, query: str) -> Optional[Recipe]:
+        """Find the best matching recipe for a user query."""
+        query_lower = query.lower()
+        matches = []
+        
+        for recipe in self.recipes:
+            for keyword in recipe.trigger_keywords:
+                if keyword.lower() in query_lower:
+                    matches.append(recipe)
+                    break # Found a match for this recipe
+        
+        if not matches:
+            return None
+            
+        # Return the first match (can be improved with scoring later)
+        return matches[0]
+
+    def assemble(self, query: str) -> Dict:
+        """Perform JIT assembly."""
+        recipe = self.match_recipe(query)
+        
+        if not recipe:
+            return {
+                "status": "fallback",
+                "message": "No matching recipe found.",
+                "system_prompt": query # Pass through
+            }
+            
+        # Load skills JIT
+        recipe.load_skills(self.skills_dir)
+        
+        # Construct Prompt
+        system_prompt = f"# Role\nYou are an AI assistant executing the task: {recipe.name}\n\n"
+        
+        if recipe.notes:
+            system_prompt += f"## Context\n{recipe.notes}\n\n"
+            
+        system_prompt += "## Skills & Rules\n"
+        
+        for skill_ref in recipe.skill_refs:
+            system_prompt += f"### Skill: {skill_ref.name}\n{skill_ref.content}\n\n"
+            
+        system_prompt += f"## User Query\n{query}"
+        
+        return {
+            "status": "success",
+            "recipe": recipe.name,
+            "skills_loaded": [s.name for s in recipe.skill_refs],
+            "system_prompt": system_prompt
+        }

agent_assembler/deploy/__init__.py

@@ -0,0 +1,3 @@
+
+from .coze_api import CozeApiClient
+from .qianwen_api import QianwenApiClient

agent_assembler/deploy/coze_api.py

@@ -0,0 +1,95 @@
+
+import requests
+import json
+from typing import Dict, Any, List, Optional
+
+class CozeApiClient:
+    # China Domestic API
+    API_BASE = "https://api.coze.cn/v1"
+    
+    def __init__(self, token: str):
+        self.headers = {
+            "Authorization": f"Bearer {token}",
+            "Content-Type": "application/json"
+        }
+
+    def create_bot(self, name: str, description: str, prompt: str, space_id: str) -> Optional[str]:
+        """
+        Create a bot on Coze (v1 API).
+        Returns bot_id if success.
+        """
+        url = f"{self.API_BASE}/bot/create"
+        payload = {
+            "space_id": space_id,
+            "name": name,
+            "description": description,
+            "prompt_info": {
+                "prompt": prompt
+            }
+        }
+        
+        try:
+            resp = requests.post(url, headers=self.headers, json=payload)
+            data = resp.json()
+            if data.get("code") == 0:
+                bot_id = data.get("data", {}).get("bot_id")
+                print(f"Bot created: {bot_id}")
+                return bot_id
+            else:
+                error_msg = data.get("msg", "Unknown error")
+                print(f"Coze API Error: {error_msg}")
+                return None
+        except Exception as e:
+            print(f"Request Error: {e}")
+            return None
+
+    def install_connector(self, connector_id: str, workspace_id: str) -> bool:
+        """
+        Add a publishing channel (Connector) to the workspace.
+        e.g. connector_id for Douyin, Feishu, etc.
+        """
+        url = f"{self.API_BASE}/connectors/{connector_id}/install"
+        payload = {
+            "workspace_id": workspace_id
+        }
+        
+        try:
+            resp = requests.post(url, headers=self.headers, json=payload)
+            data = resp.json()
+            if data.get("code") == 0:
+                print(f"Connector {connector_id} installed to workspace {workspace_id}")
+                return True
+            else:
+                print(f"Install Connector Error: {data.get('msg')}")
+                return False
+        except Exception as e:
+            print(f"Request Error: {e}")
+            return False
+
+    def publish_bot(self, bot_id: str, connector_ids: List[str] = None) -> bool:
+        """
+        Publish the bot to specified channels.
+        Default connector_ids: ['1024'] (API/SDK)
+        """
+        if connector_ids is None:
+            connector_ids = ["1024"]
+            
+        url = f"{self.API_BASE}/bot/publish"
+        payload = {
+            "bot_id": bot_id,
+            "connector_ids": connector_ids
+        }
+        
+        try:
+            resp = requests.post(url, headers=self.headers, json=payload)
+            data = resp.json()
+            if data.get("code") == 0:
+                print(f"Bot {bot_id} published to {connector_ids}")
+                return True
+            else:
+                print(f"Publish Bot Error: {data.get('msg')}")
+                return False
+        except Exception as e:
+            print(f"Publish Error: {e}")
+            return False
+

agent_assembler/deploy/qianwen_api.py

@@ -0,0 +1,58 @@
+
+import requests
+import json
+from typing import Dict, Any, Optional
+
+class QianwenApiClient:
+    # This is a placeholder for the specific Bailian/Model Studio Agent API
+    # As of now, Bailian Agent API might be complex. 
+    # We'll mock the structure based on common patterns or use a documented endpoint if available.
+    # Usually involves: Create Application -> Publish.
+    
+    API_BASE = "https://dashscope.aliyuncs.com/api/v1/apps" # Example endpoint
+    
+    def __init__(self, api_key: str):
+        self.headers = {
+            "Authorization": f"Bearer {api_key}",
+            "Content-Type": "application/json",
+            "X-DashScope-SSE": "disable" # Disable streaming for simple calls
+        }
+
+    def create_agent(self, name: str, description: str, prompt: str) -> Optional[str]:
+        """
+        Create an Agent/App on Bailian.
+        Returns app_id.
+        """
+        # Note: Real endpoint might differ. Using a representative structure.
+        url = f"{self.API_BASE}" 
+        payload = {
+            "name": name,
+            "description": description,
+            "prompt": prompt,
+            "model": "qwen-max" # Default model
+        }
+        
+        try:
+            # POST to create
+            # If this endpoint is not public for agents, this will fail gracefully
+            # For now, we assume a standard pattern
+            resp = requests.post(url, headers=self.headers, json=payload)
+            data = resp.json()
+            
+            # Check for success (structure varies)
+            if data.get("code") == 200 or "id" in data:
+                return data.get("id") or data.get("output", {}).get("app_id")
+            else:
+                print(f"Qianwen API Error: {data}")
+                return None
+        except Exception as e:
+            print(f"Request Error: {e}")
+            return None
+
+    def publish_agent(self, app_id: str) -> bool:
+        """
+        Publish the agent.
+        """
+        # Usually requires a separate publish call or versioning.
+        print(f"Publishing {app_id}...")
+        return True # Placeholder

agent_assembler/recipe.py

@@ -0,0 +1,66 @@
+
+import json
+import os
+from dataclasses import dataclass, field
+from typing import List, Optional, Dict, Any
+from pathlib import Path
+
+@dataclass
+class SkillRef:
+    name: str
+    content: str = ""
+    path: str = ""
+    loaded: bool = False
+
+    def load_content(self, root_dir: str):
+        """Load the actual skill content from file system."""
+        # Try to find the skill file
+        # Structure: {root_dir}/{skill_name}/SKILL.md
+        potential_path = os.path.join(root_dir, self.name, "SKILL.md")
+        if os.path.exists(potential_path):
+            with open(potential_path, "r", encoding="utf-8") as f:
+                self.content = f.read()
+            self.path = potential_path
+            self.loaded = True
+            return True
+        return False
+
+@dataclass
+class Recipe:
+    """Recipe maps user intent to specific skills."""
+    name: str
+    trigger_keywords: List[str]
+    skills: List[str] = field(default_factory=list) # Skill names
+    notes: str = ""
+    routing: Optional[str] = None
+    _skill_refs: List[SkillRef] = field(default_factory=list, init=False)
+
+    @property
+    def skill_refs(self) -> List[SkillRef]:
+        return self._skill_refs
+
+    def load_skills(self, skills_dir: str):
+        """Load all skills defined in this recipe."""
+        self._skill_refs = []
+        for skill_name in self.skills:
+            ref = SkillRef(name=skill_name)
+            if ref.load_content(skills_dir):
+                self._skill_refs.append(ref)
+            else:
+                print(f"[Warning] Skill not found: {skill_name} in {skills_dir}")
+
+    @classmethod
+    def from_dict(cls, data: Dict[str, Any], source_file: str = ""):
+        return cls(
+            name=data.get("name", Path(source_file).stem),
+            trigger_keywords=data.get("trigger_keywords", []),
+            skills=data.get("skills", []),
+            notes=data.get("notes", ""),
+            routing=data.get("routing")
+        )
+
+    @classmethod
+    def from_json(cls, path: str):
+        with open(path, 'r', encoding="utf-8") as f:
+            data = json.load(f)
+        return cls.from_dict(data, path)

agent_assembler-0.2.0.dist-info/METADATA

@@ -0,0 +1,51 @@
+Metadata-Version: 2.4
+Name: agent-assembler
+Version: 0.2.0
+Summary: Deterministic Context Assembly for AI Agents.
+License: MIT
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: streamlit
+Requires-Dist: requests
+Requires-Dist: pandas
+Dynamic: license-file
+
+# Agent Assembler 🧩
+
+> **Deterministic Context Assembly for AI Agents.**
+> The Engine for the Multi-Agent Distribution Network.
+
+⚠️ **Status**: Currently in active development (Phase 1: SDK Decoupling). Please clone from GitHub for now. `pip install` package coming soon in Phase 2.
+
+## 1. Vision
+**From JIT Engine to Agent Factory & Distribution Network.**
+Agent Assembler is no longer just a script; it is the **core engine** that powers multi-agent systems across platforms (Qianwen, Coze, WeChat, etc.).
+
+## 2. Core Architecture
+- **Recipe-First**: Intent matching pre-defined JSON recipes.
+- **Atomic Skills**: <4KB focused skill modules.
+- **JIT Assembly**: Assemble only what is needed, when it is needed.
+- **Multi-Platform Adapters**: Deploy to Qianwen, Coze, Baidu, and more with one click.
+
+## 3. Roadmap
+| Phase | Goal | Status |
+|-------|------|--------|
+| **P0** | Core Stabilization & Validation | ✅ Done |
+| **P1** | **SDK Decoupling & Standardization** | 🚧 Active |
+| **P2** | Multi-Platform Adapters (Coze/Qianwen) | ⬜ Planned |
+| **P3** | SaaS Dashboard & No-Code Builder | ⬜ Planned |
+
+## 4. Installation
+```bash
+pip install agent-assembler
+```
+
+## 5. Quick Start
+```python
+from agent_assembler import Assembler
+
+assembler = Assembler(recipes_dir="./recipes", skills_dir="./skills")
+result = assembler.assemble("Analyze this excel file")
+print(result['system_prompt'])
+```

agent_assembler-0.2.0.dist-info/RECORD

@@ -0,0 +1,15 @@
+agent_assembler/__init__.py,sha256=o2J8n-bbNtiwI2OBBfFFFtRgwaCb5t5VZo2oopJ9t_8,124
+agent_assembler/assembler.py,sha256=SsCVYJzDC2EzoAm5qpdZXezJYon3mWsj39sS6Lotw1A,3073
+agent_assembler/recipe.py,sha256=f1OSFN9AyfCnMSbZbAcMx0Yk1oyN92jF6atjzVVnh20,2130
+agent_assembler/adapters/__init__.py,sha256=mXC0Tte8yCjm7kefiCw-sRfz-hiDIDKTKSreAEEyPb0,156
+agent_assembler/adapters/base.py,sha256=VMXE4PvB25RysuaHU80aSs5TQ09DDHYI_jGXPvwFCJw,649
+agent_assembler/adapters/coze.py,sha256=zlAVQrxrQiUCbvyVeNm_cDkr4JgEJqKHdnfYcfghApA,3378
+agent_assembler/adapters/qianwen.py,sha256=B14UNGiK7Nsat68Pjtt509pjzbYIZd2S3JhFOdCrSP4,3862
+agent_assembler/deploy/__init__.py,sha256=vCl4DSaIIeWFb76dhlhJaf6_KzKPY_AMwvstil6lhXQ,79
+agent_assembler/deploy/coze_api.py,sha256=JcyDhF5T46DDrmOpCdOp01LVQ95LS1AwyfR5MyR7LIg,3096
+agent_assembler/deploy/qianwen_api.py,sha256=3I1NS44bsQa9MOAIsLz8HhR1WAcZ39KwkOqYnEL1Sl4,2103
+agent_assembler-0.2.0.dist-info/licenses/LICENSE,sha256=wWbdNra8DIz9HRQ77dt2fCUWx51WjfpYU-feI4YJ9g0,1070
+agent_assembler-0.2.0.dist-info/METADATA,sha256=BkLqgjnsFm8YoOhAonWlpO0nRI7LV7_ziU8hmRyS1vs,1715
+agent_assembler-0.2.0.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+agent_assembler-0.2.0.dist-info/top_level.txt,sha256=l8ktHSG__P_oBMzzxqCFUNRZ8Jcf-t44zuX-GgXmfZM,16
+agent_assembler-0.2.0.dist-info/RECORD,,

agent_assembler-0.2.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (82.0.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

agent_assembler-0.2.0.dist-info/licenses/LICENSE

@@ -0,0 +1,22 @@
+
+MIT License
+
+Copyright (c) 2026 Hermes Agent
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

agent_assembler-0.2.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+agent_assembler