llm-latchkey 1.0.0__tar.gz

llm_latchkey-1.0.0/PKG-INFO

@@ -0,0 +1,39 @@
+Metadata-Version: 2.4
+Name: llm-latchkey
+Version: 1.0.0
+Summary: An LLM tool plugin for using Latchkey to make authenticated HTTP API requests.
+Author-email: Hynek Urban <hynek@imbue.com>
+License: MIT
+Project-URL: Homepage, https://github.com/imbue-ai/latchkey/integrations/llm-latchkey
+Project-URL: Issues, https://github.com/imbue-ai/latchkey/issues
+Project-URL: Repository, https://github.com/imbue-ai/latchkey
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Requires-Dist: llm
+
+# llm-latchkey
+
+A plugin for Simon Willison's [LLM](https://llm.datasette.io/) tool that lets models make authenticated HTTP API requests via [Latchkey](https://github.com/imbue-ai/latchkey).
+
+## Installation
+
+First, install Latchkey and configure credentials for at least one service:
+
+```bash
+npm install -g latchkey
+latchkey auth set github -H "Authorization: Bearer ghp_..."
+```
+
+Then install this plugin:
+
+```bash
+llm install llm-latchkey
+```
+
+## Usage
+
+```bash
+llm -T latchkey "What are my most recent GitHub notifications?" --td
+```
+
+The model gets a single `latchkey` tool that accepts any latchkey command string. The tool description includes usage instructions, examples, and the list of supported services, so the model knows how to use it.

llm_latchkey-1.0.0/README.md

@@ -0,0 +1,26 @@
+# llm-latchkey
+
+A plugin for Simon Willison's [LLM](https://llm.datasette.io/) tool that lets models make authenticated HTTP API requests via [Latchkey](https://github.com/imbue-ai/latchkey).
+
+## Installation
+
+First, install Latchkey and configure credentials for at least one service:
+
+```bash
+npm install -g latchkey
+latchkey auth set github -H "Authorization: Bearer ghp_..."
+```
+
+Then install this plugin:
+
+```bash
+llm install llm-latchkey
+```
+
+## Usage
+
+```bash
+llm -T latchkey "What are my most recent GitHub notifications?" --td
+```
+
+The model gets a single `latchkey` tool that accepts any latchkey command string. The tool description includes usage instructions, examples, and the list of supported services, so the model knows how to use it.

llm_latchkey-1.0.0/llm_latchkey.egg-info/PKG-INFO

@@ -0,0 +1,39 @@
+Metadata-Version: 2.4
+Name: llm-latchkey
+Version: 1.0.0
+Summary: An LLM tool plugin for using Latchkey to make authenticated HTTP API requests.
+Author-email: Hynek Urban <hynek@imbue.com>
+License: MIT
+Project-URL: Homepage, https://github.com/imbue-ai/latchkey/integrations/llm-latchkey
+Project-URL: Issues, https://github.com/imbue-ai/latchkey/issues
+Project-URL: Repository, https://github.com/imbue-ai/latchkey
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Requires-Dist: llm
+
+# llm-latchkey
+
+A plugin for Simon Willison's [LLM](https://llm.datasette.io/) tool that lets models make authenticated HTTP API requests via [Latchkey](https://github.com/imbue-ai/latchkey).
+
+## Installation
+
+First, install Latchkey and configure credentials for at least one service:
+
+```bash
+npm install -g latchkey
+latchkey auth set github -H "Authorization: Bearer ghp_..."
+```
+
+Then install this plugin:
+
+```bash
+llm install llm-latchkey
+```
+
+## Usage
+
+```bash
+llm -T latchkey "What are my most recent GitHub notifications?" --td
+```
+
+The model gets a single `latchkey` tool that accepts any latchkey command string. The tool description includes usage instructions, examples, and the list of supported services, so the model knows how to use it.

llm_latchkey-1.0.0/llm_latchkey.egg-info/SOURCES.txt

@@ -0,0 +1,9 @@
+README.md
+llm_latchkey.py
+pyproject.toml
+llm_latchkey.egg-info/PKG-INFO
+llm_latchkey.egg-info/SOURCES.txt
+llm_latchkey.egg-info/dependency_links.txt
+llm_latchkey.egg-info/entry_points.txt
+llm_latchkey.egg-info/requires.txt
+llm_latchkey.egg-info/top_level.txt

llm_latchkey-1.0.0/llm_latchkey.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

llm_latchkey-1.0.0/llm_latchkey.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[llm]
+latchkey = llm_latchkey

llm_latchkey-1.0.0/llm_latchkey.egg-info/requires.txt

@@ -0,0 +1 @@
+llm

llm_latchkey-1.0.0/llm_latchkey.egg-info/top_level.txt

@@ -0,0 +1 @@
+llm_latchkey

llm_latchkey-1.0.0/llm_latchkey.py

@@ -0,0 +1,72 @@
+import shlex
+import shutil
+import subprocess
+
+import llm
+
+
+class LatchkeyError(Exception):
+    pass
+
+
+def _find_latchkey() -> str:
+    path = shutil.which("latchkey")
+    if path is None:
+        raise LatchkeyError(
+            "Latchkey is not installed. Install it with: npm install -g latchkey"
+        )
+    return path
+
+
+def latchkey(command: str) -> str:
+    """Run a latchkey command. Latchkey injects stored API credentials into curl commands for third-party services.
+
+Available commands:
+- `services list --viable` — List services with configured credentials.
+- `services info <service_name>` — Get auth options, credential status, and API docs links for a service.
+- `curl <curl_arguments>` — Make an authenticated HTTP request. Pass standard curl arguments; credentials are injected automatically.
+- `auth browser <service_name>` — Open a browser login popup to authenticate (only if credentials are missing/invalid).
+
+Usage:
+1. Start with `services list --viable` to discover configured services.
+2. Use `services info <service_name>` to learn about the API and check credential status.
+3. Use `curl <args>` to make requests — do NOT include Authorization headers, latchkey adds them.
+4. If you get HTTP 401/403, check `services info` — if credentials are invalid, use `auth browser`.
+5. Do NOT initiate a login if credential status is `valid` or `unknown`.
+
+Important: Do NOT use shell features like $(...), backticks, or variable expansion in commands — they will not be interpreted. Compute any dynamic values (like dates) yourself and inline them directly.
+
+Examples:
+- `services list --viable`
+- `services info slack`
+- `curl https://api.github.com/user`
+- `curl -X POST 'https://slack.com/api/conversations.create' -H 'Content-Type: application/json' -d '{"name":"my-channel"}'`
+- `curl 'https://api.linear.app/graphql' -X POST -H 'Content-Type: application/json' -d '{"query": "{ viewer { assignedIssues(first: 10) { nodes { title state { name } } } } }"}'`
+- `curl 'https://discord.com/api/v10/users/@me'`
+
+Supported services include: AWS, Discord, Dropbox, GitHub, GitLab, Gmail, Google Calendar, Google Docs, Google Drive, Google Sheets, Linear, Notion, Sentry, Slack, Stripe, Telegram, Zoom, and more."""
+    latchkey_path = _find_latchkey()
+    try:
+        arguments = shlex.split(command)
+    except ValueError as error:
+        return f"Error parsing command: {error}"
+
+    timeout = 60 if arguments and arguments[0] == "curl" else 30
+    result = subprocess.run(
+        [latchkey_path, *arguments],
+        capture_output=True,
+        text=True,
+        timeout=timeout,
+    )
+    output = result.stdout.strip()
+    error = result.stderr.strip()
+    if result.returncode != 0:
+        return f"Error (exit code {result.returncode}): {error or output}"
+    if error and output:
+        return f"{output}\n\n(stderr: {error})"
+    return output or error or "(empty response)"
+
+
+@llm.hookimpl
+def register_tools(register):
+    register(latchkey)

llm_latchkey-1.0.0/pyproject.toml

@@ -0,0 +1,25 @@
+[project]
+name = "llm-latchkey"
+version = "1.0.0"
+description = "An LLM tool plugin for using Latchkey to make authenticated HTTP API requests."
+readme = "README.md"
+requires-python = ">=3.9"
+license = { text = "MIT" }
+authors = [
+    { name = "Hynek Urban", email = "hynek@imbue.com" },
+]
+dependencies = [
+    "llm",
+]
+
+[build-system]
+requires = ["setuptools"]
+build-backend = "setuptools.build_meta"
+
+[project.urls]
+Homepage = "https://github.com/imbue-ai/latchkey/integrations/llm-latchkey"
+Issues = "https://github.com/imbue-ai/latchkey/issues"
+Repository = "https://github.com/imbue-ai/latchkey"
+
+[project.entry-points.llm]
+latchkey = "llm_latchkey"

llm_latchkey-1.0.0/setup.cfg

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