@zibby/mcp-cli 0.1.0 → 0.2.1

package/index.js

@@ -500,6 +500,246 @@ server.tool(
   }
 );
 
+// ─────────────────────────────────────────────────────────────────────────
+// agent-ops integration tools
+//
+// These wrap the (currently in development) Zibby control-plane endpoints
+// for deploying / managing hosted app instances. Each instance runs the
+// open-source agent-ops daemon (github.com/ZibbyHQ/agent-ops) as a sidecar
+// — the daemon's own MCP server is what the user's local agent talks to
+// for per-instance operations. The tools here cover the cross-instance
+// surface that lives in Zibby's control plane.
+//
+// Backend endpoints these wrap are still being built; the MCP tools are
+// shipped now so client-side wiring lands first. Each tool will surface a
+// clear "control plane not yet deployed" error until the backend ships.
+
+const APPS_API_BASE = `${API_BASE}/apps`;
+
+async function callAppsAPI(path, opts = {}) {
+  // /catalog and /catalog/{appType} are public — let unauthenticated
+  // calls through (server enforces auth on the rest). Auth-required
+  // endpoints return 401 from the backend and we surface that to the
+  // tool caller; no need to gate here.
+  const token = getSessionToken();
+  const url = `${APPS_API_BASE}${path}`;
+  const init = {
+    method: opts.method || 'GET',
+    headers: {
+      'Content-Type': 'application/json',
+      ...(token ? { Authorization: `Bearer ${token}` } : {}),
+      ...(opts.headers || {}),
+    },
+  };
+  if (opts.body) init.body = JSON.stringify(opts.body);
+  try {
+    const res = await fetch(url, init);
+    const text = await res.text().catch(() => '');
+    let body = null;
+    try { body = text ? JSON.parse(text) : null; } catch { body = text; }
+    return { status: res.status, body, ok: res.ok };
+  } catch (err) {
+    return { error: err.message, status: 0 };
+  }
+}
+
+// ── Tool: deploy app ────────────────────────────────────────────────────
+server.tool(
+  'zibby_deploy_app',
+  'Deploy a marketplace app (n8n, Grafana, Open WebUI, …) into a Zibby project. ' +
+    'Returns 202 + the instanceId + the public URL. Once provisioning finishes the URL serves the app; ' +
+    'use the zibby_app_* tools to interact with its ops agent. No second MCP install needed — every ' +
+    'app tool proxies through the Zibby backend.',
+  {
+    appType: z.string().min(1).describe('Catalog id (use zibby_list_app_catalog to see options, e.g. "n8n")'),
+    projectId: z.string().min(1).describe('Zibby project to deploy under'),
+    name: z.string().optional().describe('Optional display name for the instance'),
+  },
+  async ({ appType, projectId, name }) => {
+    const res = await callAppsAPI('/deploy', {
+      method: 'POST',
+      body: { appType, projectId, name },
+    });
+    if (res.error) return { isError: true, content: [{ type: 'text', text: `Network: ${res.error}` }] };
+    if (!res.ok) {
+      const detail = typeof res.body === 'string' ? res.body : JSON.stringify(res.body || {});
+      return { isError: true, content: [{ type: 'text', text: `Deploy failed (${res.status}): ${detail}` }] };
+    }
+    return jsonResult(res.body);
+  }
+);
+
+// ── Tool: list marketplace catalog ──────────────────────────────────────
+server.tool(
+  'zibby_list_app_catalog',
+  'List every app available in the Zibby marketplace. Returns tile metadata (appType, displayName, ' +
+    'tagline, category, version, ratingAvg, installCount). Public — no Zibby login required.',
+  {},
+  async () => {
+    const res = await callAppsAPI('/catalog');
+    if (res.error) return { isError: true, content: [{ type: 'text', text: `Network: ${res.error}` }] };
+    if (!res.ok) return { isError: true, content: [{ type: 'text', text: `Catalog failed (${res.status})` }] };
+    return jsonResult(res.body);
+  }
+);
+
+// ── Tool: list apps ──────────────────────────────────────────────────────
+server.tool(
+  'zibby_list_apps',
+  'List hosted app instances in a project. Returns each instance\'s id, template, status, and MCP endpoint URL.',
+  {
+    projectId: z.string().min(1).describe('Zibby project to scope to'),
+  },
+  async ({ projectId }) => {
+    const res = await callAppsAPI(`?projectId=${encodeURIComponent(projectId)}`);
+    if (res.error) return { isError: true, content: [{ type: 'text', text: `Network: ${res.error}` }] };
+    if (!res.ok) return { isError: true, content: [{ type: 'text', text: `List failed (${res.status})` }] };
+    return jsonResult(res.body);
+  }
+);
+
+// ── Tool: app status ─────────────────────────────────────────────────────
+server.tool(
+  'zibby_app_status',
+  'Show detailed status of one hosted app instance: task state, sidecar version, agent-ops heartbeat, last incident.',
+  {
+    instanceId: z.string().min(1).describe('Instance id (from zibby_list_apps or zibby_deploy_app)'),
+  },
+  async ({ instanceId }) => {
+    const res = await callAppsAPI(`/${encodeURIComponent(instanceId)}`);
+    if (res.error) return { isError: true, content: [{ type: 'text', text: `Network: ${res.error}` }] };
+    if (!res.ok) return { isError: true, content: [{ type: 'text', text: `Status failed (${res.status})` }] };
+    return jsonResult(res.body);
+  }
+);
+
+// ── Tool: app logs ───────────────────────────────────────────────────────
+server.tool(
+  'zibby_app_logs',
+  'Tail the latest N log lines from one hosted app instance. Both the main app container and the agent-ops sidecar log to the same stream; pass `container` to scope.',
+  {
+    instanceId: z.string().min(1).describe('Instance id'),
+    container: z.enum(['app', 'agent-ops']).optional().describe('Which container; defaults to interleaved'),
+    lines: z.number().int().min(1).max(5000).optional().default(200).describe('How many recent lines'),
+  },
+  async ({ instanceId, container, lines }) => {
+    const qs = new URLSearchParams();
+    if (container) qs.set('container', container);
+    if (lines) qs.set('lines', String(lines));
+    const res = await callAppsAPI(`/${encodeURIComponent(instanceId)}/logs?${qs.toString()}`);
+    if (res.error) return { isError: true, content: [{ type: 'text', text: `Network: ${res.error}` }] };
+    if (!res.ok) return { isError: true, content: [{ type: 'text', text: `Logs failed (${res.status})` }] };
+    return textResult(typeof res.body === 'string' ? res.body : JSON.stringify(res.body, null, 2));
+  }
+);
+
+// ── Daemon MCP proxy ─────────────────────────────────────────────────────
+//
+// Every tool below routes through POST /apps/{id}/mcp on the Zibby
+// backend, which forwards the JSON-RPC body to the per-instance
+// agent-ops daemon using the bridgeToken stored in DDB. This means
+// users never copy a per-instance token into a local mcp.json — one
+// MCP install (@zibby/mcp-cli) covers every instance they own.
+//
+// Each tool wraps `tools/call` with the daemon's matching agent_*
+// builtin (agent_run_now, agent_set_mission, etc.). Helper below
+// keeps the JSON-RPC shape and error handling in one place.
+async function callDaemonTool(instanceId, daemonToolName, args = {}) {
+  const body = {
+    jsonrpc: '2.0',
+    id: Date.now(),
+    method: 'tools/call',
+    params: { name: daemonToolName, arguments: args },
+  };
+  const res = await callAppsAPI(`/${encodeURIComponent(instanceId)}/mcp`, {
+    method: 'POST',
+    body,
+  });
+  if (res.error) return { isError: true, content: [{ type: 'text', text: `Network: ${res.error}` }] };
+  if (!res.ok) {
+    const detail = typeof res.body === 'string' ? res.body : JSON.stringify(res.body || {});
+    return { isError: true, content: [{ type: 'text', text: `Daemon ${daemonToolName} failed (${res.status}): ${detail}` }] };
+  }
+  // The daemon returns a JSON-RPC envelope; surface `result` if present,
+  // otherwise the raw body.
+  const payload = res.body?.result ?? res.body;
+  return jsonResult(payload);
+}
+
+server.tool(
+  'zibby_app_history',
+  'Return the recent run history for an instance: each prior task invocation, exit status, and elapsed time. ' +
+    'Useful for "did the nightly health-check pass?" type questions.',
+  {
+    instanceId: z.string().min(1).describe('Instance id'),
+    limit: z.number().int().min(1).max(100).optional().default(20),
+  },
+  async ({ instanceId, limit }) => callDaemonTool(instanceId, 'agent_history', { limit })
+);
+
+server.tool(
+  'zibby_app_list_tasks',
+  'List scheduled tasks configured on an instance (hourly health checks, weekly upgrades, custom cron jobs ' +
+    'the user added). Returns name, cron expression, prompt template.',
+  {
+    instanceId: z.string().min(1).describe('Instance id'),
+  },
+  async ({ instanceId }) => callDaemonTool(instanceId, 'agent_list_tasks', {})
+);
+
+server.tool(
+  'zibby_app_run_task_now',
+  'Trigger an existing scheduled task to run immediately, out-of-cron. The task name comes from ' +
+    'zibby_app_list_tasks. The daemon kicks off the LLM run async; poll zibby_app_history to see the result.',
+  {
+    instanceId: z.string().min(1).describe('Instance id'),
+    taskName: z.string().min(1).describe('Task name from zibby_app_list_tasks'),
+  },
+  async ({ instanceId, taskName }) => callDaemonTool(instanceId, 'agent_run_now', { name: taskName })
+);
+
+server.tool(
+  'zibby_app_get_mission',
+  'Read the instance\'s persistent "mission" — a free-text instruction the agent-ops daemon ' +
+    'carries across every scheduled task run (e.g. "keep n8n on the latest LTS, never auto-major-upgrade").',
+  {
+    instanceId: z.string().min(1).describe('Instance id'),
+  },
+  async ({ instanceId }) => callDaemonTool(instanceId, 'agent_get_mission', {})
+);
+
+server.tool(
+  'zibby_app_set_mission',
+  'Set the instance\'s persistent mission. Replaces the prior value. Confirm with the user before calling — ' +
+    'changing the mission alters the daemon\'s autonomous behavior on every subsequent task.',
+  {
+    instanceId: z.string().min(1).describe('Instance id'),
+    mission: z.string().min(1).max(4000).describe('Free-text instruction the daemon carries forward'),
+  },
+  async ({ instanceId, mission }) => callDaemonTool(instanceId, 'agent_set_mission', { mission })
+);
+
+// ── Tool: destroy app (guarded) ──────────────────────────────────────────
+server.tool(
+  'zibby_destroy_app',
+  'PERMANENTLY destroy a hosted app instance: stops the Fargate task, detaches EFS, revokes the agent-ops MCP token. ' +
+    'DESTRUCTIVE — the agent MUST confirm with the user and pass confirm:true.',
+  {
+    instanceId: z.string().min(1).describe('Instance id to destroy'),
+    confirm: z.literal(true).describe('Must be true. Set only after user has explicitly authorized destroying this instance.'),
+    keepData: z.boolean().optional().default(false).describe('If true, snapshots the EFS before detach so a future redeploy can restore.'),
+  },
+  async ({ instanceId, keepData }) => {
+    const res = await callAppsAPI(`/${encodeURIComponent(instanceId)}`, {
+      method: 'DELETE',
+      body: { keepData },
+    });
+    if (res.error) return { isError: true, content: [{ type: 'text', text: `Network: ${res.error}` }] };
+    if (!res.ok) return { isError: true, content: [{ type: 'text', text: `Destroy failed (${res.status})` }] };
+    return jsonResult(res.body);
+  }
+);
+
 // ── Connect ─────────────────────────────────────────────────────────────
 
 await server.connect(new StdioServerTransport());

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zibby/mcp-cli",
-  "version": "0.1.0",
+  "version": "0.2.1",
   "description": "Zibby CLI MCP Server — expose Zibby workflow deploy/run/debug to AI agents (Claude, Cursor, Codex, Gemini)",
   "type": "module",
   "main": "index.js",