@bazaar.ai/mcp-human-agents 0.1.0

package/src/utils/ip.ts

@@ -0,0 +1,31 @@
+import { exec } from "./exec.js";
+
+/**
+ * Detect the VM's external IP address.
+ * Tries GCE metadata first, falls back to hostname -I.
+ */
+export async function getExternalIp(): Promise<string> {
+  // Try GCE metadata endpoint
+  try {
+    const { stdout } = await exec(
+      'curl -s -H "Metadata-Flavor: Google" ' +
+        "http://metadata.google.internal/computeMetadata/v1/instance/network-interfaces/0/access-configs/0/external-ip",
+      { timeout: 3_000 },
+    );
+    const ip = stdout.trim();
+    if (ip && !ip.includes("<!DOCTYPE")) return ip;
+  } catch {
+    // Not on GCE, try fallback
+  }
+
+  // Fallback: first non-loopback IP
+  try {
+    const { stdout } = await exec("hostname -I", { timeout: 3_000 });
+    const ip = stdout.trim().split(/\s+/)[0];
+    if (ip) return ip;
+  } catch {
+    // Last resort
+  }
+
+  return "127.0.0.1";
+}

package/src/utils/logger.ts

@@ -0,0 +1,55 @@
+/**
+ * Structured JSON logger that writes to STDERR only.
+ * CRITICAL: stdout is the MCP stdio transport — any stdout output
+ * will corrupt the protocol and break communication with Claude Code.
+ */
+
+type LogLevel = "debug" | "info" | "warn" | "error";
+
+interface LogContext {
+  gigId?: string;
+  contractorName?: string;
+  [key: string]: unknown;
+}
+
+const LEVEL_ORDER: Record<LogLevel, number> = {
+  debug: 0,
+  info: 1,
+  warn: 2,
+  error: 3,
+};
+
+let minLevel: LogLevel = "info";
+
+export function setLogLevel(level: LogLevel): void {
+  minLevel = level;
+}
+
+function shouldLog(level: LogLevel): boolean {
+  return LEVEL_ORDER[level] >= LEVEL_ORDER[minLevel];
+}
+
+function log(level: LogLevel, message: string, context?: LogContext): void {
+  if (!shouldLog(level)) return;
+
+  const entry = {
+    timestamp: new Date().toISOString(),
+    level,
+    message,
+    ...context,
+  };
+
+  // STDERR only — never stdout
+  process.stderr.write(JSON.stringify(entry) + "\n");
+}
+
+export const logger = {
+  debug: (message: string, context?: LogContext) =>
+    log("debug", message, context),
+  info: (message: string, context?: LogContext) =>
+    log("info", message, context),
+  warn: (message: string, context?: LogContext) =>
+    log("warn", message, context),
+  error: (message: string, context?: LogContext) =>
+    log("error", message, context),
+};

package/tsconfig.json

@@ -0,0 +1,20 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "Node16",
+    "moduleResolution": "Node16",
+    "lib": ["ES2022"],
+    "outDir": "dist",
+    "rootDir": "..",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "resolveJsonModule": true,
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true
+  },
+  "include": ["src/**/*", "../shared/src/**/*"],
+  "exclude": ["node_modules", "dist", "tests", "src/http-wrapper.ts"]
+}