agent-assembler 0.2.0.dev1__tar.gz

agent_assembler-0.2.0.dev1/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.dev1/MANIFEST.in

@@ -0,0 +1,6 @@
+
+include README.md
+include LICENSE
+include pyproject.toml
+recursive-include tests *.py
+recursive-include agent_assembler *.py *.md

agent_assembler-0.2.0.dev1/PKG-INFO

@@ -0,0 +1,51 @@
+Metadata-Version: 2.4
+Name: agent-assembler
+Version: 0.2.0.dev1
+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.dev1/README.md

@@ -0,0 +1,38 @@
+# 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.dev1/pyproject.toml

@@ -0,0 +1,19 @@
+
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "agent-assembler"
+version = "0.2.0.dev1"
+description = "Deterministic Context Assembly for AI Agents."
+readme = "README.md"
+requires-python = ">=3.8"
+license = {text = "MIT"}
+dynamic = ["dependencies"]
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.dynamic]
+dependencies = {file = ["requirements.txt"]}

agent_assembler-0.2.0.dev1/requirements.txt

@@ -0,0 +1,4 @@
+
+streamlit
+requests
+pandas

agent_assembler-0.2.0.dev1/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

agent_assembler-0.2.0.dev1/src/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-0.2.0.dev1/src/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-0.2.0.dev1/src/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-0.2.0.dev1/src/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-0.2.0.dev1/src/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-0.2.0.dev1/src/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-0.2.0.dev1/src/agent_assembler/deploy/__init__.py

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

agent_assembler-0.2.0.dev1/src/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-0.2.0.dev1/src/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-0.2.0.dev1/src/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.dev1/src/agent_assembler.egg-info/PKG-INFO

@@ -0,0 +1,51 @@
+Metadata-Version: 2.4
+Name: agent-assembler
+Version: 0.2.0.dev1
+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.dev1/src/agent_assembler.egg-info/SOURCES.txt

@@ -0,0 +1,23 @@
+LICENSE
+MANIFEST.in
+README.md
+pyproject.toml
+requirements.txt
+src/agent_assembler/__init__.py
+src/agent_assembler/assembler.py
+src/agent_assembler/recipe.py
+src/agent_assembler.egg-info/PKG-INFO
+src/agent_assembler.egg-info/SOURCES.txt
+src/agent_assembler.egg-info/dependency_links.txt
+src/agent_assembler.egg-info/requires.txt
+src/agent_assembler.egg-info/top_level.txt
+src/agent_assembler/adapters/__init__.py
+src/agent_assembler/adapters/base.py
+src/agent_assembler/adapters/coze.py
+src/agent_assembler/adapters/qianwen.py
+src/agent_assembler/deploy/__init__.py
+src/agent_assembler/deploy/coze_api.py
+src/agent_assembler/deploy/qianwen_api.py
+tests/__init__.py
+tests/test_adapters.py
+tests/test_assembler.py

agent_assembler-0.2.0.dev1/src/agent_assembler.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

agent_assembler-0.2.0.dev1/src/agent_assembler.egg-info/requires.txt

@@ -0,0 +1,3 @@
+streamlit
+requests
+pandas

agent_assembler-0.2.0.dev1/src/agent_assembler.egg-info/top_level.txt

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

agent_assembler-0.2.0.dev1/tests/test_adapters.py

@@ -0,0 +1,160 @@
+"""Tests for Agent Assembler Adapters."""
+import os
+import sys
+import tempfile
+import json
+
+sys.path.insert(0, os.path.join(os.path.dirname(os.path.dirname(os.path.abspath(__file__))), "src"))
+
+from agent_assembler.recipe import Recipe
+from agent_assembler.adapters import CozeAdapter, QianwenAdapter
+
+
+def test_coze_export_basic():
+    """Test: CozeAdapter exports valid DSL structure."""
+    recipe = Recipe(
+        name="数据分析助手",
+        trigger_keywords=["数据分析", "excel"],
+        skills=[],
+        notes="专门处理 Excel 数据分析任务"
+    )
+    
+    adapter = CozeAdapter()
+    result = adapter.export(recipe)
+    
+    assert "bot_info" in result
+    assert result["bot_info"]["name"] == "数据分析助手"
+    assert result["bot_info"]["prompt_info"]["prompt"] != ""
+    assert result["model_info"]["model_name"] == "gpt-4o"
+    assert result["metadata"]["source"] == "agent-assembler"
+    print("✅ test_coze_export_basic passed")
+
+
+def test_coze_skills_injection():
+    """Test: CozeAdapter injects skill content into prompt."""
+    with tempfile.TemporaryDirectory() as tmpdir:
+        os.makedirs(os.path.join(tmpdir, "data_clean"))
+        with open(os.path.join(tmpdir, "data_clean", "SKILL.md"), "w") as f:
+            f.write("# 数据清洗\n步骤: 1. 去重 2. 格式化 3. 校验")
+        
+        recipe = Recipe(
+            name="数据处理",
+            trigger_keywords=["数据"],
+            skills=["data_clean"]
+        )
+        
+        adapter = CozeAdapter(skills_dir=tmpdir)
+        result = adapter.export(recipe)
+        prompt = result["bot_info"]["prompt_info"]["prompt"]
+        
+        assert "数据清洗" in prompt
+        assert "去重" in prompt
+        print("✅ test_coze_skills_injection passed")
+
+
+def test_coze_validate():
+    """Test: CozeAdapter validates recipe constraints."""
+    adapter = CozeAdapter()
+    
+    # Valid recipe
+    good = Recipe(name="短名", trigger_keywords=["test"], skills=[])
+    assert len(adapter.validate(good)) == 0
+    
+    # Name too long
+    long_name = Recipe(name="A" * 51, trigger_keywords=["test"], skills=[])
+    errors = adapter.validate(long_name)
+    assert len(errors) > 0
+    assert "50" in errors[0]
+    
+    print("✅ test_coze_validate passed")
+
+
+def test_qianwen_export_basic():
+    """Test: QianwenAdapter exports valid DSL structure."""
+    recipe = Recipe(
+        name="客服助手",
+        trigger_keywords=["客服", "咨询"],
+        notes="处理客户咨询和投诉",
+        routing="operations-venue-agent"
+    )
+    
+    adapter = QianwenAdapter()
+    result = adapter.export(recipe)
+    
+    assert "name" in result
+    assert result["name"] == "客服助手"
+    assert "system_prompt" in result
+    assert result["model"] == "qwen-max"
+    assert result["metadata"]["routing"] == "operations-venue-agent"
+    print("✅ test_qianwen_export_basic passed")
+
+
+def test_qianwen_skills_injection():
+    """Test: QianwenAdapter injects skill content into prompt."""
+    with tempfile.TemporaryDirectory() as tmpdir:
+        os.makedirs(os.path.join(tmpdir, "reply_template"))
+        with open(os.path.join(tmpdir, "reply_template", "SKILL.md"), "w") as f:
+            f.write("# 回复模板\n规范: 礼貌、专业、简洁")
+        
+        recipe = Recipe(
+            name="智能客服",
+            trigger_keywords=["回复"],
+            skills=["reply_template"]
+        )
+        
+        adapter = QianwenAdapter(skills_dir=tmpdir)
+        result = adapter.export(recipe)
+        prompt = result["system_prompt"]
+        
+        assert "回复模板" in prompt
+        assert "礼貌" in prompt
+        print("✅ test_qianwen_skills_injection passed")
+
+
+def test_qianwen_validate():
+    """Test: QianwenAdapter validates recipe constraints."""
+    adapter = QianwenAdapter()
+    
+    # Valid recipe
+    good = Recipe(name="正常名", trigger_keywords=["test"], skills=[])
+    assert len(adapter.validate(good)) == 0
+    
+    # Name too long (30 char limit for Qianwen)
+    long_name = Recipe(name="A" * 31, trigger_keywords=["test"], skills=[])
+    errors = adapter.validate(long_name)
+    assert len(errors) > 0
+    assert "30" in errors[0]
+    
+    print("✅ test_qianwen_validate passed")
+
+
+def test_adapter_missing_skill_warning():
+    """Test: Adapter handles missing skill gracefully."""
+    recipe = Recipe(
+        name="测试",
+        trigger_keywords=["test"],
+        skills=["nonexistent_skill"]
+    )
+    
+    coze = CozeAdapter(skills_dir="/tmp")
+    result = coze.export(recipe)
+    assert "nonexistent_skill" in result["bot_info"]["prompt_info"]["prompt"]
+    assert "not found" in result["bot_info"]["prompt_info"]["prompt"]
+    
+    qianwen = QianwenAdapter(skills_dir="/tmp")
+    result = qianwen.export(recipe)
+    assert "nonexistent_skill" in result["system_prompt"]
+    assert "未找到" in result["system_prompt"]
+    
+    print("✅ test_adapter_missing_skill_warning passed")
+
+
+if __name__ == "__main__":
+    test_coze_export_basic()
+    test_coze_skills_injection()
+    test_coze_validate()
+    test_qianwen_export_basic()
+    test_qianwen_skills_injection()
+    test_qianwen_validate()
+    test_adapter_missing_skill_warning()
+    print("\n✅ All 7 adapter tests passed")

agent_assembler-0.2.0.dev1/tests/test_assembler.py

@@ -0,0 +1,148 @@
+"""Tests for Agent Assembler SDK."""
+import os
+import sys
+import tempfile
+import json
+
+sys.path.insert(0, os.path.join(os.path.dirname(os.path.dirname(os.path.abspath(__file__))), "src"))
+
+from agent_assembler import Assembler, Recipe
+from agent_assembler.recipe import SkillRef
+from agent_assembler.adapters.base import BaseAdapter
+
+
+def test_basic_assembly():
+    """Test: query matches recipe, skills loaded, prompt assembled."""
+    with tempfile.TemporaryDirectory() as tmpdir:
+        recipes_dir = os.path.join(tmpdir, "recipes")
+        skills_dir = os.path.join(tmpdir, "skills")
+        os.makedirs(recipes_dir)
+        os.makedirs(os.path.join(skills_dir, "skill_A"))
+
+        recipe = {
+            "name": "test_recipe",
+            "trigger_keywords": ["test", "demo"],
+            "skills": ["skill_A"]
+        }
+        with open(os.path.join(recipes_dir, "test.json"), "w") as f:
+            json.dump(recipe, f)
+
+        with open(os.path.join(skills_dir, "skill_A", "SKILL.md"), "w") as f:
+            f.write("# Skill A\nContent A")
+
+        assembler = Assembler(recipes_dir, skills_dir)
+        result = assembler.assemble("Please run a test demo")
+
+        assert result["status"] == "success", f"Status mismatch: {result['status']}"
+        assert result["recipe"] == "test_recipe"
+        assert "Content A" in result["system_prompt"]
+        print("✅ test_basic_assembly passed")
+
+
+def test_no_match_fallback():
+    """Test: query does not match any recipe → fallback."""
+    with tempfile.TemporaryDirectory() as tmpdir:
+        recipes_dir = os.path.join(tmpdir, "recipes")
+        skills_dir = os.path.join(tmpdir, "skills")
+        os.makedirs(recipes_dir)
+        os.makedirs(skills_dir)
+
+        recipe = {
+            "name": "only_recipe",
+            "trigger_keywords": ["specific"],
+            "skills": []
+        }
+        with open(os.path.join(recipes_dir, "only.json"), "w") as f:
+            json.dump(recipe, f)
+
+        assembler = Assembler(recipes_dir, skills_dir)
+        result = assembler.assemble("unrelated query")
+
+        assert result["status"] == "fallback"
+        assert "No matching recipe found" in result["message"]
+        print("✅ test_no_match_fallback passed")
+
+
+def test_missing_recipe_dir():
+    """Test: non-existent recipes directory raises FileNotFoundError."""
+    try:
+        Assembler("/nonexistent/path/12345", "/tmp")
+        assert False, "Should have raised FileNotFoundError"
+    except FileNotFoundError:
+        print("✅ test_missing_recipe_dir passed")
+
+
+def test_recipe_from_json():
+    """Test: Recipe deserialization from JSON."""
+    with tempfile.NamedTemporaryFile(mode="w", suffix=".json", delete=False) as f:
+        json.dump({
+            "name": "my_recipe",
+            "trigger_keywords": ["alpha", "beta"],
+            "skills": ["s1", "s2"],
+            "notes": "Some notes",
+            "routing": "engineering-agent"
+        }, f)
+        f.flush()
+
+        recipe = Recipe.from_json(f.name)
+        assert recipe.name == "my_recipe"
+        assert len(recipe.trigger_keywords) == 2
+        assert len(recipe.skills) == 2
+        assert recipe.notes == "Some notes"
+        assert recipe.routing == "engineering-agent"
+        print("✅ test_recipe_from_json passed")
+
+
+def test_skill_ref_load():
+    """Test: SkillRef loads content from filesystem."""
+    with tempfile.TemporaryDirectory() as tmpdir:
+        os.makedirs(os.path.join(tmpdir, "my_skill"))
+        with open(os.path.join(tmpdir, "my_skill", "SKILL.md"), "w") as f:
+            f.write("# My Skill\nBody content")
+
+        ref = SkillRef(name="my_skill")
+        assert ref.load_content(tmpdir) is True
+        assert ref.loaded is True
+        assert "Body content" in ref.content
+        print("✅ test_skill_ref_load passed")
+
+
+def test_skill_ref_missing():
+    """Test: SkillRef returns False when file does not exist."""
+    ref = SkillRef(name="nonexistent_skill")
+    assert ref.load_content("/tmp") is False
+    assert ref.loaded is False
+    print("✅ test_skill_ref_missing passed")
+
+
+def test_multiple_recipes_first_match():
+    """Test: first matching recipe is returned (deterministic)."""
+    with tempfile.TemporaryDirectory() as tmpdir:
+        recipes_dir = os.path.join(tmpdir, "recipes")
+        skills_dir = os.path.join(tmpdir, "skills")
+        os.makedirs(recipes_dir)
+        os.makedirs(skills_dir)
+
+        # Write two recipes that both match "data"
+        for name, kw in [("data_cleaner", ["data", "clean"]), ("data_viz", ["data", "chart"])]:
+            with open(os.path.join(recipes_dir, f"{name}.json"), "w") as f:
+                json.dump({"name": name, "trigger_keywords": kw, "skills": []}, f)
+
+        assembler = Assembler(recipes_dir, skills_dir)
+        result = assembler.assemble("show me data")
+
+        assert result["status"] == "success"
+        # Should match the first one found (alphabetical walk order)
+        assert result["recipe"] in ("data_cleaner", "data_viz")
+        print("✅ test_multiple_recipes_first_match passed")
+
+
+if __name__ == "__main__":
+    test_basic_assembly()
+    test_no_match_fallback()
+    test_missing_recipe_dir()
+    test_recipe_from_json()
+    test_skill_ref_load()
+    test_skill_ref_missing()
+    test_multiple_recipes_first_match()
+    print("\n✅ All 7 tests passed")