interloper-toolkit
The tool functions shared by interloper's AI surfaces: the chat agent
(interloper-agent) and the MCP server (interloper-mcp).
Every function takes a frozen ToolkitContext(store, catalog, org_id, role)
as its first argument and returns <SuccessModel> | ToolError: typed
pydantic results (see models.py) discriminated by the literal status
field, never raising. The models are the tool contract: MCP derives per-tool
output schemas from them, row-projecting models act as an allowlist of what
leaves the platform, and full-row payloads embed the interloper-db models to
keep that coupling visible rather than duplicated. The docstrings are
LLM-facing: both surfaces adopt them verbatim as tool descriptions.
Reads take no role; writes declare the role they need with requires_role
and refuse below it, as a structured ToolError.
tools.TOOLS is the table both surfaces register: every tool with its
Effect (read, read through a provider, edit, create, launch, cancel). A
surface derives its behaviour from the effect (MCP annotations, the agent's
approvals) and Tool.bind adapts a function to the way the surface supplies
the context. A tool that carries_secrets in its arguments is left off any
surface that transports arguments through a third party.
Modules:
catalog: the component definitions the platform ships (list, detail, asset schemas, field search, schema comparison)collection: the org's component instances (listing, edits, relations, connection checks and setup; sensitive kinds project identity only)sourcesandjobs: creating sources, resolving their fields, creating jobslineage: dependency analysis, impact assessment, DAG traversalscheduling: jobs, runs and backfills, monitoring and controlanalytics: run statistics, partition coverage, data freshnesstools: the table above
Depends only on interloper-core and interloper-db; no LLM-framework
dependencies (no pydantic-ai, no mcp).
Metadata
Release files for interloper-toolkit 0.94.2
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| interloper_toolkit-0.94.2.tar.gz | 38.4 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| interloper_toolkit-0.94.2-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 84.8 kB
Release files / interloper_toolkit-0.94.2.tar.gz
| Download URL | interloper_toolkit-0.94.2.tar.gz |
|---|---|
| Size | 38.4 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
965c3dde35dd5ea5802d6ab3ff7237a6c397b07868424dca8f99b8a70295dea9
|
|
BLAKE2b-256 checksum How to use checksums |
1e4d8186bc5b4e4f9bd65e557d47c29794ddf9ab27e6feccde75e3fb2854e714
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.12.21 {"installer":{"name":"uv","version":"0.12.21","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Release files / interloper_toolkit-0.94.2-py3-none-any.whl
| Download URL | interloper_toolkit-0.94.2-py3-none-any.whl |
|---|---|
| Size | 46.4 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
9fa2d21dd3e842c40383fd49f8a4d6e5267acb3593ec16e0e6e7c266b87536df
|
|
BLAKE2b-256 checksum How to use checksums |
a290a4e61e5b0b04f1959e3c581a74148b0e11560ca836ba8c9cb40a9998ffba
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.12.21 {"installer":{"name":"uv","version":"0.12.21","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
