toolchestrator 0.6.0__tar.gz

toolchestrator-0.6.0/LICENSE

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

toolchestrator-0.6.0/PKG-INFO

@@ -0,0 +1,78 @@
+Metadata-Version: 2.4
+Name: toolchestrator
+Version: 0.6.0
+Summary: Connect a local tool to a Toolchestrator hub: registry, versioned schema/data sync, task serving, cross-tool reads/calls, and web-UI tunnelling.
+Author-email: Stevica Kuharski <kstevica@gmail.com>
+License-Expression: MIT
+Project-URL: Homepage, https://toolchestrator.com
+Project-URL: Connect guide, https://hub.toolchestrator.com/skill
+Keywords: toolchestrator,orchestration,internal-tools,claude-code,ai-tools,automation
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Libraries
+Classifier: Topic :: System :: Distributed Computing
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests>=2.25
+Requires-Dist: websocket-client>=1.5
+Dynamic: license-file
+
+# toolchestrator
+
+The Python client for [Toolchestrator](https://toolchestrator.com) — connect a small local
+tool to your company's hub without moving it off the machine it runs on.
+
+With this client a connected tool can:
+
+- register itself in the company **registry** (name, author, the problem it solves);
+- publish **versioned JSON-Schema** data models and **sync records** to the hub;
+- **serve remote task actions** over an outbound long-poll (the hub never connects into your
+  machine);
+- **read other tools' data** through the hub with filtered queries;
+- **invoke** another tool's action and get the result back (`tc.call`);
+- **expose its own local web UI** through the hub (`tc.serve_web`).
+
+Works on Python 3.9+; depends only on `requests` and `websocket-client`.
+
+## Install
+
+```bash
+pip install toolchestrator
+```
+
+## Quick start
+
+```python
+from toolchestrator import Toolchestrator
+
+# one-time registration, with a personal token from your hub's Settings page
+tc = Toolchestrator.register(
+    "https://hub.example.com",        # your company's hub URL
+    "tcu_...",                        # personal access token
+    "invoice-radar", "Invoice Radar",
+    description="Tracks vendor invoices and flags overdue ones.",
+    sharing_scope="private",          # start private; widen deliberately
+)
+
+# afterwards, anywhere in the tool (loads .toolchestrator.json):
+tc = Toolchestrator()
+tc.sync_schema("invoice", invoice_schema)
+tc.sync_data("invoice", rows, id_field="id")
+tc.serve({"mark_paid": handle_mark_paid})   # execute tasks queued on the hub
+```
+
+The easiest way to connect a tool is to let an AI coding agent do the wiring: point it at
+your hub's connect guide (`<your-hub-url>/skill`) and ask it to *"connect this tool to
+Toolchestrator"*. The hub URL always comes from you — the client never assumes one.
+
+## License
+
+MIT © Stevica Kuharski

toolchestrator-0.6.0/README.md

@@ -0,0 +1,51 @@
+# toolchestrator
+
+The Python client for [Toolchestrator](https://toolchestrator.com) — connect a small local
+tool to your company's hub without moving it off the machine it runs on.
+
+With this client a connected tool can:
+
+- register itself in the company **registry** (name, author, the problem it solves);
+- publish **versioned JSON-Schema** data models and **sync records** to the hub;
+- **serve remote task actions** over an outbound long-poll (the hub never connects into your
+  machine);
+- **read other tools' data** through the hub with filtered queries;
+- **invoke** another tool's action and get the result back (`tc.call`);
+- **expose its own local web UI** through the hub (`tc.serve_web`).
+
+Works on Python 3.9+; depends only on `requests` and `websocket-client`.
+
+## Install
+
+```bash
+pip install toolchestrator
+```
+
+## Quick start
+
+```python
+from toolchestrator import Toolchestrator
+
+# one-time registration, with a personal token from your hub's Settings page
+tc = Toolchestrator.register(
+    "https://hub.example.com",        # your company's hub URL
+    "tcu_...",                        # personal access token
+    "invoice-radar", "Invoice Radar",
+    description="Tracks vendor invoices and flags overdue ones.",
+    sharing_scope="private",          # start private; widen deliberately
+)
+
+# afterwards, anywhere in the tool (loads .toolchestrator.json):
+tc = Toolchestrator()
+tc.sync_schema("invoice", invoice_schema)
+tc.sync_data("invoice", rows, id_field="id")
+tc.serve({"mark_paid": handle_mark_paid})   # execute tasks queued on the hub
+```
+
+The easiest way to connect a tool is to let an AI coding agent do the wiring: point it at
+your hub's connect guide (`<your-hub-url>/skill`) and ask it to *"connect this tool to
+Toolchestrator"*. The hub URL always comes from you — the client never assumes one.
+
+## License
+
+MIT © Stevica Kuharski

toolchestrator-0.6.0/pyproject.toml

@@ -0,0 +1,42 @@
+[build-system]
+requires = ["setuptools>=77"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "toolchestrator"
+version = "0.6.0"
+description = "Connect a local tool to a Toolchestrator hub: registry, versioned schema/data sync, task serving, cross-tool reads/calls, and web-UI tunnelling."
+readme = "README.md"
+requires-python = ">=3.9"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [{ name = "Stevica Kuharski", email = "kstevica@gmail.com" }]
+keywords = [
+    "toolchestrator",
+    "orchestration",
+    "internal-tools",
+    "claude-code",
+    "ai-tools",
+    "automation",
+]
+dependencies = ["requests>=2.25", "websocket-client>=1.5"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Software Development :: Libraries",
+    "Topic :: System :: Distributed Computing",
+]
+
+[project.urls]
+Homepage = "https://toolchestrator.com"
+"Connect guide" = "https://hub.toolchestrator.com/skill"
+
+[tool.setuptools]
+packages = ["toolchestrator"]

toolchestrator-0.6.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

toolchestrator-0.6.0/toolchestrator/__init__.py

@@ -0,0 +1,39 @@
+"""Toolchestrator client library.
+
+Connects a tool running on this machine to a Toolchestrator hub:
+
+* **Register** the tool once with a personal access token (``tcu_...``); the
+  tool receives its own API key (``tck_...``) which is written to a local
+  ``.toolchestrator.json`` config file (gitignore it!).
+* **Sync** the tool's data model schemas (versioned on the hub) and records.
+* **Read** other visible tools' data (filtered/projected/ordered via
+  ``read``), **declare connections** with a purpose (``connect_to``),
+  **enqueue** tasks on them (or **call** an action synchronously and get
+  the result back), and **subscribe** to their data changes.
+* **Serve** actions: a blocking long-poll loop that claims tasks queued for
+  this tool and runs local handler functions (``data_handlers`` route
+  ``data.changed`` notifications per source tool/model).
+* **Serve a web UI** (``serve_web``): tunnel a local web app's full HTTP
+  through the hub so visible users reach it in their browser — this machine
+  still makes only outbound connections.
+
+Quick start::
+
+    from toolchestrator import Toolchestrator
+
+    # one time, writes .toolchestrator.json in the current directory:
+    tc = Toolchestrator.register(
+        "http://localhost:8787", "tcu_...", "invoice-radar", "Invoice Radar",
+        description="Tracks vendor invoices", sharing_scope="private")
+
+    # every run afterwards:
+    tc = Toolchestrator()                 # loads .toolchestrator.json
+    tc.sync_schema("invoice", schema)     # JSON Schema dict
+    tc.sync_data("invoice", rows, id_field="id")
+    tc.serve({"mark_paid": mark_paid})    # blocking task loop
+"""
+
+from .client import Toolchestrator, ToolchestratorError
+
+__version__ = "0.6.0"
+__all__ = ["Toolchestrator", "ToolchestratorError", "__version__"]