cteno-sdk 2.10.13__tar.gz

cteno_sdk-2.10.13/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) Cteno contributors
+
+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.

cteno_sdk-2.10.13/PKG-INFO

@@ -0,0 +1,119 @@
+Metadata-Version: 2.4
+Name: cteno-sdk
+Version: 2.10.13
+Summary: Run Cteno agents from Python. Platform wheels bundle a local Cteno daemon; no desktop app or account needed.
+Author: Cteno contributors
+License: MIT
+Project-URL: Homepage, https://github.com/zalan159/cteno-sdk
+Project-URL: Source, https://github.com/zalan159/cteno-sdk/tree/main/python
+Project-URL: Issues, https://github.com/zalan159/cteno-sdk/issues
+Project-URL: Changelog, https://github.com/zalan159/cteno-sdk/blob/main/CHANGELOG.md
+Keywords: cteno,agent,sdk,llm,ai-agent
+Classifier: Development Status :: 4 - Beta
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Framework :: AsyncIO
+Classifier: Operating System :: MacOS
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Operating System :: Microsoft :: Windows
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# cteno-sdk (Python)
+
+Run Cteno agents from Python — same protocol and shape as the Node package
+`@cteno/sdk`. Standard library only, Python ≥ 3.9, asyncio.
+
+> **The PyPI package is coming soon** (with Cteno 2.10.12). Until then, install from
+> source with `pip install ./python` and point the SDK at a daemon: see the repository
+> README, "Use from source".
+
+The platform wheels (planned: macOS arm64/x64, Linux x64 with glibc ≥ 2.34, Windows x64;
+Linux arm64 is not supported yet)
+include the Cteno daemon. `CtenoSession.open()` starts it in local mode on first use:
+no desktop app, no account, your own model key.
+
+## Install
+
+```bash
+# coming soon — not published yet
+pip install cteno-sdk
+```
+
+On a platform without a wheel pip falls back to the sdist, which has no daemon: set
+`CTENO_SDK_DAEMON_PATH` to a `cteno-host-cli` binary, or pass `socket_path` to a daemon
+you run yourself.
+
+## Quickstart
+
+```python
+import asyncio, os
+from cteno_sdk import CtenoSession
+
+async def main():
+    async with await CtenoSession.open() as cteno:          # starts the bundled daemon if needed
+        await cteno.configure_model(base_url="https://api.openai.com/v1", model="gpt-4.1-mini",
+                                    api_key=os.environ["OPENAI_API_KEY"])   # once; stays the default
+        sid = await cteno.create(cwd=".")
+        result = await cteno.run(sid, "Reply with exactly: hello from Cteno")
+        print(result.text if result.ok else result.error)   # hello from Cteno
+        await cteno.close_session(sid)
+
+asyncio.run(main())
+```
+
+Tools that are not read-only are denied at once unless you approve them:
+
+```python
+result = await cteno.run(sid, "Run the tests", can_use_tool=lambda req: req["tool_name"] == "Bash")
+```
+
+`can_use_tool` may be async and may return `{"allow": False, "reason": "..."}`. The
+daemon keeps running after your process exits; `await stop_daemon()` stops it.
+
+## Your own agent
+
+```python
+import asyncio
+from cteno_sdk import CtenoSession, AgentSpec, ClientTool
+
+async def search_places(args, ctx):          # runs in YOUR process
+    return {"name": "Quiet Corner Cafe", "keyword": args["keyword"]}
+
+async def main():
+    async with await CtenoSession.open() as cteno:      # bundled daemon, or open("/path/to/host.sock")
+        sid = await cteno.create(model="my-profile", spec=AgentSpec(
+            system_prompt="You are a city guide.",
+            tools={"allow": []},
+            client_tools=[ClientTool("search_places", "Search places",
+                                     {"type": "object", "properties": {"keyword": {"type": "string"}},
+                                      "required": ["keyword"]},
+                                     handler=search_places)],
+            limits={"maxIterations": 10, "turnTimeoutMs": 60_000},
+        ))
+        result = await cteno.run(sid, "Somewhere quiet for coffee?", timeout=90)
+        print(result.ok, result.text, result.tool_calls)
+        await cteno.close_session(sid)
+
+asyncio.run(main())
+```
+
+`AgentSpec` (custom prompt, client tools, terminal tools, output schema, limits,
+history, tenant) is supported by the bundled daemon; with an explicit `socket_path` to
+another daemon it needs ≥ 2.10.10 (`"sdk-session-spec-v1" in await cteno.capabilities()`).
+See the [repository README](../README.md) for authentication and compatibility, and
+the Node [README](../js/README.md) for the full spec field reference (same fields, snake_case here).
+
+## Tests
+
+```bash
+python -m unittest discover -s tests
+```
+
+## License
+
+MIT. The daemon binaries under `cteno_sdk/_bin` are not MIT; see
+`cteno_sdk/_bin/LICENSE.daemon` in the wheel.

cteno_sdk-2.10.13/README.md

@@ -0,0 +1,95 @@
+# cteno-sdk (Python)
+
+Run Cteno agents from Python — same protocol and shape as the Node package
+`@cteno/sdk`. Standard library only, Python ≥ 3.9, asyncio.
+
+> **The PyPI package is coming soon** (with Cteno 2.10.12). Until then, install from
+> source with `pip install ./python` and point the SDK at a daemon: see the repository
+> README, "Use from source".
+
+The platform wheels (planned: macOS arm64/x64, Linux x64 with glibc ≥ 2.34, Windows x64;
+Linux arm64 is not supported yet)
+include the Cteno daemon. `CtenoSession.open()` starts it in local mode on first use:
+no desktop app, no account, your own model key.
+
+## Install
+
+```bash
+# coming soon — not published yet
+pip install cteno-sdk
+```
+
+On a platform without a wheel pip falls back to the sdist, which has no daemon: set
+`CTENO_SDK_DAEMON_PATH` to a `cteno-host-cli` binary, or pass `socket_path` to a daemon
+you run yourself.
+
+## Quickstart
+
+```python
+import asyncio, os
+from cteno_sdk import CtenoSession
+
+async def main():
+    async with await CtenoSession.open() as cteno:          # starts the bundled daemon if needed
+        await cteno.configure_model(base_url="https://api.openai.com/v1", model="gpt-4.1-mini",
+                                    api_key=os.environ["OPENAI_API_KEY"])   # once; stays the default
+        sid = await cteno.create(cwd=".")
+        result = await cteno.run(sid, "Reply with exactly: hello from Cteno")
+        print(result.text if result.ok else result.error)   # hello from Cteno
+        await cteno.close_session(sid)
+
+asyncio.run(main())
+```
+
+Tools that are not read-only are denied at once unless you approve them:
+
+```python
+result = await cteno.run(sid, "Run the tests", can_use_tool=lambda req: req["tool_name"] == "Bash")
+```
+
+`can_use_tool` may be async and may return `{"allow": False, "reason": "..."}`. The
+daemon keeps running after your process exits; `await stop_daemon()` stops it.
+
+## Your own agent
+
+```python
+import asyncio
+from cteno_sdk import CtenoSession, AgentSpec, ClientTool
+
+async def search_places(args, ctx):          # runs in YOUR process
+    return {"name": "Quiet Corner Cafe", "keyword": args["keyword"]}
+
+async def main():
+    async with await CtenoSession.open() as cteno:      # bundled daemon, or open("/path/to/host.sock")
+        sid = await cteno.create(model="my-profile", spec=AgentSpec(
+            system_prompt="You are a city guide.",
+            tools={"allow": []},
+            client_tools=[ClientTool("search_places", "Search places",
+                                     {"type": "object", "properties": {"keyword": {"type": "string"}},
+                                      "required": ["keyword"]},
+                                     handler=search_places)],
+            limits={"maxIterations": 10, "turnTimeoutMs": 60_000},
+        ))
+        result = await cteno.run(sid, "Somewhere quiet for coffee?", timeout=90)
+        print(result.ok, result.text, result.tool_calls)
+        await cteno.close_session(sid)
+
+asyncio.run(main())
+```
+
+`AgentSpec` (custom prompt, client tools, terminal tools, output schema, limits,
+history, tenant) is supported by the bundled daemon; with an explicit `socket_path` to
+another daemon it needs ≥ 2.10.10 (`"sdk-session-spec-v1" in await cteno.capabilities()`).
+See the [repository README](../README.md) for authentication and compatibility, and
+the Node [README](../js/README.md) for the full spec field reference (same fields, snake_case here).
+
+## Tests
+
+```bash
+python -m unittest discover -s tests
+```
+
+## License
+
+MIT. The daemon binaries under `cteno_sdk/_bin` are not MIT; see
+`cteno_sdk/_bin/LICENSE.daemon` in the wheel.

cteno_sdk-2.10.13/cteno_sdk/__init__.py

@@ -0,0 +1,65 @@
+"""Cteno Agent SDK for Python — same owner-socket protocol as ``@cteno/sdk/core``.
+
+    import asyncio
+    from cteno_sdk import CtenoSession, AgentSpec, ClientTool
+
+    async def main():
+        # Starts (or reuses) the SDK's own local daemon; no Cteno app or login needed.
+        async with await CtenoSession.open() as cteno:
+            await cteno.configure_model(base_url="https://api.deepseek.com/anthropic",
+                                        model="deepseek-chat", api_key=os.environ["DEEPSEEK_API_KEY"],
+                                        api_format="anthropic")
+            sid = await cteno.create(spec=AgentSpec(
+                system_prompt="You are a food guide.",
+                client_tools=[ClientTool("lookup_place", "Find a place", {"type": "object"},
+                                         handler=lambda args, ctx: {"name": args.get("name")})],
+            ))
+            result = await cteno.run(sid, "Where should I eat?")
+            print(result.text)
+
+    asyncio.run(main())
+
+See the repository README for the full guide.
+"""
+from .client import (
+    AGENT_SPEC_CAPABILITY,
+    AgentSpec,
+    ClientTool,
+    ClientToolContext,
+    CtenoSession,
+    RunResult,
+    SdkError,
+    TenantRef,
+    discover_owner_sockets,
+    spec_to_wire,
+)
+from .daemon import (
+    DaemonError,
+    default_instance_root,
+    ensure_daemon,
+    instance_layout,
+    isolated_pipe_name,
+    resolve_daemon_binary,
+    stop_daemon,
+)
+
+__all__ = [
+    "AGENT_SPEC_CAPABILITY",
+    "AgentSpec",
+    "ClientTool",
+    "ClientToolContext",
+    "CtenoSession",
+    "RunResult",
+    "SdkError",
+    "TenantRef",
+    "discover_owner_sockets",
+    "spec_to_wire",
+    "DaemonError",
+    "default_instance_root",
+    "ensure_daemon",
+    "instance_layout",
+    "isolated_pipe_name",
+    "resolve_daemon_binary",
+    "stop_daemon",
+]
+__version__ = "0.2.0"