Interloper shared read-only tool functions for AI surfaces (agent, MCP)
Project description
interloper-toolkit
The read-only tool functions shared by interloper's AI surfaces — the ADK
chat agent (interloper-agent) and the MCP server (interloper-mcp).
Every function takes a frozen ToolkitContext(store, catalog, org_id) 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 consumers surface them verbatim as tool descriptions.
Modules:
catalog— the component definitions the platform ships (list, detail, asset schemas, field search, schema comparison)collection— the org's component instances (read-only listing; sensitive kinds project identity/metadata only)lineage— dependency analysis, impact assessment, DAG traversalscheduling— jobs, runs, and backfills: read-only monitoringanalytics— run statistics, partition coverage, data freshness
Mutating operations (trigger/toggle/create) deliberately live with the agent, not here — this package is safe to expose on read-only surfaces.
Depends only on interloper-core and interloper-db; no LLM-framework
dependencies (no google-adk, no mcp).
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file interloper_toolkit-0.44.0.tar.gz.
File metadata
- Download URL: interloper_toolkit-0.44.0.tar.gz
- Upload date:
- Size: 12.7 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: uv/0.11.32 {"installer":{"name":"uv","version":"0.11.32","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}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
673361fdf944543f352a5ff563b5487263cbfc2df50b6ef2b35d3fbb0bac3f96
|
|
| MD5 |
b7eb555247657bf0ba552814b92b69db
|
|
| BLAKE2b-256 |
c7efa2324fd2780a736152d3707689d4c177f3c3e90a7afb3b84d19abab13e64
|
File details
Details for the file interloper_toolkit-0.44.0-py3-none-any.whl.
File metadata
- Download URL: interloper_toolkit-0.44.0-py3-none-any.whl
- Upload date:
- Size: 16.9 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: uv/0.11.32 {"installer":{"name":"uv","version":"0.11.32","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}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
ca7d386232d1c3a866912261a674b8a665b6679302d7cb245007fcff0fa352b8
|
|
| MD5 |
01430f5cc96fd2fece16cb2afea1db54
|
|
| BLAKE2b-256 |
d47353598d612ef1100aa95514da7f5ed2053b529a1c2b6d53f1f460c31a490c
|
