npm - agentcheck-sdk - Versions diffs - 0.2.0 → 0.4.0 - Mend

agentcheck-sdk 0.2.0 → 0.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (9) hide show

package/dist/dashboard.d.ts ADDED Viewed

@@ -0,0 +1,36 @@
+import { AgentCheckClient } from "./client";
+export interface DashboardConfig {
+    /** Title shown at the top */
+    title?: string;
+    /** Auto-refresh interval in seconds (0 = off) */
+    refreshInterval?: number;
+    /** Max records to show */
+    limit?: number;
+}
+/**
+ * DelegationDashboard - Embeddable HTML widget for agent delegation status.
+ *
+ * Generates a self-contained HTML snippet that shows:
+ * - Active delegations with status badges
+ * - Recent execution logs
+ * - Quick actions (revoke)
+ *
+ * Usage (Express):
+ *   app.get('/admin/delegations', async (req, res) => {
+ *     const html = await dashboard.render();
+ *     res.send(html);
+ *   });
+ *
+ * Usage (embed in existing page):
+ *   const html = await dashboard.renderWidget();
+ *   // Insert into your page's <div id="delegation-widget">
+ */
+export declare class DelegationDashboard {
+    private client;
+    private config;
+    constructor(client: AgentCheckClient, config?: DashboardConfig);
+    /** Render full HTML page with dashboard. */
+    render(): Promise<string>;
+    /** Render widget HTML (for embedding in existing pages). */
+    renderWidget(): Promise<string>;
+}

package/dist/dashboard.js ADDED Viewed

@@ -0,0 +1,101 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DelegationDashboard = void 0;
+/**
+ * DelegationDashboard - Embeddable HTML widget for agent delegation status.
+ *
+ * Generates a self-contained HTML snippet that shows:
+ * - Active delegations with status badges
+ * - Recent execution logs
+ * - Quick actions (revoke)
+ *
+ * Usage (Express):
+ *   app.get('/admin/delegations', async (req, res) => {
+ *     const html = await dashboard.render();
+ *     res.send(html);
+ *   });
+ *
+ * Usage (embed in existing page):
+ *   const html = await dashboard.renderWidget();
+ *   // Insert into your page's <div id="delegation-widget">
+ */
+class DelegationDashboard {
+    constructor(client, config = {}) {
+        this.client = client;
+        this.config = {
+            title: config.title ?? "Agent Delegations",
+            refreshInterval: config.refreshInterval ?? 30,
+            limit: config.limit ?? 20,
+        };
+    }
+    /** Render full HTML page with dashboard. */
+    async render() {
+        const widget = await this.renderWidget();
+        const refresh = this.config.refreshInterval > 0
+            ? `<meta http-equiv="refresh" content="${this.config.refreshInterval}">`
+            : "";
+        return `<!DOCTYPE html>
+<html><head><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1">
+${refresh}
+<title>${this.config.title}</title>
+<style>${DASHBOARD_CSS}</style>
+</head><body>${widget}</body></html>`;
+    }
+    /** Render widget HTML (for embedding in existing pages). */
+    async renderWidget() {
+        const list = await this.client.list({ limit: this.config.limit });
+        const records = list.records;
+        const statusCounts = {};
+        for (const r of records) {
+            statusCounts[r.status] = (statusCounts[r.status] || 0) + 1;
+        }
+        const summaryCards = Object.entries(statusCounts)
+            .map(([status, count]) => `<div class="ac-card"><div class="ac-card-num">${count}</div><div class="ac-card-label">${status}</div></div>`).join("\n");
+        const rows = records
+            .map((r) => {
+            const statusClass = r.status === "approved" ? "ac-approved"
+                : r.status === "revoked" ? "ac-revoked"
+                    : r.status === "expired" ? "ac-expired"
+                        : "ac-pending";
+            return `<tr>
+          <td><span class="ac-badge ${statusClass}">${r.status}</span></td>
+          <td>${r.agent}</td>
+          <td title="${r.scope}">${r.scope.length > 60 ? r.scope.slice(0, 60) + "..." : r.scope}</td>
+          <td>${r.authorized_by}</td>
+          <td>${new Date(r.created_at).toLocaleDateString()}</td>
+          <td><a href="${r.verify_url}" target="_blank">Verify</a></td>
+        </tr>`;
+        }).join("\n");
+        return `<div class="ac-dashboard">
+  <h2 class="ac-title">${this.config.title}</h2>
+  <div class="ac-cards">${summaryCards}</div>
+  <table class="ac-table">
+    <thead><tr>
+      <th>Status</th><th>Agent</th><th>Scope</th><th>Authorized by</th><th>Created</th><th>Verify</th>
+    </tr></thead>
+    <tbody>${rows}</tbody>
+  </table>
+  <div class="ac-footer">${records.length} delegation(s) | ${this.config.refreshInterval > 0 ? `Auto-refresh: ${this.config.refreshInterval}s` : "Manual refresh"}</div>
+</div>
+<style>${DASHBOARD_CSS}</style>`;
+    }
+}
+exports.DelegationDashboard = DelegationDashboard;
+const DASHBOARD_CSS = `
+.ac-dashboard{font-family:-apple-system,BlinkMacSystemFont,"Segoe UI",sans-serif;max-width:960px;margin:0 auto;padding:24px;}
+.ac-title{font-size:20px;font-weight:700;margin:0 0 20px;color:#1e293b;}
+.ac-cards{display:flex;gap:12px;margin-bottom:20px;flex-wrap:wrap;}
+.ac-card{background:#fff;border:1px solid #e5e7eb;border-radius:10px;padding:16px 20px;min-width:100px;text-align:center;}
+.ac-card-num{font-size:28px;font-weight:800;color:#1e293b;}
+.ac-card-label{font-size:12px;color:#64748b;text-transform:uppercase;letter-spacing:.5px;margin-top:4px;}
+.ac-table{width:100%;border-collapse:collapse;background:#fff;border-radius:10px;overflow:hidden;border:1px solid #e5e7eb;}
+.ac-table th{padding:10px 14px;text-align:left;font-size:12px;font-weight:700;color:#475569;background:#f8fafc;border-bottom:2px solid #e5e7eb;}
+.ac-table td{padding:10px 14px;font-size:13px;color:#555;border-bottom:1px solid #f0f0f0;}
+.ac-table a{color:#2563eb;font-size:12px;}
+.ac-badge{display:inline-block;padding:2px 10px;border-radius:9999px;font-size:11px;font-weight:700;color:#fff;}
+.ac-approved{background:#16a34a;}
+.ac-pending{background:#ca8a04;}
+.ac-revoked{background:#dc2626;}
+.ac-expired{background:#6b7280;}
+.ac-footer{text-align:center;color:#94a3b8;font-size:12px;margin-top:16px;}
+`;

package/dist/index.d.ts CHANGED Viewed

@@ -3,6 +3,9 @@ export { WebhookHandler } from "./webhook";
 export { DelegationProvider } from "./provider";
 export { delegationGuard } from "./guard";
 export { AgentToolChecker } from "./langchain";
+export { DelegationDashboard } from "./dashboard";
+export { quickStart } from "./quickstart";
+export { templates } from "./templates";
 export type { WebhookEvent } from "./webhook";
 export type { ScopeVerifier, DelegationProviderConfig } from "./provider";
 export type { GuardConfig } from "./guard";

package/dist/index.js CHANGED Viewed

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.RateLimitError = exports.ValidationError = exports.NotFoundError = exports.AuthenticationError = exports.AgentCheckError = exports.AgentToolChecker = exports.delegationGuard = exports.DelegationProvider = exports.WebhookHandler = exports.AgentCheckClient = void 0;
+exports.RateLimitError = exports.ValidationError = exports.NotFoundError = exports.AuthenticationError = exports.AgentCheckError = exports.templates = exports.quickStart = exports.DelegationDashboard = exports.AgentToolChecker = exports.delegationGuard = exports.DelegationProvider = exports.WebhookHandler = exports.AgentCheckClient = void 0;
 // Individual commands (basic menu)
 var client_1 = require("./client");
 Object.defineProperty(exports, "AgentCheckClient", { enumerable: true, get: function () { return client_1.AgentCheckClient; } });
@@ -13,6 +13,12 @@ var guard_1 = require("./guard");
 Object.defineProperty(exports, "delegationGuard", { enumerable: true, get: function () { return guard_1.delegationGuard; } });
 var langchain_1 = require("./langchain");
 Object.defineProperty(exports, "AgentToolChecker", { enumerable: true, get: function () { return langchain_1.AgentToolChecker; } });
+var dashboard_1 = require("./dashboard");
+Object.defineProperty(exports, "DelegationDashboard", { enumerable: true, get: function () { return dashboard_1.DelegationDashboard; } });
+var quickstart_1 = require("./quickstart");
+Object.defineProperty(exports, "quickStart", { enumerable: true, get: function () { return quickstart_1.quickStart; } });
+var templates_1 = require("./templates");
+Object.defineProperty(exports, "templates", { enumerable: true, get: function () { return templates_1.templates; } });
 var errors_1 = require("./errors");
 Object.defineProperty(exports, "AgentCheckError", { enumerable: true, get: function () { return errors_1.AgentCheckError; } });
 Object.defineProperty(exports, "AuthenticationError", { enumerable: true, get: function () { return errors_1.AuthenticationError; } });

package/dist/quickstart.d.ts ADDED Viewed

@@ -0,0 +1,29 @@
+import { AgentCheckClient } from "./client";
+import { DelegationDashboard } from "./dashboard";
+import { AgentToolChecker } from "./langchain";
+import { DelegationProvider, ScopeVerifier } from "./provider";
+export interface QuickStartConfig {
+    apiKey?: string;
+    baseUrl?: string;
+    verifyScope?: ScopeVerifier;
+}
+export interface AgentCheckBundle {
+    client: AgentCheckClient;
+    provider: DelegationProvider;
+    dashboard: DelegationDashboard;
+    checker: (agentName: string) => AgentToolChecker;
+}
+/**
+ * Setup everything in one call.
+ *
+ * Usage:
+ *   const ac = quickStart({ apiKey: "ak_live_..." });
+ *   // or reads from AGENTCHECK_API_KEY env var
+ *   const ac = quickStart();
+ *
+ *   ac.provider.canAct("bot", "action");
+ *   ac.client.record({ ... });
+ *   ac.dashboard.render();
+ *   const safe = ac.checker("bot").wrap("tool", fn);
+ */
+export declare function quickStart(config?: QuickStartConfig): AgentCheckBundle;

package/dist/quickstart.js ADDED Viewed

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.quickStart = quickStart;
+const client_1 = require("./client");
+const dashboard_1 = require("./dashboard");
+const langchain_1 = require("./langchain");
+const provider_1 = require("./provider");
+/**
+ * Setup everything in one call.
+ *
+ * Usage:
+ *   const ac = quickStart({ apiKey: "ak_live_..." });
+ *   // or reads from AGENTCHECK_API_KEY env var
+ *   const ac = quickStart();
+ *
+ *   ac.provider.canAct("bot", "action");
+ *   ac.client.record({ ... });
+ *   ac.dashboard.render();
+ *   const safe = ac.checker("bot").wrap("tool", fn);
+ */
+function quickStart(config = {}) {
+    const apiKey = config.apiKey || process.env.AGENTCHECK_API_KEY || "";
+    const baseUrl = config.baseUrl ||
+        process.env.AGENTCHECK_BASE_URL ||
+        "https://agentcheck.spaceplanning.work";
+    if (!apiKey) {
+        throw new Error("Provide apiKey or set AGENTCHECK_API_KEY environment variable");
+    }
+    const client = new client_1.AgentCheckClient(apiKey, baseUrl);
+    const provider = new provider_1.DelegationProvider(client, {
+        verifyScope: config.verifyScope,
+    });
+    const dashboard = new dashboard_1.DelegationDashboard(client);
+    return {
+        client,
+        provider,
+        dashboard,
+        checker: (agentName) => new langchain_1.AgentToolChecker(provider, agentName),
+    };
+}

package/dist/templates.d.ts ADDED Viewed

@@ -0,0 +1,33 @@
+/**
+ * Scope Templates - Pre-built scope definitions for common use cases.
+ *
+ * Usage:
+ *   import { templates } from "agentcheck-sdk";
+ *   client.record({
+ *     agent: "maintenance-bot",
+ *     scope: templates.manufacturing({ maxOrderAmount: 10000 }),
+ *     authorized_by: "manager@company.com",
+ *   });
+ */
+export declare const templates: {
+    manufacturing(opts?: {
+        maxOrderAmount?: number;
+        currency?: string;
+    }): string;
+    customerSupport(opts?: {
+        maxRefund?: number;
+        currency?: string;
+    }): string;
+    devops(opts?: {
+        environments?: string[];
+    }): string;
+    finance(opts?: {
+        maxTransaction?: number;
+        currency?: string;
+        assetClasses?: string[];
+    }): string;
+    dataPipeline(opts?: {
+        databases?: string[];
+    }): string;
+    general(actions: string[]): string;
+};

package/dist/templates.js ADDED Viewed

@@ -0,0 +1,40 @@
+"use strict";
+/**
+ * Scope Templates - Pre-built scope definitions for common use cases.
+ *
+ * Usage:
+ *   import { templates } from "agentcheck-sdk";
+ *   client.record({
+ *     agent: "maintenance-bot",
+ *     scope: templates.manufacturing({ maxOrderAmount: 10000 }),
+ *     authorized_by: "manager@company.com",
+ *   });
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.templates = void 0;
+exports.templates = {
+    manufacturing(opts = {}) {
+        const { maxOrderAmount = 10000, currency = "USD" } = opts;
+        return `Monitor equipment 24/7. Order replacement parts up to ${currency} ${maxOrderAmount.toLocaleString()}. Generate maintenance reports. Alert on anomalies.`;
+    },
+    customerSupport(opts = {}) {
+        const { maxRefund = 500, currency = "USD" } = opts;
+        return `Access customer profiles (read-only). Issue refunds up to ${currency} ${maxRefund.toLocaleString()}. Create support tickets. Escalate to human agent for amounts over ${currency} ${maxRefund.toLocaleString()}.`;
+    },
+    devops(opts = {}) {
+        const envs = (opts.environments || ["staging"]).join(", ");
+        return `Deploy to ${envs}. Rollback on failure. Monitor server health. Restart services on crash. Cannot modify production database directly.`;
+    },
+    finance(opts = {}) {
+        const { maxTransaction = 10000, currency = "USD" } = opts;
+        const assets = (opts.assetClasses || ["stocks", "bonds"]).join(", ");
+        return `Execute trades up to ${currency} ${maxTransaction.toLocaleString()} per transaction. Asset classes: ${assets}. Generate daily P&L reports. Cannot withdraw funds.`;
+    },
+    dataPipeline(opts = {}) {
+        const dbs = (opts.databases || ["analytics"]).join(", ");
+        return `Read from production database. Write to ${dbs} database(s). Run ETL jobs on schedule. Cannot modify production schema. Cannot delete records.`;
+    },
+    general(actions) {
+        return `Allowed actions: ${actions.join(", ")}.`;
+    },
+};

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "agentcheck-sdk",
-  "version": "0.2.0",
+  "version": "0.4.0",
   "description": "Record what your AI agent is allowed to do",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",