lattice-mcp 1.1.1 → 1.1.2

package/AGENTS.md

@@ -2,7 +2,7 @@
 
 > `lattice-mcp` is the **Model Context Protocol server for Lattice**, the container
 > orchestration platform that runs every `appleby.cloud` service. It exposes the
-> `lattice-api` admin surface to Claude Code as **125 typed tools** — workers, stacks,
+> `lattice-api` admin surface to Claude Code as **126 typed tools** — workers, stacks,
 > containers, deployments, databases, registries, networks, volumes and instance config.
 > This file orients any agent/worker before touching code in this repo.
 >
@@ -42,7 +42,7 @@ Those live in [`lattice-api`](https://github.com/aidenappl/lattice-api) and
 
 | Path | Role |
 |------|------|
-| `index.js` | Everything: `--setup` flow, config read, `api()` HTTP helper, `text()`/`body()` helpers, all 125 `server.tool(...)` registrations, transport connect. |
+| `index.js` | Everything: `--setup` flow, config read, `api()` HTTP helper, `text()`/`body()` helpers, all 126 `server.tool(...)` registrations, transport connect. |
 | `package.json` | npm metadata. `bin.lattice-mcp` → `index.js`, so `npx lattice-mcp` works. |
 | `README.md` | User-facing setup + full tool table. |
 | `AGENTS.md` | This file. |
@@ -126,13 +126,13 @@ exits immediately if either is missing. In practice these come from the `env` bl
 
 **Tool groups**, in file order:
 
-The counts below sum to **125**, matching the header and `grep -c 'server.tool(' index.js`. The
-first six rows are the original, pre-`1.1.0` tools (registered top-of-file with no banner comment);
+The counts below sum to **126**, matching the header and `grep -c 'server.tool(' index.js`. The
+first rows are the original, pre-`1.1.0` tools (registered top-of-file with no banner comment);
 every bolded row corresponds to a `// ───` banner group and matches its exact in-file name.
 
 | Group | Tools | Notes |
 |-------|-------|-------|
-| Overview & health | 2 | `lattice_overview`, `lattice_health` |
+| Overview & health | 3 | `lattice_overview`, `lattice_health`, `lattice_get_version` |
 | Workers | 3 + 4 actions | list/get/metrics; reboot, upgrade, stop-all, start-all |
 | Stacks | 2 + 5 actions | list/get; deploy, restart, stop, start, update |
 | Containers | 4 + 8 actions | list/get/logs/lifecycle; start, stop, restart, kill, pause, unpause, remove, recreate. (`lattice_get_container_metrics` is *not* here — it lives under **Discovery & diagnostics**.) |
@@ -162,6 +162,12 @@ always 400'd); and `lattice_test_backup_destination` now marks `worker_id` as **
 param the handler 400s without — the test dispatches over the worker's WebSocket). It also hardens
 `api()` against non-JSON responses (see *How code is written here*) and declares `zod` explicitly.
 
+**1.1.2** adds `lattice_get_version` (`GET /version`, so agents can read the deployed API version
+for deploy-drift checks without shelling out to `curl`), and widens two read tools to pass filter
+params the handlers already accept but the tools were dropping: `lattice_get_audit_log` gains
+`user_id` / `action` / `resource_type` / `offset` (answer "who deleted stack X" server-side instead
+of scanning 50 rows), and `lattice_get_container_logs` gains `offset` / `worker_id`. Tool count 125 → 126.
+
 **Consolidations.** Where `lattice-api` exposes several paths served by one handler, this repo
 exposes one tool with an enum rather than N tools. `lattice_database_action` covers
 `/start`, `/stop`, `/restart` and `/remove`. Worker actions are the historical exception — they

package/README.md

@@ -8,7 +8,7 @@ Model Context Protocol server for [Lattice](https://github.com/aidenappl/lattice
 
 ## Overview
 
-`lattice-mcp` is a single-file Node ESM program (`index.js`) that speaks MCP over stdio and translates tool calls into HTTP requests against the `lattice-api` admin surface. It exposes **125 typed tools** and holds no business logic, caching or state of its own — every behaviour (pagination, validation, side effects) comes from `lattice-api`.
+`lattice-mcp` is a single-file Node ESM program (`index.js`) that speaks MCP over stdio and translates tool calls into HTTP requests against the `lattice-api` admin surface. It exposes **126 typed tools** and holds no business logic, caching or state of its own — every behaviour (pagination, validation, side effects) comes from `lattice-api`.
 
 Once configured, ask Claude Code things like:
 
@@ -83,18 +83,19 @@ Restart Claude Code after setup so the new server and tools are picked up.
 | `npm install` | Install dependencies (not vendored) |
 | `node --check index.js` | Syntax gate — the only static check that exists |
 | `LATTICE_API_URL=… LATTICE_API_TOKEN=… node index.js` | Run the server on stdio |
-| `grep -c 'server.tool(' index.js` | Confirm the tool count (should be 125) |
+| `grep -c 'server.tool(' index.js` | Confirm the tool count (should be 126) |
 | `npm publish` | Publish to npm — **this is deployment** (requires 2FA passkey from an interactive terminal) |
 
 ## Tools
 
-All 125 tools, grouped as they appear in `index.js`. ⚠️ marks destructive tools; their descriptions state the blast radius.
+All 126 tools, grouped as they appear in `index.js`. ⚠️ marks destructive tools; their descriptions state the blast radius.
 
 ### Overview & health
 | Tool | Description |
 |------|-------------|
 | `lattice_overview` | Fleet overview — worker/stack/container counts, failed stacks, CPU/memory |
 | `lattice_health` | API health and database connectivity |
+| `lattice_get_version` | Deployed lattice-api version string — check deploy drift against GitHub tags |
 
 ### Workers
 | Tool | Description |
@@ -123,7 +124,7 @@ All 125 tools, grouped as they appear in `index.js`. ⚠️ marks destructive to
 |------|-------------|
 | `lattice_list_containers` | List containers with status, image, ports, health |
 | `lattice_get_container` | Full container details |
-| `lattice_get_container_logs` | Recent container logs (stdout/stderr) |
+| `lattice_get_container_logs` | Recent container logs (stdout/stderr); `offset` paginates into older logs, filter by `stream`/`worker_id` |
 | `lattice_get_container_lifecycle` | Lifecycle events (start, stop, health changes) |
 | `lattice_start_container` | Start a stopped container |
 | `lattice_stop_container` | Stop a running container |
@@ -151,7 +152,7 @@ All 125 tools, grouped as they appear in `index.js`. ⚠️ marks destructive to
 ### Audit & API tokens
 | Tool | Description |
 |------|-------------|
-| `lattice_get_audit_log` | Recent audit log entries (who did what, when) |
+| `lattice_get_audit_log` | Audit log entries (who did what, when); filter by `user_id`/`action`/`resource_type`, `offset` paginates |
 | `lattice_list_api_tokens` | List API tokens |
 | `lattice_create_api_token` | Create a new API token |
 | `lattice_delete_api_token` | Delete an API token ⚠️ |
@@ -285,7 +286,7 @@ Everything lives in one file:
 
 | Path | Role |
 |------|------|
-| `index.js` | The whole server: `--setup` flow, config read, `api()` HTTP helper, `text()`/`body()` helpers, all 125 `server.tool(...)` registrations, transport connect. |
+| `index.js` | The whole server: `--setup` flow, config read, `api()` HTTP helper, `text()`/`body()` helpers, all 126 `server.tool(...)` registrations, transport connect. |
 | `package.json` | npm metadata; `bin.lattice-mcp` → `index.js`. |
 | `AGENTS.md` | Contributor/agent guide — conventions, handler contracts, verification. |
 | `README.md` | This file. |

package/index.js

@@ -114,7 +114,7 @@ function body(obj) {
 
 const server = new McpServer({
     name: "lattice",
-    version: "1.1.1",
+    version: "1.1.2",
 });
 
 // Overview
@@ -129,6 +129,12 @@ server.tool("lattice_health", "Check API health and database connectivity", {},
     return { content: text(res) };
 });
 
+// Version
+server.tool("lattice_get_version", "Get the deployed lattice-api version string. Use to check deploy drift against GitHub tags/commits (e.g. for /howfarbehind).", {}, async () => {
+    const res = await api("GET", "/version");
+    return { content: text(res) };
+});
+
 // Workers
 server.tool("lattice_list_workers", "List all workers with status, IP, Docker version, runner version, last heartbeat", {
     status: z.enum(["online", "offline", "disconnected"]).optional().describe("Filter by worker status"),
@@ -189,9 +195,11 @@ server.tool("lattice_get_container", "Get full container details including confi
 server.tool("lattice_get_container_logs", "Get recent container logs (stdout/stderr)", {
     id: z.number().describe("Container ID"),
     limit: z.number().optional().describe("Number of log lines (default 50)"),
+    offset: z.number().optional().describe("Skip this many lines — paginate past the tail into older logs"),
     stream: z.enum(["stdout", "stderr"]).optional().describe("Filter by stream"),
-}, async ({ id, limit, stream }) => {
-    const res = await api("GET", `/admin/containers/${id}/logs`, { limit, stream });
+    worker_id: z.number().optional().describe("Filter by worker ID"),
+}, async ({ id, limit, offset, stream, worker_id }) => {
+    const res = await api("GET", `/admin/containers/${id}/logs`, { limit, offset, stream, worker_id });
     return { content: text(res) };
 });
 
@@ -228,10 +236,14 @@ server.tool("lattice_get_deployment_logs", "Get deployment logs: pull, create, s
 });
 
 // Audit log
-server.tool("lattice_get_audit_log", "Get recent audit log entries (who did what, when)", {
+server.tool("lattice_get_audit_log", "Get recent audit log entries (who did what, when). Filter by user, action, or resource type to answer 'who deleted X' without scanning.", {
     limit: z.number().optional().describe("Number of entries (default 50)"),
-}, async ({ limit }) => {
-    const res = await api("GET", "/admin/audit-log", { limit });
+    offset: z.number().optional().describe("Skip this many entries for pagination"),
+    user_id: z.number().optional().describe("Filter by the user who performed the action"),
+    action: z.string().optional().describe("Filter by action (e.g. create, update, delete, deploy)"),
+    resource_type: z.string().optional().describe("Filter by resource type (e.g. stack, container, worker, registry)"),
+}, async ({ limit, offset, user_id, action, resource_type }) => {
+    const res = await api("GET", "/admin/audit-log", { limit, offset, user_id, action, resource_type });
     return { content: text(res) };
 });
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "lattice-mcp",
-  "version": "1.1.1",
+  "version": "1.1.2",
   "description": "MCP server for Lattice container orchestration platform",
   "type": "module",
   "main": "index.js",