@integrity-labs/agt-cli 0.14.15 → 0.15.0

package/mcp/index.js

@@ -21009,6 +21009,7 @@ var AGT_HOST = process.env.AGT_HOST;
 var AGT_API_KEY = process.env.AGT_API_KEY;
 var AGT_AGENT_ID = process.env.AGT_AGENT_ID;
 var AGT_AGENT_CODE_NAME = process.env.AGT_AGENT_CODE_NAME;
+var AGT_APP_URL = (process.env.AGT_APP_URL ?? "").replace(/\/+$/, "");
 var AGT_TOKEN = process.env.AGT_TOKEN ?? "";
 if (!AGT_HOST || !AGT_AGENT_ID || !AGT_TOKEN && !AGT_API_KEY) {
   console.error(
@@ -21935,6 +21936,169 @@ server.tool(
     return { content: [{ type: "text", text: lines.join("\n") }] };
   }
 );
+var WidgetDefSchema = external_exports.object({
+  id: external_exports.string().describe("Stable id within the dashboard, e.g. 'kpi.revenue' or 'chart.cashflow'."),
+  kind: external_exports.enum(["kpi", "area", "line", "bar", "donut"]).describe(
+    "Widget kind. The kind picks both the renderer AND the data shape your refresh must produce:\n  kpi   \u2192 { value, [delta], [deltaTone: positive|negative|neutral], [values: number[]], [color: '#rrggbb'], [label] }\n  area  \u2192 { categories: string[], series: [{ name, data: number[] }] }\n  line  \u2192 { categories: string[], series: [{ name, data: number[] }] }\n  bar   \u2192 { categories: string[], series: [{ name, data: number[] }] }\n  donut \u2192 { labels: string[], series: number[] }"
+  ),
+  title: external_exports.string().optional().describe("Title shown above the widget."),
+  prompt: external_exports.string().describe("What future-you reads on every refresh. Tight, specific \u2014 e.g. 'Total Xero revenue last 30 days. value as $NN.NN, delta vs prior 30d, values = daily revenue.'"),
+  refresh_cron: external_exports.string().optional().describe('Optional per-widget cron override (e.g. "0 6 * * *" for 6am daily).')
+});
+server.tool(
+  "dashboards.list",
+  'List dashboards visible to your team. Use to answer "what dashboards exist", "show me the dashboards I built", or before authoring a new one to avoid duplicating an existing slug.',
+  {
+    status: external_exports.enum(["draft", "active", "archived"]).optional().describe("Filter by status. Defaults to 'active'.")
+  },
+  async (params) => {
+    const data = await apiPost("/host/dashboards/list", {
+      agent_id: AGT_AGENT_ID,
+      // Don't force a default — let the server decide (currently draft +
+      // active so a freshly-authored draft surfaces without a publish step).
+      status: params.status
+    });
+    if (!data.dashboards.length) return { content: [{ type: "text", text: "No dashboards yet." }] };
+    const lines = data.dashboards.map((d) => {
+      const url = AGT_APP_URL ? ` ${AGT_APP_URL}/dashboards/${d.id}` : "";
+      return `- ${d.title} \`${d.slug}\` \u2014 ${d.scope}/${d.status} \xB7 refreshed: ${d.last_refreshed_at ?? "never"}${url}`;
+    });
+    return { content: [{ type: "text", text: `Dashboards (${data.dashboards.length}):
+${lines.join("\n")}` }] };
+  }
+);
+server.tool(
+  "dashboards.show",
+  "Get full metadata for one dashboard by slug \u2014 title, description, scope, status, widget list, last refresh per widget. Use when investigating a specific dashboard or before editing it via dashboards.upsert.",
+  {
+    slug: external_exports.string().describe("Dashboard slug, e.g. 'finance-overview'.")
+  },
+  async (params) => {
+    const data = await apiPost("/host/dashboards/show", {
+      agent_id: AGT_AGENT_ID,
+      slug: params.slug
+    });
+    const d = data.dashboard;
+    const widgetLines = (d.widgets ?? []).map((w) => {
+      const last = d.structured_data?.[w.id]?.refreshed_at ?? "never";
+      return `  - ${w.title ?? w.id} \`${w.id}\` (${w.kind}) \u2014 refreshed: ${last}`;
+    });
+    const url = AGT_APP_URL ? `${AGT_APP_URL}/dashboards/${d.id}` : null;
+    const out = [
+      `# ${d.title} \`${d.slug}\``,
+      d.description ? `
+${d.description}` : "",
+      url ? `
+URL: ${url}` : "",
+      "",
+      `Scope: ${d.scope} \xB7 Status: ${d.status} \xB7 Version: ${d.version}`,
+      `Last refreshed: ${d.last_refreshed_at ?? "never"}`,
+      "",
+      `## Widgets (${d.widgets?.length ?? 0})`,
+      ...widgetLines.length ? widgetLines : ["  (none)"]
+    ];
+    return { content: [{ type: "text", text: out.join("\n") }] };
+  }
+);
+server.tool(
+  "dashboards.upsert",
+  // The description leads with the user phrasings the agent should match
+  // against AND the explicit forbidden alternatives. Tool selection weights
+  // the first sentence heavily, so we burn it on the right behavior.
+  'Create or update a dashboard owned by this agent. THIS is how you ship dashboards \u2014 when a user asks you to "build a dashboard", "make a chart", "create a report", "track X over time", or "summarize Y as a dashboard", reach for THIS tool. Do NOT generate static HTML, push to GitHub Pages or S3, take a Chrome-headless screenshot, or sendPhoto via Telegram unless the user explicitly asks for one of those formats. Dashboards built through this tool render in the Augmented console, refresh on demand via your runtime, and follow team scope/policy. New rows pin to scope=agent \u2014 widening to team/org is admin-only. Slug must be unique per agent. Bumps version on every write.',
+  {
+    slug: external_exports.string().describe('Kebab-case identifier, unique per agent (e.g. "eng-overview").'),
+    title: external_exports.string().describe("Title shown at the top of the dashboard and in the list view."),
+    description: external_exports.string().optional().describe("One-line description for the list view."),
+    widgets: external_exports.array(WidgetDefSchema).describe("Widget definitions. Each widget needs id, kind, prompt. Mix kinds \u2014 KPI tiles for headlines, area/line for trends, bar for comparisons, donut for proportions. Schema is derived server-side from kind \u2014 you do not author it.")
+  },
+  async (params) => {
+    const data = await apiPost(
+      "/host/dashboards/upsert",
+      {
+        agent_id: AGT_AGENT_ID,
+        slug: params.slug,
+        title: params.title,
+        description: params.description,
+        // The webapp renders standard chrome from the kind-driven widget
+        // list. Stored html / csp / *_domains are no longer agent-authored;
+        // server fills empty defaults if you don't pass any.
+        widgets: params.widgets
+      }
+    );
+    const base = AGT_APP_URL || "<console-origin>";
+    const url = `${base}/dashboards/${data.dashboard_id}`;
+    return {
+      content: [
+        {
+          type: "text",
+          text: `Dashboard \`${data.slug}\` saved at version ${data.version} (${data.scope}/${data.status}).
+URL: ${url}
+` + (AGT_APP_URL ? "When you tell the user it's live, ALWAYS quote this full URL \u2014 never paste a relative path like /dashboards." : "AGT_APP_URL is not set on this host \u2014 replace <console-origin> with your console URL before quoting to the user, or ask the operator to set AGT_APP_URL.")
+        }
+      ]
+    };
+  }
+);
+server.tool(
+  "dashboards.request_refresh",
+  "Mark widgets on a dashboard as needing refresh. Use this when authoring a new dashboard (to populate the first snapshot) or when you want widgets to update on the next dashboards.pending_refreshes call. Pass widget_id to flag just one widget; omit to flag every widget.",
+  {
+    slug: external_exports.string(),
+    widget_id: external_exports.string().optional().describe("Optional. Omit to flag all widgets on the dashboard."),
+    reason: external_exports.string().optional()
+  },
+  async (params) => {
+    const data = await apiPost(
+      "/host/dashboards/request-refresh",
+      {
+        agent_id: AGT_AGENT_ID,
+        slug: params.slug,
+        widget_id: params.widget_id,
+        reason: params.reason
+      }
+    );
+    return { content: [{ type: "text", text: `Flagged ${data.widget_ids.length} widget(s) pending refresh on \`${params.slug}\`.` }] };
+  }
+);
+server.tool(
+  "dashboards.pending_refreshes",
+  "Return widgets that need refresh \u2014 by default ONLY those flagged pending (user clicked \u21BB in the iframe, or someone called request_refresh). Pass slug=<dashboard slug> to instead get every widget on that dashboard so you can proactively refresh after authoring or when the user asks 'update the X dashboard'. Pass include_all=true with no slug to get every flagged-or-not widget across all your dashboards. Each entry: {slug, widget_id, kind, prompt, schema, requested_at}. Loop over them, read the prompt, gather data with your other tools, match the schema, and call dashboards.persist_widget for each.",
+  {
+    slug: external_exports.string().optional().describe("Restrict to one dashboard by slug. When set, returns every widget on that dashboard \u2014 flagged or not \u2014 so you can refresh the whole thing without calling request_refresh first."),
+    include_all: external_exports.boolean().optional().describe("When true (and no slug), returns every widget on every dashboard you own \u2014 flagged or not. Use sparingly; one refresh = one LLM call.")
+  },
+  async (params) => {
+    const data = await apiPost("/host/dashboards/pending", {
+      agent_id: AGT_AGENT_ID,
+      slug: params.slug,
+      include_all: params.include_all
+    });
+    if (!data.pending.length) {
+      const hint = params.slug ? `No widgets on dashboard \`${params.slug}\` (or the dashboard isn't yours).` : "No widgets are flagged for refresh. To refresh a specific dashboard now, call this with `slug` set \u2014 that returns every widget on it. To refresh all your dashboards, pass `include_all: true`.";
+      return { content: [{ type: "text", text: hint }] };
+    }
+    return { content: [{ type: "text", text: JSON.stringify(data.pending, null, 2) }] };
+  }
+);
+server.tool(
+  "dashboards.persist_widget",
+  "Persist refreshed data for one widget. The platform validates `data` against the widget's stored JSON Schema server-side \u2014 invalid output is rejected. Call this once per widget after gathering data with your tools.",
+  {
+    slug: external_exports.string(),
+    widget_id: external_exports.string(),
+    data: external_exports.unknown().describe("JSON value matching the widget kind's schema.")
+  },
+  async (params) => {
+    const result = await apiPost("/host/dashboards/persist", {
+      agent_id: AGT_AGENT_ID,
+      slug: params.slug,
+      widget_id: params.widget_id,
+      data: params.data
+    });
+    return { content: [{ type: "text", text: `Persisted \`${params.widget_id}\` on \`${params.slug}\` (refreshed ${result.refreshed_at}).` }] };
+  }
+);
 function groupByStatus(items) {
   const groups = {};
   for (const item of items) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@integrity-labs/agt-cli",
-  "version": "0.14.15",
+  "version": "0.15.0",
   "description": "Augmented Team CLI — agent provisioning and management",
   "type": "module",
   "engines": {