skilllite 0.1.0__tar.gz → 0.1.2__tar.gz

{skilllite-0.1.0/skilllite.egg-info → skilllite-0.1.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: skilllite
-Version: 0.1.0
+Version: 0.1.2
 Summary: A lightweight Skills execution engine with LLM integration for LLM agents
 Author-email: SkillLite Team <skilllite@example.com>
 License: MIT
@@ -32,10 +32,16 @@ Provides-Extra: anthropic
 Requires-Dist: anthropic>=0.18.0; extra == "anthropic"
 Provides-Extra: mcp
 Requires-Dist: mcp>=1.0.0; extra == "mcp"
+Provides-Extra: langchain
+Requires-Dist: langchain-core>=0.1.0; extra == "langchain"
+Provides-Extra: llamaindex
+Requires-Dist: llama-index-core>=0.10.0; extra == "llamaindex"
 Provides-Extra: all
 Requires-Dist: openai>=1.0.0; extra == "all"
 Requires-Dist: anthropic>=0.18.0; extra == "all"
 Requires-Dist: mcp>=1.0.0; extra == "all"
+Requires-Dist: langchain-core>=0.1.0; extra == "all"
+Requires-Dist: llama-index-core>=0.10.0; extra == "all"
 Provides-Extra: dev
 Requires-Dist: pytest>=7.0; extra == "dev"
 Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"
@@ -288,6 +294,150 @@ Enum for LLM provider formats:
 - `ToolFormat.CLAUDE`
 - `ToolFormat.OPENAI`
 
+## Framework Adapters
+
+SkillLite provides adapters for popular AI frameworks with security confirmation support.
+
+### LangChain Integration
+
+For LangChain/LangGraph integration, we recommend using the dedicated **[langchain-skilllite](https://pypi.org/project/langchain-skilllite/)** package:
+
+```bash
+pip install langchain-skilllite
+```
+
+```python
+from langchain_skilllite import SkillLiteToolkit
+from langchain_openai import ChatOpenAI
+from langgraph.prebuilt import create_react_agent
+
+# Load all skills from a directory as LangChain tools
+tools = SkillLiteToolkit.from_directory("./skills")
+
+# Create a LangGraph agent
+agent = create_react_agent(ChatOpenAI(model="gpt-4"), tools)
+
+# Run the agent
+result = agent.invoke({
+    "messages": [("user", "Convert 'hello world' to uppercase")]
+})
+```
+
+With security confirmation (sandbox_level=3):
+
+```python
+def confirm_execution(report: str, scan_id: str) -> bool:
+    print(report)
+    return input("Continue? [y/N]: ").lower() == 'y'
+
+tools = SkillLiteToolkit.from_directory(
+    "./skills",
+    sandbox_level=3,  # 1=no sandbox, 2=sandbox only, 3=sandbox+scan
+    confirmation_callback=confirm_execution
+)
+```
+
+For more details, see the [langchain-skilllite documentation](../langchain-skilllite/README.md).
+
+**Alternative**: You can also use the built-in adapter:
+
+```python
+from skilllite import SkillManager
+from skilllite.core.adapters.langchain import SkillLiteToolkit
+
+manager = SkillManager(skills_dir="./skills")
+tools = SkillLiteToolkit.from_manager(manager).get_tools()
+```
+
+### LlamaIndex Integration
+
+```python
+from skilllite import SkillManager
+from skilllite.core.adapters.llamaindex import SkillLiteToolSpec
+
+manager = SkillManager(skills_dir="./skills")
+
+# Basic usage
+tool_spec = SkillLiteToolSpec.from_manager(manager)
+tools = tool_spec.to_tool_list()
+
+# With security confirmation
+def confirm(report: str, scan_id: str) -> bool:
+    print(report)
+    return input("Continue? [y/N]: ").lower() == 'y'
+
+tool_spec = SkillLiteToolSpec.from_manager(
+    manager,
+    sandbox_level=3,
+    confirmation_callback=confirm
+)
+
+# Use with LlamaIndex agent
+from llama_index.core.agent import ReActAgent
+agent = ReActAgent.from_tools(tools, llm=llm)
+```
+
+### Security Levels
+
+| Level | Description |
+|-------|-------------|
+| 1 | No sandbox - direct execution |
+| 2 | Sandbox isolation only |
+| 3 | Sandbox + static security scan (requires confirmation for high-severity issues) |
+
+## OpenCode Integration
+
+SkillLite can be integrated with [OpenCode](https://github.com/opencode-ai/opencode) as an MCP (Model Context Protocol) server, providing secure sandbox execution capabilities.
+
+### Quick Setup
+
+```bash
+# Install with MCP support
+pip install skilllite[mcp]
+
+# One-command setup for OpenCode
+skilllite init-opencode
+
+# Start OpenCode
+opencode
+```
+
+The `init-opencode` command automatically:
+- Detects the best way to start the MCP server (uvx, pipx, skilllite, or python)
+- Creates `opencode.json` with optimal configuration
+- Generates `.opencode/skills/skilllite/SKILL.md` with usage instructions
+- Discovers your pre-defined skills
+
+### Available MCP Tools
+
+| Tool | Description |
+|------|-------------|
+| `skilllite_list_skills` | List all available skills |
+| `skilllite_get_skill_info` | Get skill details and input schema |
+| `skilllite_run_skill` | Execute a pre-defined skill |
+| `skilllite_scan_code` | Scan code for security issues |
+| `skilllite_execute_code` | Execute code in secure sandbox |
+
+### Security Features
+
+- **System-level Sandbox**: macOS Seatbelt / Linux Namespace isolation
+- **Security Scanning**: Static analysis before execution
+- **User Confirmation**: Dangerous code requires explicit approval
+- **Scan ID Verification**: Prevents code modification between scan and execution
+
+For detailed documentation, see [OpenCode Integration Tutorial](../tutorials/07_opencode_integration/README.md).
+
+## CLI Commands
+
+```bash
+skilllite install        # Install skillbox sandbox binary
+skilllite uninstall      # Remove skillbox binary
+skilllite status         # Show installation status
+skilllite version        # Show version information
+skilllite mcp            # Start MCP server
+skilllite init-opencode  # Initialize OpenCode integration
+```
+
 ## License
 
 MIT License

{skilllite-0.1.0 → skilllite-0.1.2}/README.md

@@ -242,6 +242,150 @@ Enum for LLM provider formats:
 - `ToolFormat.CLAUDE`
 - `ToolFormat.OPENAI`
 
+## Framework Adapters
+
+SkillLite provides adapters for popular AI frameworks with security confirmation support.
+
+### LangChain Integration
+
+For LangChain/LangGraph integration, we recommend using the dedicated **[langchain-skilllite](https://pypi.org/project/langchain-skilllite/)** package:
+
+```bash
+pip install langchain-skilllite
+```
+
+```python
+from langchain_skilllite import SkillLiteToolkit
+from langchain_openai import ChatOpenAI
+from langgraph.prebuilt import create_react_agent
+
+# Load all skills from a directory as LangChain tools
+tools = SkillLiteToolkit.from_directory("./skills")
+
+# Create a LangGraph agent
+agent = create_react_agent(ChatOpenAI(model="gpt-4"), tools)
+
+# Run the agent
+result = agent.invoke({
+    "messages": [("user", "Convert 'hello world' to uppercase")]
+})
+```
+
+With security confirmation (sandbox_level=3):
+
+```python
+def confirm_execution(report: str, scan_id: str) -> bool:
+    print(report)
+    return input("Continue? [y/N]: ").lower() == 'y'
+
+tools = SkillLiteToolkit.from_directory(
+    "./skills",
+    sandbox_level=3,  # 1=no sandbox, 2=sandbox only, 3=sandbox+scan
+    confirmation_callback=confirm_execution
+)
+```
+
+For more details, see the [langchain-skilllite documentation](../langchain-skilllite/README.md).
+
+**Alternative**: You can also use the built-in adapter:
+
+```python
+from skilllite import SkillManager
+from skilllite.core.adapters.langchain import SkillLiteToolkit
+
+manager = SkillManager(skills_dir="./skills")
+tools = SkillLiteToolkit.from_manager(manager).get_tools()
+```
+
+### LlamaIndex Integration
+
+```python
+from skilllite import SkillManager
+from skilllite.core.adapters.llamaindex import SkillLiteToolSpec
+
+manager = SkillManager(skills_dir="./skills")
+
+# Basic usage
+tool_spec = SkillLiteToolSpec.from_manager(manager)
+tools = tool_spec.to_tool_list()
+
+# With security confirmation
+def confirm(report: str, scan_id: str) -> bool:
+    print(report)
+    return input("Continue? [y/N]: ").lower() == 'y'
+
+tool_spec = SkillLiteToolSpec.from_manager(
+    manager,
+    sandbox_level=3,
+    confirmation_callback=confirm
+)
+
+# Use with LlamaIndex agent
+from llama_index.core.agent import ReActAgent
+agent = ReActAgent.from_tools(tools, llm=llm)
+```
+
+### Security Levels
+
+| Level | Description |
+|-------|-------------|
+| 1 | No sandbox - direct execution |
+| 2 | Sandbox isolation only |
+| 3 | Sandbox + static security scan (requires confirmation for high-severity issues) |
+
+## OpenCode Integration
+
+SkillLite can be integrated with [OpenCode](https://github.com/opencode-ai/opencode) as an MCP (Model Context Protocol) server, providing secure sandbox execution capabilities.
+
+### Quick Setup
+
+```bash
+# Install with MCP support
+pip install skilllite[mcp]
+
+# One-command setup for OpenCode
+skilllite init-opencode
+
+# Start OpenCode
+opencode
+```
+
+The `init-opencode` command automatically:
+- Detects the best way to start the MCP server (uvx, pipx, skilllite, or python)
+- Creates `opencode.json` with optimal configuration
+- Generates `.opencode/skills/skilllite/SKILL.md` with usage instructions
+- Discovers your pre-defined skills
+
+### Available MCP Tools
+
+| Tool | Description |
+|------|-------------|
+| `skilllite_list_skills` | List all available skills |
+| `skilllite_get_skill_info` | Get skill details and input schema |
+| `skilllite_run_skill` | Execute a pre-defined skill |
+| `skilllite_scan_code` | Scan code for security issues |
+| `skilllite_execute_code` | Execute code in secure sandbox |
+
+### Security Features
+
+- **System-level Sandbox**: macOS Seatbelt / Linux Namespace isolation
+- **Security Scanning**: Static analysis before execution
+- **User Confirmation**: Dangerous code requires explicit approval
+- **Scan ID Verification**: Prevents code modification between scan and execution
+
+For detailed documentation, see [OpenCode Integration Tutorial](../tutorials/07_opencode_integration/README.md).
+
+## CLI Commands
+
+```bash
+skilllite install        # Install skillbox sandbox binary
+skilllite uninstall      # Remove skillbox binary
+skilllite status         # Show installation status
+skilllite version        # Show version information
+skilllite mcp            # Start MCP server
+skilllite init-opencode  # Initialize OpenCode integration
+```
+
 ## License
 
 MIT License

{skilllite-0.1.0 → skilllite-0.1.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "skilllite"
-version = "0.1.0"
+version = "0.1.2"
 description = "A lightweight Skills execution engine with LLM integration for LLM agents"
 readme = "README.md"
 license = {text = "MIT"}
@@ -36,10 +36,14 @@ dependencies = [
 openai = ["openai>=1.0.0"]
 anthropic = ["anthropic>=0.18.0"]
 mcp = ["mcp>=1.0.0"]
+langchain = ["langchain-core>=0.1.0"]
+llamaindex = ["llama-index-core>=0.10.0"]
 all = [
     "openai>=1.0.0",
     "anthropic>=0.18.0",
     "mcp>=1.0.0",
+    "langchain-core>=0.1.0",
+    "llama-index-core>=0.10.0",
 ]
 dev = [
     "pytest>=7.0",

{skilllite-0.1.0 → skilllite-0.1.2}/skilllite/__init__.py

@@ -113,7 +113,7 @@ try:
 except ImportError:
     MCP_AVAILABLE = False
 
-__version__ = "0.1.0"
+__version__ = "0.1.1"
 __all__ = [
     # Core
     "SkillManager",

skilllite-0.1.2/skilllite/cli/__init__.py

@@ -0,0 +1,19 @@
+"""
+Command-line interface for skilllite.
+
+Provides commands for managing the skillbox binary, similar to
+how Playwright provides `playwright install` for browser management.
+
+Usage:
+    skilllite install       # Download and install the sandbox binary
+    skilllite uninstall     # Remove the installed binary
+    skilllite status        # Show installation status
+    skilllite version       # Show version information
+    skilllite mcp           # Start MCP server
+    skilllite init-opencode # Initialize OpenCode integration
+"""
+
+from .main import main, create_parser
+
+__all__ = ["main", "create_parser"]
+

skilllite-0.1.2/skilllite/cli/__main__.py

@@ -0,0 +1,10 @@
+"""
+Allow running the CLI as a module: python -m skilllite.cli
+"""
+
+import sys
+from .main import main
+
+if __name__ == "__main__":
+    sys.exit(main())
+

skilllite-0.1.2/skilllite/cli/binary.py

@@ -0,0 +1,93 @@
+"""
+Binary management commands for skilllite CLI.
+
+Commands: install, uninstall, status, version
+"""
+
+import argparse
+import sys
+
+from .. import __version__
+from ..sandbox.skillbox import (
+    BINARY_VERSION,
+    get_platform,
+    install,
+    is_installed,
+    get_installed_version,
+    uninstall,
+)
+
+
+def print_status() -> None:
+    """Print installation status."""
+    from ..sandbox.skillbox import find_binary, get_binary_path
+
+    print("SkillLite Installation Status")
+    print("=" * 40)
+
+    if is_installed():
+        version = get_installed_version()
+        print(f"✓ skillbox is installed (v{version})")
+        print(f"  Location: {get_binary_path()}")
+    else:
+        binary = find_binary()
+        if binary:
+            print(f"✓ skillbox found at: {binary}")
+        else:
+            print("✗ skillbox is not installed")
+            print("  Install with: skilllite install")
+
+
+def cmd_install(args: argparse.Namespace) -> int:
+    """Install the skillbox binary."""
+    try:
+        install(
+            version=args.version,
+            force=args.force,
+            show_progress=not args.quiet
+        )
+        return 0
+    except Exception as e:
+        print(f"Error: {e}", file=sys.stderr)
+        return 1
+
+
+def cmd_uninstall(args: argparse.Namespace) -> int:
+    """Uninstall the skillbox binary."""
+    try:
+        uninstall()
+        return 0
+    except Exception as e:
+        print(f"Error: {e}", file=sys.stderr)
+        return 1
+
+
+def cmd_status(args: argparse.Namespace) -> int:
+    """Show installation status."""
+    try:
+        print_status()
+        return 0
+    except Exception as e:
+        print(f"Error: {e}", file=sys.stderr)
+        return 1
+
+
+def cmd_version(args: argparse.Namespace) -> int:
+    """Show version information."""
+    print(f"skilllite Python SDK: v{__version__}")
+    print(f"skillbox binary (bundled): v{BINARY_VERSION}")
+
+    installed_version = get_installed_version()
+    if installed_version:
+        print(f"skillbox binary (installed): v{installed_version}")
+    else:
+        print("skillbox binary (installed): not installed")
+
+    try:
+        plat = get_platform()
+        print(f"Platform: {plat}")
+    except RuntimeError as e:
+        print(f"Platform: {e}")
+
+    return 0
+

skilllite-0.1.2/skilllite/cli/integrations/__init__.py

@@ -0,0 +1,8 @@
+"""
+CLI integrations for external tools.
+"""
+
+from .opencode import cmd_init_opencode
+
+__all__ = ["cmd_init_opencode"]
+