@trentapps/manager-protocol 1.1.1

package/dist/utils/errors.js

@@ -0,0 +1,171 @@
+/**
+ * Enterprise Agent Supervisor - Error Utilities
+ *
+ * Provides custom error types and error handling utilities.
+ */
+/**
+ * Base error class for Agent Supervisor errors
+ */
+export class AgentSupervisorError extends Error {
+    code;
+    details;
+    constructor(message, code, details) {
+        super(message);
+        this.name = 'AgentSupervisorError';
+        this.code = code;
+        this.details = details;
+        // Maintains proper stack trace for where our error was thrown
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, AgentSupervisorError);
+        }
+    }
+}
+/**
+ * Error thrown when a rule validation fails
+ */
+export class RuleValidationError extends AgentSupervisorError {
+    constructor(message, details) {
+        super(message, 'RULE_VALIDATION_ERROR', details);
+        this.name = 'RuleValidationError';
+    }
+}
+/**
+ * Error thrown when a rule is not found
+ */
+export class RuleNotFoundError extends AgentSupervisorError {
+    constructor(ruleId) {
+        super(`Rule not found: ${ruleId}`, 'RULE_NOT_FOUND', { ruleId });
+        this.name = 'RuleNotFoundError';
+    }
+}
+/**
+ * Error thrown when rate limit is exceeded
+ */
+export class RateLimitExceededError extends AgentSupervisorError {
+    resetAt;
+    remaining;
+    constructor(limitId, resetAt, remaining = 0) {
+        super(`Rate limit exceeded: ${limitId}`, 'RATE_LIMIT_EXCEEDED', {
+            limitId,
+            resetAt: resetAt.toISOString(),
+            remaining
+        });
+        this.name = 'RateLimitExceededError';
+        this.resetAt = resetAt;
+        this.remaining = remaining;
+    }
+}
+/**
+ * Error thrown when an approval request is not found
+ */
+export class ApprovalNotFoundError extends AgentSupervisorError {
+    constructor(requestId) {
+        super(`Approval request not found: ${requestId}`, 'APPROVAL_NOT_FOUND', { requestId });
+        this.name = 'ApprovalNotFoundError';
+    }
+}
+/**
+ * Error thrown when an approval request has expired
+ */
+export class ApprovalExpiredError extends AgentSupervisorError {
+    constructor(requestId, expiredAt) {
+        super(`Approval request expired: ${requestId}`, 'APPROVAL_EXPIRED', { requestId, expiredAt });
+        this.name = 'ApprovalExpiredError';
+    }
+}
+/**
+ * Error thrown for configuration errors
+ */
+export class ConfigurationError extends AgentSupervisorError {
+    constructor(message, details) {
+        super(message, 'CONFIGURATION_ERROR', details);
+        this.name = 'ConfigurationError';
+    }
+}
+/**
+ * Error thrown when webhook delivery fails
+ */
+export class WebhookDeliveryError extends AgentSupervisorError {
+    url;
+    statusCode;
+    retryCount;
+    constructor(url, cause, statusCode, retryCount = 0) {
+        const message = typeof cause === 'string' ? cause : cause.message;
+        super(`Webhook delivery failed: ${message}`, 'WEBHOOK_DELIVERY_ERROR', {
+            url,
+            statusCode,
+            retryCount
+        });
+        this.name = 'WebhookDeliveryError';
+        this.url = url;
+        this.statusCode = statusCode;
+        this.retryCount = retryCount;
+    }
+}
+const DEFAULT_RETRY_OPTIONS = {
+    maxRetries: 3,
+    initialDelayMs: 1000,
+    maxDelayMs: 30000,
+    backoffMultiplier: 2
+};
+/**
+ * Execute a function with retry logic and exponential backoff
+ */
+export async function withRetry(fn, options = {}) {
+    const opts = { ...DEFAULT_RETRY_OPTIONS, ...options };
+    let lastError;
+    let delay = opts.initialDelayMs;
+    for (let attempt = 0; attempt <= opts.maxRetries; attempt++) {
+        try {
+            return await fn();
+        }
+        catch (error) {
+            lastError = error instanceof Error ? error : new Error(String(error));
+            if (attempt < opts.maxRetries) {
+                await sleep(delay);
+                delay = Math.min(delay * opts.backoffMultiplier, opts.maxDelayMs);
+            }
+        }
+    }
+    throw lastError;
+}
+/**
+ * Sleep for a specified number of milliseconds
+ */
+function sleep(ms) {
+    return new Promise(resolve => setTimeout(resolve, ms));
+}
+/**
+ * Type guard for checking if an error is an AgentSupervisorError
+ */
+export function isAgentSupervisorError(error) {
+    return error instanceof AgentSupervisorError;
+}
+/**
+ * Format an error for logging
+ */
+export function formatError(error) {
+    if (error instanceof AgentSupervisorError) {
+        return `[${error.code}] ${error.message}${error.details ? ` - ${JSON.stringify(error.details)}` : ''}`;
+    }
+    if (error instanceof Error) {
+        return error.message;
+    }
+    return String(error);
+}
+/**
+ * Safe JSON stringify that handles circular references
+ */
+export function safeStringify(obj) {
+    const seen = new WeakSet();
+    return JSON.stringify(obj, (_key, value) => {
+        if (typeof value === 'object' && value !== null) {
+            if (seen.has(value)) {
+                return '[Circular]';
+            }
+            seen.add(value);
+        }
+        return value;
+    });
+}
+//# sourceMappingURL=errors.js.map

package/dist/utils/errors.js.map

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

package/dist/utils/index.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Enterprise Agent Supervisor - Utility Exports
+ */
+export * from './errors.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,aAAa,CAAC"}

package/dist/utils/index.js

@@ -0,0 +1,5 @@
+/**
+ * Enterprise Agent Supervisor - Utility Exports
+ */
+export * from './errors.js';
+//# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,aAAa,CAAC"}

package/dist/utils/shell.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Shell utility functions for secure command execution
+ */
+/**
+ * Escape a string for safe use in shell commands
+ *
+ * Wraps the string in single quotes and escapes any embedded single quotes.
+ * This prevents command injection vulnerabilities when passing user-controlled
+ * strings to shell commands via exec/execSync.
+ *
+ * @param str - The string to escape
+ * @returns The escaped string safe for shell usage
+ *
+ * @example
+ * ```ts
+ * const userInput = "test'; rm -rf /";
+ * const safe = escapeForShell(userInput);
+ * await execAsync(`echo ${safe}`); // Safe: prints "test'; rm -rf /" literally
+ * ```
+ */
+export declare function escapeForShell(str: string | number): string;
+//# sourceMappingURL=shell.d.ts.map

package/dist/utils/shell.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shell.d.ts","sourceRoot":"","sources":["../../src/utils/shell.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAQ3D"}

package/dist/utils/shell.js

@@ -0,0 +1,29 @@
+/**
+ * Shell utility functions for secure command execution
+ */
+/**
+ * Escape a string for safe use in shell commands
+ *
+ * Wraps the string in single quotes and escapes any embedded single quotes.
+ * This prevents command injection vulnerabilities when passing user-controlled
+ * strings to shell commands via exec/execSync.
+ *
+ * @param str - The string to escape
+ * @returns The escaped string safe for shell usage
+ *
+ * @example
+ * ```ts
+ * const userInput = "test'; rm -rf /";
+ * const safe = escapeForShell(userInput);
+ * await execAsync(`echo ${safe}`); // Safe: prints "test'; rm -rf /" literally
+ * ```
+ */
+export function escapeForShell(str) {
+    // Convert numbers to strings
+    const value = String(str);
+    // Wrap in single quotes and escape any embedded single quotes
+    // 'abc' -> 'abc'
+    // 'it's' -> 'it'\''s'
+    return "'" + value.replace(/'/g, "'\\''") + "'";
+}
+//# sourceMappingURL=shell.js.map

package/dist/utils/shell.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shell.js","sourceRoot":"","sources":["../../src/utils/shell.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,cAAc,CAAC,GAAoB;IACjD,6BAA6B;IAC7B,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IAE1B,8DAA8D;IAC9D,iBAAiB;IACjB,sBAAsB;IACtB,OAAO,GAAG,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,GAAG,CAAC;AAClD,CAAC"}

package/package.json

@@ -0,0 +1,63 @@
+{
+  "name": "@trentapps/manager-protocol",
+  "version": "1.1.1",
+  "description": "Enterprise Agent Supervisor - Rules Engine MCP Server for AI Agent Governance",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "agent-supervisor": "dist/cli.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/cli.js",
+    "dev": "tsx src/cli.ts",
+    "test": "vitest",
+    "test:run": "vitest run",
+    "lint": "eslint src --ext .ts",
+    "format": "prettier --write \"src/**/*.ts\"",
+    "clean": "rm -rf dist",
+    "clean:test": "rm -rf test-results/ playwright-report/ traces/ screenshots/ videos/ && find . -name '*.png' -o -name '*.jpg' -o -name '*.jpeg' -o -name '*.webm' | grep -v node_modules | xargs rm -f 2>/dev/null || true",
+    "clean:test:old": "find test-results/ playwright-report/ traces/ screenshots/ videos/ -type f -mtime +7 -delete 2>/dev/null || true",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "ai-governance",
+    "agent-supervisor",
+    "rules-engine",
+    "compliance",
+    "audit",
+    "enterprise"
+  ],
+  "author": "ManagerProtocol",
+  "license": "MIT",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "@types/better-sqlite3": "^7.6.13",
+    "better-sqlite3": "^12.5.0",
+    "uuid": "^9.0.1",
+    "ws": "^8.16.0",
+    "zod": "^3.22.4"
+  },
+  "devDependencies": {
+    "@types/node": "^20.10.0",
+    "@types/uuid": "^9.0.7",
+    "@types/ws": "^8.5.10",
+    "@typescript-eslint/eslint-plugin": "^6.13.2",
+    "@typescript-eslint/parser": "^6.13.2",
+    "eslint": "^8.55.0",
+    "prettier": "^3.1.1",
+    "tsx": "^4.6.2",
+    "typescript": "^5.3.2",
+    "vitest": "^1.0.4"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ]
+}