toolnexus 0.1.1__py3-none-any.whl

toolnexus/__init__.py

@@ -0,0 +1,96 @@
+"""toolnexus — provider-agnostic toolkit: dynamic MCP servers + agent skills.
+
+Mirrors the JS reference implementation (``js/src/``); shared contract in
+``SPEC.md``.
+"""
+from __future__ import annotations
+
+from .adapters import to_anthropic, to_gemini, to_openai
+from .client import (
+    Client,
+    ClientStyle,
+    Conversation,
+    Hooks,
+    RunCancelled,
+    RunResult,
+    RunTimeout,
+    create_client,
+)
+from .http import DEFAULT_TIMEOUT as HTTP_DEFAULT_TIMEOUT
+from .http import http_tool
+from .native import define_tool, tool
+from .mcp_source import (
+    DEFAULT_TIMEOUT,
+    McpConfig,
+    McpSource,
+    ServerConfig,
+    expand_env_headers,
+    is_enabled,
+    is_remote,
+    load_mcp,
+    parse_mcp_config,
+)
+from .skill import (
+    SKILL_TOOL_DESCRIPTION,
+    SkillInfo,
+    SkillSource,
+    load_skills,
+)
+from .toolkit import Toolkit, create_toolkit
+from .types import (
+    JSONSchema,
+    McpStatus,
+    Tool,
+    ToolContext,
+    ToolResult,
+    ToolSource,
+    sanitize,
+)
+
+__all__ = [
+    # types
+    "JSONSchema",
+    "McpStatus",
+    "Tool",
+    "ToolContext",
+    "ToolResult",
+    "ToolSource",
+    "sanitize",
+    # mcp
+    "DEFAULT_TIMEOUT",
+    "McpConfig",
+    "McpSource",
+    "ServerConfig",
+    "expand_env_headers",
+    "is_enabled",
+    "is_remote",
+    "load_mcp",
+    "parse_mcp_config",
+    # skill
+    "SKILL_TOOL_DESCRIPTION",
+    "SkillInfo",
+    "SkillSource",
+    "load_skills",
+    # adapters
+    "to_anthropic",
+    "to_gemini",
+    "to_openai",
+    # toolkit
+    "Toolkit",
+    "create_toolkit",
+    # native tools
+    "tool",
+    "define_tool",
+    # http tools
+    "http_tool",
+    "HTTP_DEFAULT_TIMEOUT",
+    # unified client
+    "Client",
+    "ClientStyle",
+    "Conversation",
+    "Hooks",
+    "RunCancelled",
+    "RunResult",
+    "RunTimeout",
+    "create_client",
+]

toolnexus/adapters.py

@@ -0,0 +1,51 @@
+"""Provider adapters — turn the uniform tool list into each LLM's tool schema.
+
+Execution is identical for every provider: read the tool name + args the model
+returned, call ``toolkit.execute(name, args)``, feed ``output`` back.
+Mirrors the JS reference (``js/src/adapters.ts``) and SPEC §4.
+"""
+from __future__ import annotations
+
+from typing import Any
+
+from .types import Tool
+
+
+def to_openai(tools: list[Tool]) -> list[dict[str, Any]]:
+    return [
+        {
+            "type": "function",
+            "function": {
+                "name": t.name,
+                "description": t.description,
+                "parameters": t.input_schema,
+            },
+        }
+        for t in tools
+    ]
+
+
+def to_anthropic(tools: list[Tool]) -> list[dict[str, Any]]:
+    return [
+        {
+            "name": t.name,
+            "description": t.description,
+            "input_schema": t.input_schema,
+        }
+        for t in tools
+    ]
+
+
+def to_gemini(tools: list[Tool]) -> list[dict[str, Any]]:
+    return [
+        {
+            "functionDeclarations": [
+                {
+                    "name": t.name,
+                    "description": t.description,
+                    "parameters": t.input_schema,
+                }
+                for t in tools
+            ]
+        }
+    ]