@hopping-dev/hub 0.1.0

package/dist/mcp/summary.js

@@ -0,0 +1,150 @@
+"use strict";
+// ============================================
+// Smart Summary Generator
+// Produces human-readable, security-safe summaries
+// Max 200 chars, English (technical content)
+// ============================================
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateSummary = generateSummary;
+const MAX_SUMMARY_LENGTH = 200;
+/**
+ * Generate a human-readable summary from toolName + toolInput.
+ *
+ * Design principles:
+ * - Max 200 chars (fits push notifications)
+ * - English (technical content is inherently English)
+ * - No sensitive content leakage (passwords, tokens, secrets)
+ * - Graceful fallback for unknown tools
+ */
+function generateSummary(toolName, toolInput) {
+    let summary;
+    switch (toolName) {
+        case 'Bash':
+            summary = summarizeBash(toolInput);
+            break;
+        case 'Write':
+            summary = summarizeWrite(toolInput);
+            break;
+        case 'Edit':
+            summary = summarizeEdit(toolInput);
+            break;
+        case 'Read':
+            summary = summarizeRead(toolInput);
+            break;
+        case 'Glob':
+            summary = summarizeGlob(toolInput);
+            break;
+        case 'Grep':
+            summary = summarizeGrep(toolInput);
+            break;
+        case 'NotebookEdit':
+            summary = summarizeNotebookEdit(toolInput);
+            break;
+        default:
+            summary = summarizeGeneric(toolName, toolInput);
+            break;
+    }
+    return truncate(summary, MAX_SUMMARY_LENGTH);
+}
+// ─── Tool-specific summarizers ─────────────────────────────────────────────
+function summarizeBash(input) {
+    const command = typeof input['command'] === 'string' ? input['command'] : '';
+    if (!command)
+        return 'Execute shell command';
+    // Extract the base command (first word/executable)
+    const sanitized = sanitizeCommand(command);
+    const baseCmd = sanitized.split(/\s+/)[0] ?? '';
+    // Known dangerous commands get explicit labeling
+    if (/\brm\b/.test(sanitized) && /\s-[a-z]*r[a-z]*f/i.test(sanitized)) {
+        return `Delete files recursively: ${sanitized}`;
+    }
+    if (/\brm\b/.test(sanitized)) {
+        return `Delete files: ${sanitized}`;
+    }
+    if (/\bgit\s+push\b/.test(sanitized)) {
+        return `Git push: ${sanitized}`;
+    }
+    if (/\bgit\s+reset\b/.test(sanitized)) {
+        return `Git reset: ${sanitized}`;
+    }
+    if (/\bcurl\b|\bwget\b|\bfetch\b/.test(sanitized)) {
+        return `Network request: ${sanitized}`;
+    }
+    if (/\bdocker\b/.test(sanitized)) {
+        return `Docker command: ${sanitized}`;
+    }
+    if (/\bsudo\b/.test(sanitized)) {
+        return `Elevated command: ${sanitized}`;
+    }
+    if (/\bnpm\b|\bpnpm\b|\byarn\b/.test(sanitized)) {
+        return `Package manager: ${sanitized}`;
+    }
+    return `Run: ${baseCmd} — ${sanitized}`;
+}
+function summarizeWrite(input) {
+    const filePath = typeof input['file_path'] === 'string' ? input['file_path'] : '';
+    if (!filePath)
+        return 'Write file';
+    const fileName = filePath.split('/').pop() ?? filePath;
+    return `Write file: ${fileName} (${filePath})`;
+}
+function summarizeEdit(input) {
+    const filePath = typeof input['file_path'] === 'string' ? input['file_path'] : '';
+    if (!filePath)
+        return 'Edit file';
+    const fileName = filePath.split('/').pop() ?? filePath;
+    return `Edit file: ${fileName} (${filePath})`;
+}
+function summarizeRead(input) {
+    const filePath = typeof input['file_path'] === 'string' ? input['file_path'] : '';
+    if (!filePath)
+        return 'Read file';
+    const fileName = filePath.split('/').pop() ?? filePath;
+    return `Read file: ${fileName} (${filePath})`;
+}
+function summarizeGlob(input) {
+    const pattern = typeof input['pattern'] === 'string' ? input['pattern'] : '';
+    if (!pattern)
+        return 'Search files by pattern';
+    return `Search files: ${pattern}`;
+}
+function summarizeGrep(input) {
+    const pattern = typeof input['pattern'] === 'string' ? input['pattern'] : '';
+    if (!pattern)
+        return 'Search file contents';
+    return `Search content: "${pattern}"`;
+}
+function summarizeNotebookEdit(input) {
+    const path = typeof input['notebook_path'] === 'string' ? input['notebook_path'] : '';
+    if (!path)
+        return 'Edit Jupyter notebook';
+    const fileName = path.split('/').pop() ?? path;
+    return `Edit notebook: ${fileName}`;
+}
+function summarizeGeneric(toolName, input) {
+    const keys = Object.keys(input);
+    if (keys.length === 0)
+        return `Execute: ${toolName}`;
+    // Show first 2 parameter names for context
+    const paramHint = keys.slice(0, 2).join(', ');
+    return `Execute: ${toolName} (${paramHint})`;
+}
+// ─── Helpers ────────────────────────────────────────────────────────────────
+/**
+ * Sanitize command string to prevent sensitive content leakage.
+ * Masks environment variable values, tokens, passwords in assignments.
+ */
+function sanitizeCommand(command) {
+    // Mask inline env var assignments with sensitive-looking values
+    // e.g., TOKEN=abc123 → TOKEN=***
+    let sanitized = command.replace(/\b([A-Z_]*(?:TOKEN|SECRET|PASSWORD|KEY|CREDENTIAL|AUTH)[A-Z_]*)=(\S+)/gi, '$1=***');
+    // Mask --password=, --token=, etc.
+    sanitized = sanitized.replace(/--(password|token|secret|key|credential|auth)=\S+/gi, '--$1=***');
+    return sanitized;
+}
+function truncate(text, maxLength) {
+    if (text.length <= maxLength)
+        return text;
+    return text.slice(0, maxLength - 3) + '...';
+}
+//# sourceMappingURL=summary.js.map

package/dist/mcp/summary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"summary.js","sourceRoot":"","sources":["../../src/mcp/summary.ts"],"names":[],"mappings":"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"}

package/dist/mcp/tools.d.ts

@@ -0,0 +1,45 @@
+import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+import type { AgentType, AskMode } from '@hopping/shared';
+import type { LocalApprovalChannel } from '../local/local-approval';
+import { PolicyEngine } from '../policy/engine';
+import { ApprovalManager } from '../approval/manager';
+import type { SessionMemory } from '../approval/session-memory';
+import { Logger } from '../utils/logger';
+import type { HubDatabase } from '../store';
+import { CloudConnector } from '../cloud';
+import type { ConfigManager } from '../config/manager';
+/** 供測試用：重設 askMode（Hub 重啟模擬） */
+export declare function _resetAskMode(): void;
+/** 取得當前 askMode（供 IpcWatcher 及測試使用） */
+export declare function getAskMode(): AskMode;
+export type { CallToolResult };
+export interface Tool {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: 'object';
+        properties: Record<string, unknown>;
+        required?: string[];
+    };
+}
+export type ToolHandler = (name: string, args: Record<string, unknown>) => Promise<CallToolResult>;
+export interface ToolDependencies {
+    policyEngine: PolicyEngine;
+    approvalManager: ApprovalManager;
+    logger: Logger;
+    shouldIntercept: (toolName: string) => boolean;
+    startTime: number;
+    agentType?: AgentType;
+    agentId?: string;
+    store?: HubDatabase;
+    cloudConnector?: CloudConnector;
+    configManager?: ConfigManager;
+    cloudUrl?: string;
+    onCloudConnectorUpdate?: (connector: CloudConnector) => void;
+    localApprovalChannel?: LocalApprovalChannel;
+    isYoloMode?: () => boolean;
+    sessionMemory?: SessionMemory;
+}
+export declare function getToolDefinitions(): Tool[];
+export declare function createToolHandler(deps: ToolDependencies): ToolHandler;
+//# sourceMappingURL=tools.d.ts.map

package/dist/mcp/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../src/mcp/tools.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACzE,OAAO,KAAK,EACV,SAAS,EAET,OAAO,EAqBR,MAAM,iBAAiB,CAAC;AACzB,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAWpE,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAEtD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AACzC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAQ1C,OAAO,KAAK,EAAE,aAAa,EAAyB,MAAM,mBAAmB,CAAC;AAwB9E,gCAAgC;AAChC,wBAAgB,aAAa,IAAI,IAAI,CAEpC;AAED,uCAAuC;AACvC,wBAAgB,UAAU,IAAI,OAAO,CAEpC;AAGD,YAAY,EAAE,cAAc,EAAE,CAAC;AAM/B,MAAM,WAAW,IAAI;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ,CAAC;QACf,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACpC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;KACrB,CAAC;CACH;AAED,MAAM,MAAM,WAAW,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,cAAc,CAAC,CAAC;AAEnG,MAAM,WAAW,gBAAgB;IAC/B,YAAY,EAAE,YAAY,CAAC;IAC3B,eAAe,EAAE,eAAe,CAAC;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC;IAC/C,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,cAAc,CAAC,EAAE,cAAc,CAAC;IAEhC,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,sBAAsB,CAAC,EAAE,CAAC,SAAS,EAAE,cAAc,KAAK,IAAI,CAAC;IAE7D,oBAAoB,CAAC,EAAE,oBAAoB,CAAC;IAE5C,UAAU,CAAC,EAAE,MAAM,OAAO,CAAC;IAE3B,aAAa,CAAC,EAAE,aAAa,CAAC;CAC/B;AAMD,wBAAgB,kBAAkB,IAAI,IAAI,EAAE,CA6M3C;AA0ND,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,gBAAgB,GAAG,WAAW,CAsCrE"}