toolgate 1.0.0 → 1.0.1

package/dist/index.d.mts

@@ -128,6 +128,36 @@ declare class ToolGate {
  */
 declare function cliApproval(request: ApprovalRequest): Promise<ApprovalResult>;
 
+interface DashboardApprovalConfig {
+    supabaseUrl: string;
+    supabaseKey: string;
+    /** Polling interval in ms (default: 2000) */
+    pollInterval?: number;
+    /** Timeout in ms — reject all if no response (default: 10 minutes) */
+    timeout?: number;
+    /** Called each poll cycle — for logging */
+    onPoll?: (elapsed: number) => void;
+}
+/**
+ * Returns an `onApprovalNeeded` callback that:
+ * 1. Saves the session to Supabase (so it appears in the dashboard)
+ * 2. Polls until a human approves/rejects via the dashboard UI
+ * 3. Returns the decisions so ToolGate can execute approved actions
+ *
+ * Usage:
+ *   const gate = new ToolGate(executor, {
+ *     ...dashboardApproval({
+ *       supabaseUrl: "https://xxx.supabase.co",
+ *       supabaseKey: "eyJ...",
+ *     }),
+ *   });
+ */
+declare function dashboardApproval(config: DashboardApprovalConfig): {
+    supabaseUrl: string;
+    supabaseKey: string;
+    onApprovalNeeded: (request: ApprovalRequest) => Promise<ApprovalResult>;
+};
+
 declare function classifyTool(toolName: string, params: Record<string, unknown>, mcpToolDef?: MCPToolDef): ToolClassification;
 
 /**
@@ -162,4 +192,4 @@ declare function autoConfigFromMCP(servers: Array<{
     url: string;
 }>, overrides?: Partial<ToolGateConfig>): Promise<ToolGateConfig>;
 
-export { type ActionDecision, type ApprovalRequest, type ApprovalResult, type ExecutedRead, type MCPServerDef, type MCPToolDef, type PendingAction, type RealExecutor, type Session, type SessionStatus, type ToolCall, type ToolClassification, ToolGate, type ToolGateConfig, type ToolIntent, autoConfigFromMCP, classifyTool, cliApproval, discoverMCPTools, mcpToolGate };
+export { type ActionDecision, type ApprovalRequest, type ApprovalResult, type DashboardApprovalConfig, type ExecutedRead, type MCPServerDef, type MCPToolDef, type PendingAction, type RealExecutor, type Session, type SessionStatus, type ToolCall, type ToolClassification, ToolGate, type ToolGateConfig, type ToolIntent, autoConfigFromMCP, classifyTool, cliApproval, dashboardApproval, discoverMCPTools, mcpToolGate };

package/dist/index.d.ts

@@ -128,6 +128,36 @@ declare class ToolGate {
  */
 declare function cliApproval(request: ApprovalRequest): Promise<ApprovalResult>;
 
+interface DashboardApprovalConfig {
+    supabaseUrl: string;
+    supabaseKey: string;
+    /** Polling interval in ms (default: 2000) */
+    pollInterval?: number;
+    /** Timeout in ms — reject all if no response (default: 10 minutes) */
+    timeout?: number;
+    /** Called each poll cycle — for logging */
+    onPoll?: (elapsed: number) => void;
+}
+/**
+ * Returns an `onApprovalNeeded` callback that:
+ * 1. Saves the session to Supabase (so it appears in the dashboard)
+ * 2. Polls until a human approves/rejects via the dashboard UI
+ * 3. Returns the decisions so ToolGate can execute approved actions
+ *
+ * Usage:
+ *   const gate = new ToolGate(executor, {
+ *     ...dashboardApproval({
+ *       supabaseUrl: "https://xxx.supabase.co",
+ *       supabaseKey: "eyJ...",
+ *     }),
+ *   });
+ */
+declare function dashboardApproval(config: DashboardApprovalConfig): {
+    supabaseUrl: string;
+    supabaseKey: string;
+    onApprovalNeeded: (request: ApprovalRequest) => Promise<ApprovalResult>;
+};
+
 declare function classifyTool(toolName: string, params: Record<string, unknown>, mcpToolDef?: MCPToolDef): ToolClassification;
 
 /**
@@ -162,4 +192,4 @@ declare function autoConfigFromMCP(servers: Array<{
     url: string;
 }>, overrides?: Partial<ToolGateConfig>): Promise<ToolGateConfig>;
 
-export { type ActionDecision, type ApprovalRequest, type ApprovalResult, type ExecutedRead, type MCPServerDef, type MCPToolDef, type PendingAction, type RealExecutor, type Session, type SessionStatus, type ToolCall, type ToolClassification, ToolGate, type ToolGateConfig, type ToolIntent, autoConfigFromMCP, classifyTool, cliApproval, discoverMCPTools, mcpToolGate };
+export { type ActionDecision, type ApprovalRequest, type ApprovalResult, type DashboardApprovalConfig, type ExecutedRead, type MCPServerDef, type MCPToolDef, type PendingAction, type RealExecutor, type Session, type SessionStatus, type ToolCall, type ToolClassification, ToolGate, type ToolGateConfig, type ToolIntent, autoConfigFromMCP, classifyTool, cliApproval, dashboardApproval, discoverMCPTools, mcpToolGate };

package/dist/index.js

@@ -34,6 +34,7 @@ __export(index_exports, {
   autoConfigFromMCP: () => autoConfigFromMCP,
   classifyTool: () => classifyTool,
   cliApproval: () => cliApproval,
+  dashboardApproval: () => dashboardApproval,
   discoverMCPTools: () => discoverMCPTools,
   mcpToolGate: () => mcpToolGate
 });
@@ -256,6 +257,18 @@ var SupabasePersistence = class {
       metadata: session.metadata ? JSON.stringify(session.metadata) : null
     });
   }
+  async getSession(id) {
+    const endpoint = `${this.url}/rest/v1/toolgate_sessions?id=eq.${id}&select=*`;
+    const res = await fetch(endpoint, {
+      headers: {
+        apikey: this.key,
+        Authorization: `Bearer ${this.key}`
+      }
+    });
+    if (!res.ok) return null;
+    const rows = await res.json();
+    return rows[0] ?? null;
+  }
   async updateSession(session) {
     await this.rpc(
       "toolgate_sessions",
@@ -572,6 +585,53 @@ ${badge(a.classification.intent)} ${a.name}`);
   return { sessionId: request.sessionId, decisions, approvedAt: Date.now() };
 }
 
+// src/core/dashboard-approval.ts
+function dashboardApproval(config) {
+  const persistence = new SupabasePersistence(config.supabaseUrl, config.supabaseKey);
+  const pollMs = config.pollInterval ?? 2e3;
+  const timeoutMs = config.timeout ?? 10 * 60 * 1e3;
+  const onApprovalNeeded = async (request) => {
+    console.log(`
+\u{1F310} Session saved to dashboard \u2014 waiting for approval...`);
+    console.log(`   Open your dashboard and review session ${request.sessionId.slice(0, 8)}\u2026
+`);
+    const start = Date.now();
+    while (true) {
+      const elapsed = Date.now() - start;
+      if (elapsed > timeoutMs) {
+        console.log(`\u23F0 Timeout \u2014 rejecting all actions.`);
+        const decisions = new Map(
+          request.pendingActions.map((a) => [a.id, { action: "reject" }])
+        );
+        return { sessionId: request.sessionId, decisions, approvedAt: Date.now() };
+      }
+      const row = await persistence.getSession(request.sessionId);
+      if (row && row.status !== "pending_approval") {
+        console.log(`\u2705 Dashboard response received: ${row.status}`);
+        const actions = typeof row.pending_actions === "string" ? JSON.parse(row.pending_actions) : row.pending_actions;
+        const decisions = /* @__PURE__ */ new Map();
+        for (const a of actions) {
+          if (a.approved && a.editedParams) {
+            decisions.set(a.id, { action: "edit", actionId: a.id, newParams: a.editedParams });
+          } else if (a.approved) {
+            decisions.set(a.id, { action: "approve" });
+          } else {
+            decisions.set(a.id, { action: "reject" });
+          }
+        }
+        return { sessionId: request.sessionId, decisions, approvedAt: Date.now() };
+      }
+      if (config.onPoll) config.onPoll(elapsed);
+      await new Promise((r) => setTimeout(r, pollMs));
+    }
+  };
+  return {
+    supabaseUrl: config.supabaseUrl,
+    supabaseKey: config.supabaseKey,
+    onApprovalNeeded
+  };
+}
+
 // src/mcp/index.ts
 function mcpToolGate(executor, config = {}) {
   return new ToolGate(executor, config);
@@ -611,6 +671,7 @@ async function autoConfigFromMCP(servers, overrides = {}) {
   autoConfigFromMCP,
   classifyTool,
   cliApproval,
+  dashboardApproval,
   discoverMCPTools,
   mcpToolGate
 });

package/dist/index.mjs

@@ -215,6 +215,18 @@ var SupabasePersistence = class {
       metadata: session.metadata ? JSON.stringify(session.metadata) : null
     });
   }
+  async getSession(id) {
+    const endpoint = `${this.url}/rest/v1/toolgate_sessions?id=eq.${id}&select=*`;
+    const res = await fetch(endpoint, {
+      headers: {
+        apikey: this.key,
+        Authorization: `Bearer ${this.key}`
+      }
+    });
+    if (!res.ok) return null;
+    const rows = await res.json();
+    return rows[0] ?? null;
+  }
   async updateSession(session) {
     await this.rpc(
       "toolgate_sessions",
@@ -531,6 +543,53 @@ ${badge(a.classification.intent)} ${a.name}`);
   return { sessionId: request.sessionId, decisions, approvedAt: Date.now() };
 }
 
+// src/core/dashboard-approval.ts
+function dashboardApproval(config) {
+  const persistence = new SupabasePersistence(config.supabaseUrl, config.supabaseKey);
+  const pollMs = config.pollInterval ?? 2e3;
+  const timeoutMs = config.timeout ?? 10 * 60 * 1e3;
+  const onApprovalNeeded = async (request) => {
+    console.log(`
+\u{1F310} Session saved to dashboard \u2014 waiting for approval...`);
+    console.log(`   Open your dashboard and review session ${request.sessionId.slice(0, 8)}\u2026
+`);
+    const start = Date.now();
+    while (true) {
+      const elapsed = Date.now() - start;
+      if (elapsed > timeoutMs) {
+        console.log(`\u23F0 Timeout \u2014 rejecting all actions.`);
+        const decisions = new Map(
+          request.pendingActions.map((a) => [a.id, { action: "reject" }])
+        );
+        return { sessionId: request.sessionId, decisions, approvedAt: Date.now() };
+      }
+      const row = await persistence.getSession(request.sessionId);
+      if (row && row.status !== "pending_approval") {
+        console.log(`\u2705 Dashboard response received: ${row.status}`);
+        const actions = typeof row.pending_actions === "string" ? JSON.parse(row.pending_actions) : row.pending_actions;
+        const decisions = /* @__PURE__ */ new Map();
+        for (const a of actions) {
+          if (a.approved && a.editedParams) {
+            decisions.set(a.id, { action: "edit", actionId: a.id, newParams: a.editedParams });
+          } else if (a.approved) {
+            decisions.set(a.id, { action: "approve" });
+          } else {
+            decisions.set(a.id, { action: "reject" });
+          }
+        }
+        return { sessionId: request.sessionId, decisions, approvedAt: Date.now() };
+      }
+      if (config.onPoll) config.onPoll(elapsed);
+      await new Promise((r) => setTimeout(r, pollMs));
+    }
+  };
+  return {
+    supabaseUrl: config.supabaseUrl,
+    supabaseKey: config.supabaseKey,
+    onApprovalNeeded
+  };
+}
+
 // src/mcp/index.ts
 function mcpToolGate(executor, config = {}) {
   return new ToolGate(executor, config);
@@ -569,6 +628,7 @@ export {
   autoConfigFromMCP,
   classifyTool,
   cliApproval,
+  dashboardApproval,
   discoverMCPTools,
   mcpToolGate
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "toolgate",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "Optimistic execution middleware for autonomous agents — let reads pass, intercept actions, approve at the end.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",