sycommon-python-lib 0.2.1a44__tar.gz → 0.2.1a46__tar.gz

{sycommon_python_lib-0.2.1a44 → sycommon_python_lib-0.2.1a46}/PKG-INFO

@@ -1,36 +1,37 @@
 Metadata-Version: 2.4
 Name: sycommon-python-lib
-Version: 0.2.1a44
+Version: 0.2.1a46
 Summary: Add your description here
 Requires-Python: >=3.11
 Description-Content-Type: text/markdown
 Requires-Dist: aio-pika>=9.6.2
-Requires-Dist: aiohttp>=3.13.3
+Requires-Dist: aiohttp>=3.13.5
 Requires-Dist: aiomysql>=0.3.2
 Requires-Dist: anyio>=4.12.1
 Requires-Dist: decorator>=5.2.1
 Requires-Dist: deepagents>=0.5.0a2
 Requires-Dist: elasticsearch>=9.3.0
-Requires-Dist: fastapi>=0.135.1
+Requires-Dist: fastapi>=0.135.3
 Requires-Dist: jinja2>=3.1.6
 Requires-Dist: kafka-python>=2.3.0
-Requires-Dist: langchain>=1.2.13
-Requires-Dist: langchain-core>=1.2.20
+Requires-Dist: langchain>=1.2.14
+Requires-Dist: langchain-core>=1.2.25
 Requires-Dist: langchain-openai>=1.1.11
-Requires-Dist: langfuse>=4.0.1
-Requires-Dist: langgraph>=1.1.3
+Requires-Dist: langfuse>=4.0.6
+Requires-Dist: langgraph>=1.1.4
 Requires-Dist: langgraph-checkpoint-redis>=0.4.0
 Requires-Dist: ldap3>=2.9.1
 Requires-Dist: loguru>=0.7.3
 Requires-Dist: mysql-connector-python>=9.6.0
-Requires-Dist: nacos-sdk-python<3.0,>=2.0.9
+Requires-Dist: nacos-sdk-python<3.0,>=2.0.11
 Requires-Dist: psutil>=7.2.2
+Requires-Dist: pyxxl>=0.4.6
 Requires-Dist: pydantic>=2.12.5
 Requires-Dist: python-dotenv>=1.2.2
 Requires-Dist: python-multipart>=0.0.22
 Requires-Dist: pyyaml>=6.0.3
 Requires-Dist: redis>=7.3.0
-Requires-Dist: sentry-sdk[fastapi]>=2.55.0
+Requires-Dist: sentry-sdk[fastapi]>=2.57.0
 Requires-Dist: sqlalchemy[asyncio]>=2.0.48
 Requires-Dist: starlette[full]>=1.0.0
 Requires-Dist: tiktoken>=0.12.0

{sycommon_python_lib-0.2.1a44 → sycommon_python_lib-0.2.1a46}/pyproject.toml

@@ -1,37 +1,38 @@
 [project]
 name = "sycommon-python-lib"
-version = "0.2.1a44"
+version = "0.2.1a46"
 description = "Add your description here"
 readme = "README.md"
 requires-python = ">=3.11"
 dependencies = [
     "aio-pika>=9.6.2",
-    "aiohttp>=3.13.3",
+    "aiohttp>=3.13.5",
     "aiomysql>=0.3.2",
     "anyio>=4.12.1",
     "decorator>=5.2.1",
     "deepagents>=0.5.0a2",
     "elasticsearch>=9.3.0",
-    "fastapi>=0.135.1",
+    "fastapi>=0.135.3",
     "jinja2>=3.1.6",
     "kafka-python>=2.3.0",
-    "langchain>=1.2.13",
-    "langchain-core>=1.2.20",
+    "langchain>=1.2.14",
+    "langchain-core>=1.2.25",
     "langchain-openai>=1.1.11",
-    "langfuse>=4.0.1",
-    "langgraph>=1.1.3",
+    "langfuse>=4.0.6",
+    "langgraph>=1.1.4",
     "langgraph-checkpoint-redis>=0.4.0",
     "ldap3>=2.9.1",
     "loguru>=0.7.3",
     "mysql-connector-python>=9.6.0",
-    "nacos-sdk-python>=2.0.9,<3.0",
+    "nacos-sdk-python>=2.0.11,<3.0",
     "psutil>=7.2.2",
+    "pyxxl>=0.4.6",
     "pydantic>=2.12.5",
     "python-dotenv>=1.2.2",
     "python-multipart>=0.0.22",
     "pyyaml>=6.0.3",
     "redis>=7.3.0",
-    "sentry-sdk[fastapi]>=2.55.0",
+    "sentry-sdk[fastapi]>=2.57.0",
     "sqlalchemy[asyncio]>=2.0.48",
     "starlette[full]>=1.0.0",
     "tiktoken>=0.12.0",
@@ -48,3 +49,4 @@ build-backend = "setuptools.build_meta"
 
 [project.scripts]
 sycommon = "command.cli:main"
+sycli = "sycli.cli:main"

sycommon_python_lib-0.2.1a46/src/sycli/__init__.py

@@ -0,0 +1,3 @@
+"""sycli - RL-based multi-agent code optimization CLI."""
+
+__version__ = "0.1.0"

sycommon_python_lib-0.2.1a46/src/sycli/__main__.py

@@ -0,0 +1,6 @@
+"""Allow running sycli as `python -m sycli`."""
+
+from sycli.cli import main
+
+if __name__ == "__main__":
+    main()

sycommon_python_lib-0.2.1a46/src/sycli/agents/__init__.py

@@ -0,0 +1 @@
+"""Agent factory for sycli."""

sycommon_python_lib-0.2.1a46/src/sycli/agents/factory.py

@@ -0,0 +1,159 @@
+"""Agent factory - builds all agents for sycli."""
+
+from __future__ import annotations
+
+from pathlib import Path
+from typing import Any, Sequence
+
+from deepagents import SubAgent
+from deepagents.backends.local_shell import LocalShellBackend
+from deepagents.middleware.memory import MemoryMiddleware
+from langchain_core.language_models import BaseChatModel
+
+from sycli.agents.prompts import (
+    ARCHITECT_PROMPT,
+    CODER_PROMPT,
+    CRITIC_PROMPT,
+    DATA_ANALYST_PROMPT,
+    ORCHESTRATOR_PROMPT,
+    PROMPT_ENGINEER_PROMPT,
+    RESEARCHER_PROMPT,
+    RUNTIME_OBSERVER_PROMPT,
+)
+from sycli.models.config_models import SycliConfig
+
+
+def _memory_middleware(
+    backend: LocalShellBackend,
+    project_name: str,
+    agent_role: str,
+) -> MemoryMiddleware:
+    """Create MemoryMiddleware with per-agent source paths.
+
+    Sources loaded in order (concatenated):
+    1. hot/context.md          - Layer 0+1: working memory
+    2. warm/agents/{role}.md   - Layer 2: agent-specific compressed
+    3. warm/strategies.md      - Layer 2: shared strategies
+    4. warm/anti_patterns.md   - Layer 2: shared anti-patterns
+    """
+    return MemoryMiddleware(
+        backend=backend,
+        sources=[
+            f".sycli/memory/{project_name}/hot/context.md",
+            f".sycli/memory/{project_name}/warm/agents/{agent_role}.md",
+            f".sycli/memory/{project_name}/warm/strategies.md",
+            f".sycli/memory/{project_name}/warm/anti_patterns.md",
+        ],
+    )
+
+
+def build_subagents(
+    config: SycliConfig,
+    llm: BaseChatModel,
+    backend: LocalShellBackend,
+    project_name: str,
+    mode: str = "optimize",
+) -> list[SubAgent]:
+    """Build SubAgent specs for all agents based on mode.
+
+    Args:
+        config: sycli configuration.
+        llm: LLM instance shared by all agents.
+        backend: LocalShellBackend shared by all agents.
+        project_name: Project name for memory paths.
+        mode: "optimize" or "create".
+
+    Returns:
+        List of SubAgent specs to pass to the orchestrator.
+    """
+    agents: list[SubAgent] = []
+
+    # --- Core agents (always available) ---
+
+    agents.append({
+        "name": "researcher",
+        "description": (
+            "Explores the codebase to understand structure, find relevant files, "
+            "analyze dependencies and patterns. Use FIRST before coding."
+        ),
+        "system_prompt": RESEARCHER_PROMPT,
+        "model": llm,
+        "middleware": [_memory_middleware(backend, project_name, "researcher")],
+    })
+
+    agents.append({
+        "name": "coder",
+        "description": (
+            "Writes and modifies code, generates test cases. "
+            "The ONLY agent with write/edit capabilities. "
+            "Auto-fixes compilation errors before reporting."
+        ),
+        "system_prompt": CODER_PROMPT,
+        "model": llm,
+        "middleware": [_memory_middleware(backend, project_name, "coder")],
+    })
+
+    agents.append({
+        "name": "critic",
+        "description": (
+            "Evaluates code changes by running tests and static analysis. "
+            "Read + execute access, no write. "
+            "Produces a structured evaluation report."
+        ),
+        "system_prompt": CRITIC_PROMPT,
+        "model": llm,
+        "middleware": [_memory_middleware(backend, project_name, "critic")],
+    })
+
+    agents.append({
+        "name": "runtime_observer",
+        "description": (
+            "Starts the project, monitors runtime behavior, collects metrics. "
+            "Read + execute access, no write. "
+            "Produces a runtime validation report."
+        ),
+        "system_prompt": RUNTIME_OBSERVER_PROMPT,
+        "model": llm,
+        "middleware": [_memory_middleware(backend, project_name, "runtime_observer")],
+    })
+
+    agents.append({
+        "name": "prompt_engineer",
+        "description": (
+            "Optimizes the strategy based on evaluation results. "
+            "Read-only. Only called when a round scores below threshold. "
+            "Produces actionable optimization suggestions."
+        ),
+        "system_prompt": PROMPT_ENGINEER_PROMPT,
+        "model": llm,
+        "middleware": [_memory_middleware(backend, project_name, "prompt_engineer")],
+    })
+
+    # --- CREATE mode only ---
+
+    if mode == "create":
+        agents.append({
+            "name": "architect",
+            "description": (
+                "Designs project architecture from scratch. "
+                "CREATE mode only. Read-only. "
+                "Produces a complete architecture blueprint."
+            ),
+            "system_prompt": ARCHITECT_PROMPT,
+            "model": llm,
+            "middleware": [_memory_middleware(backend, project_name, "architect")],
+        })
+
+        agents.append({
+            "name": "data_analyst",
+            "description": (
+                "Analyzes datasets to infer schemas, types, and relationships. "
+                "CREATE mode only. Read + execute. "
+                "Produces a data analysis report with seed data."
+            ),
+            "system_prompt": DATA_ANALYST_PROMPT,
+            "model": llm,
+            "middleware": [_memory_middleware(backend, project_name, "data_analyst")],
+        })
+
+    return agents

sycommon_python_lib-0.2.1a46/src/sycli/agents/prompts.py

@@ -0,0 +1,228 @@
+"""System prompts for all sycli agents."""
+
+# ── Orchestrator ──────────────────────────────────────────────
+
+ORCHESTRATOR_PROMPT = """You are the Orchestrator Agent of the sycli RL optimization system.
+
+Your role is to coordinate a team of specialized agents to complete a code task.
+You dispatch work via the `task` tool to the appropriate sub-agent.
+
+## Available Agents
+
+- **researcher**: Explores the codebase, finds relevant files, analyzes architecture.
+  Use FIRST before any coding to understand the project context.
+
+- **coder**: Writes and modifies code. Also generates test cases.
+  The ONLY agent with write/edit capabilities. Auto-fixes compilation errors.
+
+- **critic**: Evaluates code changes by running tests and static analysis.
+  Read + execute, CANNOT write. Produces evaluation report.
+
+- **runtime_observer**: Starts the project, monitors runtime behavior.
+  Read + execute, CANNOT write. Validates runtime correctness.
+
+- **prompt_engineer**: Optimizes strategy based on evaluation results.
+  Read-only. Called when round scores below threshold.
+
+## Workflow
+
+For each round:
+1. Dispatch **researcher** to understand current state
+2. Dispatch **coder** to make changes + generate tests
+3. Dispatch **critic** to evaluate
+4. Dispatch **runtime_observer** to validate runtime
+5. If score < threshold → dispatch **prompt_engineer** to refine strategy
+
+## Output
+
+At the end of each round, report in this EXACT format:
+
+```
+ROUND_COMPLETE:
+  test_result: {passed}/{total}
+  score: {accuracy}
+  decision: ACCEPT|RETRY|ROLLBACK
+```
+
+Where:
+- test_result: number of tests passed out of total
+- score: accuracy from 0.0 to 1.0
+- decision: ACCEPT if score >= threshold, RETRY if can improve, ROLLBACK if regression detected
+"""
+
+# ── Researcher ────────────────────────────────────────────────
+
+RESEARCHER_PROMPT = """You are the Researcher Agent. Your job is to explore the codebase and provide context.
+
+## Rules
+- You are READ-ONLY. Never modify any files.
+- Use ls, read_file, glob, grep to explore.
+- Be thorough but efficient. Target < 10 tool calls.
+
+## Output Format
+
+Return a structured context report:
+
+```
+CONTEXT_REPORT:
+  project_type: {web|agent|cli|library}
+  entry_point: {main file path}
+  relevant_files:
+    - {path}: {brief description}
+  dependencies: {key dependency relationships}
+  patterns: {coding patterns/conventions observed}
+  suggestions: {what the coder should focus on}
+```
+"""
+
+# ── Coder ─────────────────────────────────────────────────────
+
+CODER_PROMPT = """You are the Coder Agent. Your job is to modify code and generate tests.
+
+## Rules
+- You are the ONLY agent that can write/edit files.
+- ALWAYS generate corresponding test files when modifying code (TDD approach).
+- Make MINIMAL changes - only modify what is necessary.
+- After writing code, run syntax check to verify.
+- If syntax check fails, auto-fix and retry (up to 5 times).
+- Follow the project's existing code style and conventions.
+
+## Auto-Fix Loop
+Before reporting completion, verify your code:
+1. Run syntax check: python -c 'import <module>'
+2. If fails → fix the error → retry (max 5 times)
+3. Only report completion when syntax passes
+
+## Output
+
+At the end, report:
+```
+CODE_RESULT:
+  files_modified:
+    - {path}: {what changed}
+  tests_created:
+    - {path}: {what it tests}
+  syntax_verified: true
+```
+"""
+
+# ── Critic ────────────────────────────────────────────────────
+
+CRITIC_PROMPT = """You are the Critic Agent (Test Engineer). Your job is to evaluate code changes.
+
+## Rules
+- You have READ + EXECUTE access. You CANNOT write files.
+- Run the project's test suite to evaluate changes.
+- Be objective and thorough.
+
+## Evaluation Steps
+1. Run existing tests: pytest tests/ -v (or project test command)
+2. Check for import/syntax errors
+3. Count: passed, failed, errors
+4. Identify any NEW failures (regressions)
+
+## Output
+
+Report in this format:
+```
+EVALUATION:
+  tests_passed: {count}
+  tests_failed: {count}
+  tests_total: {count}
+  regressions: {count}
+  score: {passed}/{total}
+```
+"""
+
+# ── RuntimeObserver ───────────────────────────────────────────
+
+RUNTIME_OBSERVER_PROMPT = """You are the RuntimeObserver Agent. Your job is to validate runtime behavior.
+
+## Rules
+- You have READ + EXECUTE access. You CANNOT write files.
+- Start the project and monitor its behavior.
+- Collect runtime metrics.
+
+## Steps
+1. Start the project (background process)
+2. Wait for health check
+3. Send probe requests to key endpoints
+4. Check logs for errors
+5. Stop the project when done
+
+## Output
+
+```
+RUNTIME_REPORT:
+  startup: SUCCESS|FAILURE
+  health_check: PASS|FAIL
+  endpoints_tested:
+    - {method} {path}: {status}
+  new_errors: {count}
+  runtime_ok: true|false
+```
+"""
+
+# ── PromptEngineer ────────────────────────────────────────────
+
+PROMPT_ENGINEER_PROMPT = """You are the PromptEngineer Agent. Optimize strategy based on evaluation results.
+
+## Rules
+- You are READ-ONLY. Never modify any files.
+- Analyze the evaluation results from the current round.
+- Generate specific, actionable optimization suggestions.
+
+## Output
+
+```
+STRATEGY_UPDATE:
+  analysis: {what went wrong/right}
+  root_cause: {identified issue}
+  suggestions:
+    - {specific change to make}
+```
+"""
+
+# ── Architect (CREATE mode only) ─────────────────────────────
+
+ARCHITECT_PROMPT = """You are the Architect Agent. Design project architecture from scratch.
+
+## Rules
+- You are READ-ONLY. Never modify any files.
+- Design the complete project structure before any coding.
+- Consider the user's description, data analysis, and test cases.
+
+## Output
+
+```
+BLUEPRINT:
+  project_name: {name}
+  project_type: {web|agent|cli}
+  tech_stack: {framework, database, cache}
+  structure: {directory tree with descriptions}
+  data_models: {model definitions}
+  endpoints: {API endpoint list}
+  test_plan: {verification plan}
+```
+"""
+
+# ── DataAnalyst (CREATE mode only) ────────────────────────────
+
+DATA_ANALYST_PROMPT = """You are the DataAnalyst Agent. Analyze datasets and infer data structures.
+
+## Rules
+- You have READ + EXECUTE access for running analysis scripts.
+- Analyze data files to infer schemas, types, and relationships.
+
+## Output
+
+```
+DATA_ANALYSIS:
+  files:
+    - file: {name}
+      rows: {count}
+      columns: {name: type}
+  relations: {foreign key relationships}
+  seed_data: {sample rows for testing}
+```
+"""