bashkit 0.9.0__cp313-cp313-pyemscripten_2025_0_wasm32.whl

bashkit/__init__.py

@@ -0,0 +1,73 @@
+"""
+Bashkit — a sandboxed bash interpreter for AI agents.
+
+Core interpreter (``Bash``)::
+
+    >>> from bashkit import Bash
+    >>> bash = Bash(timeout_seconds=30)
+    >>> result = bash.execute_sync("echo 'Hello, World!'")
+    >>> print(result.stdout)
+    Hello, World!
+
+LLM tool wrapper with schema and system prompt (``BashTool``)::
+
+    >>> from bashkit import BashTool
+    >>> tool = BashTool()
+    >>> result = tool.execute_sync("echo 'Hello, World!'")
+    >>> print(result.stdout)
+    Hello, World!
+    >>> print(tool.input_schema())   # JSON Schema for LLM function calling
+
+Multi-tool orchestration (``ScriptedTool``)::
+
+    >>> from bashkit import ScriptedTool
+    >>> tool = ScriptedTool("api")
+    >>> tool.add_tool("greet", "Greet user",
+    ...     callback=lambda p, s=None: f"hello {p.get('name', 'world')}\\n")
+    >>> result = tool.execute_sync("greet --name Alice")
+    >>> print(result.stdout.strip())
+    hello Alice
+
+Direct VFS access (``FileSystem``)::
+
+    >>> from bashkit import FileSystem
+    >>> fs = FileSystem()
+    >>> fs.write_file("/data.txt", b"content")
+    >>> fs.read_file("/data.txt")
+    b'content'
+
+Framework integrations::
+
+    >>> from bashkit.langchain import create_bash_tool, create_scripted_tool
+    >>> from bashkit.pydantic_ai import create_bash_tool
+    >>> from bashkit.deepagents import create_bashkit_backend
+"""
+
+from bashkit._bashkit import (
+    Bash,
+    BashError,
+    BashTool,
+    BuiltinContext,
+    BuiltinResult,
+    ExecResult,
+    FileSystem,
+    ScriptedTool,
+    ShellState,
+    create_langchain_tool_spec,
+    get_version,
+)
+
+__version__ = "0.1.2"
+__all__ = [
+    "Bash",
+    "BashError",
+    "BuiltinContext",
+    "BuiltinResult",
+    "BashTool",
+    "ExecResult",
+    "FileSystem",
+    "ShellState",
+    "ScriptedTool",
+    "create_langchain_tool_spec",
+    "get_version",
+]