langchain-callin 0.1.0__tar.gz

langchain_callin-0.1.0/.gitignore

@@ -0,0 +1,5 @@
+__pycache__/
+*.pyc
+dist/
+node_modules/
+.env

langchain_callin-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Replacing Humans LLC (Callin.io)
+
+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.

langchain_callin-0.1.0/PKG-INFO

@@ -0,0 +1,50 @@
+Metadata-Version: 2.5
+Name: langchain-callin
+Version: 0.1.0
+Summary: LangChain integration for Callin.io: let your agent place real phone calls with an AI voice agent and read the summary and transcript.
+Project-URL: Homepage, https://callin.io
+Project-URL: Documentation, https://github.com/callin-io/callin-agents/tree/main/python-langchain
+Project-URL: Source, https://github.com/callin-io/callin-agents
+Author-email: "Callin.io" <hello@callin.io>
+License: MIT
+License-File: LICENSE
+Keywords: ai agents,callin,langchain,phone calls,telephony,voice ai
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Communications :: Telephony
+Requires-Python: >=3.9
+Requires-Dist: callin>=0.1.0
+Requires-Dist: langchain-core>=0.2
+Description-Content-Type: text/markdown
+
+# langchain-callin
+
+LangChain integration for [Callin.io](https://callin.io): give your agent a real phone line.
+The agent places a call with an AI voice agent that pursues an objective (book a table,
+confirm an appointment, ask a supplier for a quote), then reads the summary and transcript.
+
+```bash
+pip install langchain-callin
+export CALLIN_API_KEY=...      # app.callin.io > Settings > API
+export CALLIN_AGENT_ID=...     # the outbound voice agent that makes the calls
+```
+
+```python
+from langchain_callin import CallinToolkit
+
+tools = CallinToolkit().get_tools()
+# callin_place_call, callin_get_call_result, callin_list_recent_calls
+```
+
+Or a single tool:
+
+```python
+from langchain_callin import CallinPlaceCall
+CallinPlaceCall().invoke({"to": "+390111234567", "objective": "Book a table for 2 tomorrow at 20:30 under the name Rossi", "language": "it"})
+```
+
+Calls are asynchronous: `callin_place_call` returns a `campaign_id`, then `callin_get_call_result`
+returns status, summary and transcript once the call ends. The voice agent always tells the
+person it is an AI assistant. Use it only for calls the person would expect (no cold calling).
+
+Built on the [`callin`](https://pypi.org/project/callin/) Python SDK. MIT license.

langchain_callin-0.1.0/README.md

@@ -0,0 +1,31 @@
+# langchain-callin
+
+LangChain integration for [Callin.io](https://callin.io): give your agent a real phone line.
+The agent places a call with an AI voice agent that pursues an objective (book a table,
+confirm an appointment, ask a supplier for a quote), then reads the summary and transcript.
+
+```bash
+pip install langchain-callin
+export CALLIN_API_KEY=...      # app.callin.io > Settings > API
+export CALLIN_AGENT_ID=...     # the outbound voice agent that makes the calls
+```
+
+```python
+from langchain_callin import CallinToolkit
+
+tools = CallinToolkit().get_tools()
+# callin_place_call, callin_get_call_result, callin_list_recent_calls
+```
+
+Or a single tool:
+
+```python
+from langchain_callin import CallinPlaceCall
+CallinPlaceCall().invoke({"to": "+390111234567", "objective": "Book a table for 2 tomorrow at 20:30 under the name Rossi", "language": "it"})
+```
+
+Calls are asynchronous: `callin_place_call` returns a `campaign_id`, then `callin_get_call_result`
+returns status, summary and transcript once the call ends. The voice agent always tells the
+person it is an AI assistant. Use it only for calls the person would expect (no cold calling).
+
+Built on the [`callin`](https://pypi.org/project/callin/) Python SDK. MIT license.

langchain_callin-0.1.0/pyproject.toml

@@ -0,0 +1,23 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "langchain-callin"
+version = "0.1.0"
+description = "LangChain integration for Callin.io: let your agent place real phone calls with an AI voice agent and read the summary and transcript."
+readme = "README.md"
+requires-python = ">=3.9"
+license = { text = "MIT" }
+authors = [{ name = "Callin.io", email = "hello@callin.io" }]
+keywords = ["langchain", "ai agents", "phone calls", "voice ai", "telephony", "callin"]
+dependencies = ["callin>=0.1.0", "langchain-core>=0.2"]
+classifiers = ["Programming Language :: Python :: 3", "License :: OSI Approved :: MIT License", "Topic :: Communications :: Telephony"]
+
+[project.urls]
+Homepage = "https://callin.io"
+Documentation = "https://github.com/callin-io/callin-agents/tree/main/python-langchain"
+Source = "https://github.com/callin-io/callin-agents"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/langchain_callin"]

langchain_callin-0.1.0/src/langchain_callin/__init__.py

@@ -0,0 +1,83 @@
+"""LangChain integration for Callin.io phone calls."""
+from __future__ import annotations
+
+import json
+from typing import Any, List, Optional, Type
+
+from callin import Callin
+from langchain_core.tools import BaseTool, BaseToolkit
+from pydantic import BaseModel, ConfigDict, Field
+
+__all__ = ["CallinPlaceCall", "CallinGetCallResult", "CallinListRecentCalls", "CallinToolkit"]
+
+
+class _PlaceCallInput(BaseModel):
+    to: str = Field(description="Phone number in E.164 format, e.g. +390111234567.")
+    objective: str = Field(description="What the call must achieve, e.g. 'Book a table for 2 tomorrow at 20:30 under the name Rossi'.")
+    context: str = Field(default="", description="Facts the caller may share: names, order numbers, callback number.")
+    language: str = Field(default="", description="Language code for the call, e.g. 'it', 'es', 'pt', 'en'.")
+
+
+class _CampaignInput(BaseModel):
+    campaign_id: str = Field(description="The campaign_id returned by callin_place_call.")
+
+
+class _ListInput(BaseModel):
+    limit: int = Field(default=10, description="How many recent calls to return.")
+
+
+class _CallinTool(BaseTool):
+    model_config = ConfigDict(arbitrary_types_allowed=True)
+    client: Optional[Any] = None  # a callin.Callin instance
+
+    def _c(self) -> Callin:
+        if self.client is None:
+            self.client = Callin()  # reads CALLIN_API_KEY and CALLIN_AGENT_ID
+        return self.client
+
+
+class CallinPlaceCall(_CallinTool):
+    """Place a real outbound phone call with a Callin.io AI voice agent."""
+
+    name: str = "callin_place_call"
+    description: str = (
+        "Place a real phone call with an AI voice agent that pursues an objective "
+        "(book, confirm, ask, remind). Asynchronous: returns JSON with campaign_id; "
+        "then use callin_get_call_result. The voice agent always discloses it is an AI."
+    )
+    args_schema: Type[BaseModel] = _PlaceCallInput
+
+    def _run(self, to: str, objective: str, context: str = "", language: str = "", run_manager=None) -> str:
+        return json.dumps(self._c().place_call(to=to, objective=objective, context=context, language=language).to_dict())
+
+
+class CallinGetCallResult(_CallinTool):
+    """Read status, summary and transcript of a call placed with CallinPlaceCall."""
+
+    name: str = "callin_get_call_result"
+    description: str = "Get the status of a call placed with callin_place_call and, once finished, its summary and transcript (JSON)."
+    args_schema: Type[BaseModel] = _CampaignInput
+
+    def _run(self, campaign_id: str, run_manager=None) -> str:
+        return json.dumps(self._c().get_call_result(campaign_id).to_dict())
+
+
+class CallinListRecentCalls(_CallinTool):
+    """List recent calls handled by your Callin.io voice agents."""
+
+    name: str = "callin_list_recent_calls"
+    description: str = "List recent calls handled by your Callin.io voice agents, with summaries (JSON)."
+    args_schema: Type[BaseModel] = _ListInput
+
+    def _run(self, limit: int = 10, run_manager=None) -> str:
+        return json.dumps(self._c().list_conversations(page_size=limit))
+
+
+class CallinToolkit(BaseToolkit):
+    """All Callin.io tools in one toolkit."""
+
+    model_config = ConfigDict(arbitrary_types_allowed=True)
+    client: Optional[Any] = None  # a callin.Callin instance
+
+    def get_tools(self) -> List[BaseTool]:
+        return [CallinPlaceCall(client=self.client), CallinGetCallResult(client=self.client), CallinListRecentCalls(client=self.client)]

langchain_callin-0.1.0/tests/test_tools.py

@@ -0,0 +1,16 @@
+from langchain_callin import CallinToolkit
+
+
+class Fake:
+    def list_conversations(self, page_size=10):
+        return {"items": [], "page_size": page_size}
+
+
+def test_toolkit_names():
+    names = [t.name for t in CallinToolkit(client=Fake()).get_tools()]
+    assert names == ["callin_place_call", "callin_get_call_result", "callin_list_recent_calls"]
+
+
+def test_list_runs():
+    tool = CallinToolkit(client=Fake()).get_tools()[2]
+    assert '"page_size": 3' in tool.invoke({"limit": 3})