@opentabs-dev/mcp-server 0.0.19

package/dist/loader.js

@@ -0,0 +1,402 @@
+/**
+ * Plugin loader module.
+ *
+ * Reads plugin artifacts from a resolved directory: package.json (validated
+ * via parsePluginPackageJson), dist/adapter.iife.js, and dist/tools.json.
+ * Returns a Result so errors are explicitly propagated, not thrown.
+ *
+ * Pure function: takes a directory path and trust tier, reads files, validates,
+ * returns a Result. No side effects, no state mutation.
+ */
+import { browserTools } from './browser-tools/index.js';
+import { log } from './logger.js';
+import { sdkVersion as serverSdkVersion } from './sdk-version.js';
+import { err, ok, parsePluginPackageJson, validatePluginName, validateUrlPattern } from '@opentabs-dev/shared';
+import { join } from 'node:path';
+/** Maximum allowed size for the adapter IIFE (5 MB) */
+const MAX_IIFE_SIZE = 5 * 1024 * 1024;
+/**
+ * Extract the internal plugin name from an npm package name.
+ * opentabs-plugin-slack → slack
+ * @myorg/opentabs-plugin-jira → myorg-jira
+ */
+const pluginNameFromPackage = (pkgName) => {
+    if (pkgName.startsWith('@')) {
+        const parts = pkgName.split('/');
+        const scopePart = parts[0] ?? '';
+        const namePart = parts[1] ?? '';
+        const scope = scopePart.slice(1);
+        const pluginSuffix = namePart.replace(/^opentabs-plugin-/, '');
+        return `${scope}-${pluginSuffix}`;
+    }
+    return pkgName.replace(/^opentabs-plugin-/, '');
+};
+/**
+ * Browser tool names that should not appear in plugin tool descriptions.
+ * Presence of these names may indicate a prompt injection attempt where
+ * a plugin tries to instruct the AI agent to invoke browser-level tools.
+ */
+const BROWSER_TOOL_NAMES = browserTools.map(t => t.name);
+/**
+ * Check plugin tool descriptions for references to browser tool names.
+ * Returns an array of { toolName, browserToolName } for each match found.
+ */
+const checkBrowserToolReferences = (tools) => {
+    const matches = [];
+    for (const tool of tools) {
+        const descLower = tool.description.toLowerCase();
+        for (const btName of BROWSER_TOOL_NAMES) {
+            if (descLower.includes(btName)) {
+                matches.push({ toolName: tool.name, browserToolName: btName });
+            }
+        }
+    }
+    return matches;
+};
+/**
+ * Validate an array of tool definitions from dist/tools.json.
+ * Each tool must have name, displayName, description, icon, input_schema, output_schema.
+ */
+const validateTools = (tools, sourcePath) => {
+    if (!Array.isArray(tools)) {
+        return err(`Invalid tools.json at ${sourcePath}: expected an array`);
+    }
+    const validated = [];
+    for (let i = 0; i < tools.length; i++) {
+        const raw = tools[i];
+        if (typeof raw !== 'object' || raw === null || Array.isArray(raw)) {
+            return err(`Invalid tools.json at ${sourcePath}: tools[${i}] must be an object`);
+        }
+        const toolRecord = raw;
+        const name = toolRecord.name;
+        if (typeof name !== 'string' || name.length === 0) {
+            return err(`Invalid tools.json at ${sourcePath}: tools[${i}].name must be a non-empty string`);
+        }
+        const displayName = toolRecord.displayName;
+        if (typeof displayName !== 'string' || displayName.length === 0) {
+            return err(`Invalid tools.json at ${sourcePath}: tools[${i}].displayName must be a non-empty string`);
+        }
+        const description = toolRecord.description;
+        if (typeof description !== 'string' || description.length === 0) {
+            return err(`Invalid tools.json at ${sourcePath}: tools[${i}].description must be a non-empty string`);
+        }
+        if (description.length > 1000) {
+            return err(`Invalid tools.json at ${sourcePath}: tools[${i}].description must be at most 1000 characters`);
+        }
+        const icon = toolRecord.icon;
+        if (typeof icon !== 'string' || icon.length === 0) {
+            return err(`Invalid tools.json at ${sourcePath}: tools[${i}].icon must be a non-empty string`);
+        }
+        // Optional SVG icons
+        const iconSvg = typeof toolRecord.iconSvg === 'string' ? toolRecord.iconSvg : undefined;
+        const iconInactiveSvg = typeof toolRecord.iconInactiveSvg === 'string' ? toolRecord.iconInactiveSvg : undefined;
+        const inputSchema = toolRecord.input_schema;
+        if (typeof inputSchema !== 'object' || inputSchema === null || Array.isArray(inputSchema)) {
+            return err(`Invalid tools.json at ${sourcePath}: tools[${i}].input_schema must be an object`);
+        }
+        const outputSchema = toolRecord.output_schema;
+        if (typeof outputSchema !== 'object' || outputSchema === null || Array.isArray(outputSchema)) {
+            return err(`Invalid tools.json at ${sourcePath}: tools[${i}].output_schema must be an object`);
+        }
+        validated.push({
+            name,
+            displayName,
+            description,
+            icon,
+            iconSvg,
+            iconInactiveSvg,
+            input_schema: inputSchema,
+            output_schema: outputSchema,
+        });
+    }
+    return ok(validated);
+};
+/**
+ * Validate an array of resource definitions from dist/tools.json.
+ * Invalid entries are filtered out with a warning, not a hard failure.
+ */
+const validateResources = (resources, pluginName, sourcePath) => {
+    const validated = [];
+    for (let i = 0; i < resources.length; i++) {
+        const raw = resources[i];
+        if (typeof raw !== 'object' || raw === null || Array.isArray(raw)) {
+            log.warn(`Plugin "${pluginName}" resources[${i}] at ${sourcePath} is not an object — skipping`);
+            continue;
+        }
+        const r = raw;
+        if (typeof r.uri !== 'string' || r.uri.length === 0) {
+            log.warn(`Plugin "${pluginName}" resources[${i}] at ${sourcePath} has invalid uri — skipping`);
+            continue;
+        }
+        if (typeof r.name !== 'string' || r.name.length === 0) {
+            log.warn(`Plugin "${pluginName}" resources[${i}] at ${sourcePath} has invalid name — skipping`);
+            continue;
+        }
+        if (r.description !== undefined && typeof r.description !== 'string') {
+            log.warn(`Plugin "${pluginName}" resources[${i}] at ${sourcePath} has invalid description — skipping`);
+            continue;
+        }
+        if (r.mimeType !== undefined && typeof r.mimeType !== 'string') {
+            log.warn(`Plugin "${pluginName}" resources[${i}] at ${sourcePath} has invalid mimeType — skipping`);
+            continue;
+        }
+        validated.push({
+            uri: r.uri,
+            name: r.name,
+            description: typeof r.description === 'string' ? r.description : undefined,
+            mimeType: typeof r.mimeType === 'string' ? r.mimeType : undefined,
+        });
+    }
+    return validated;
+};
+/**
+ * Validate an array of prompt definitions from dist/tools.json.
+ * Invalid entries are filtered out with a warning, not a hard failure.
+ */
+const validatePrompts = (prompts, pluginName, sourcePath) => {
+    const validated = [];
+    for (let i = 0; i < prompts.length; i++) {
+        const raw = prompts[i];
+        if (typeof raw !== 'object' || raw === null || Array.isArray(raw)) {
+            log.warn(`Plugin "${pluginName}" prompts[${i}] at ${sourcePath} is not an object — skipping`);
+            continue;
+        }
+        const p = raw;
+        if (typeof p.name !== 'string' || p.name.length === 0) {
+            log.warn(`Plugin "${pluginName}" prompts[${i}] at ${sourcePath} has invalid name — skipping`);
+            continue;
+        }
+        if (p.description !== undefined && typeof p.description !== 'string') {
+            log.warn(`Plugin "${pluginName}" prompts[${i}] at ${sourcePath} has invalid description — skipping`);
+            continue;
+        }
+        if (p.arguments !== undefined && !Array.isArray(p.arguments)) {
+            log.warn(`Plugin "${pluginName}" prompts[${i}] at ${sourcePath} has invalid arguments — skipping`);
+            continue;
+        }
+        validated.push({
+            name: p.name,
+            description: typeof p.description === 'string' ? p.description : undefined,
+            arguments: Array.isArray(p.arguments)
+                ? validatePromptArguments(p.arguments, pluginName, i, sourcePath)
+                : undefined,
+        });
+    }
+    return validated;
+};
+/**
+ * Validate prompt arguments within a prompt entry.
+ * Invalid arguments are filtered out with a warning.
+ */
+const validatePromptArguments = (args, pluginName, promptIndex, sourcePath) => {
+    const validated = [];
+    for (let j = 0; j < args.length; j++) {
+        const raw = args[j];
+        if (typeof raw !== 'object' || raw === null || Array.isArray(raw)) {
+            log.warn(`Plugin "${pluginName}" prompts[${promptIndex}].arguments[${j}] at ${sourcePath} is not an object — skipping`);
+            continue;
+        }
+        const a = raw;
+        if (typeof a.name !== 'string' || a.name.length === 0) {
+            log.warn(`Plugin "${pluginName}" prompts[${promptIndex}].arguments[${j}] at ${sourcePath} has invalid name — skipping`);
+            continue;
+        }
+        validated.push({
+            name: a.name,
+            description: typeof a.description === 'string' ? a.description : undefined,
+            required: typeof a.required === 'boolean' ? a.required : undefined,
+        });
+    }
+    return validated;
+};
+/**
+ * Compute SHA-256 hex hash of content using the Web Crypto API.
+ */
+const computeHash = async (content) => {
+    const encoded = new TextEncoder().encode(content);
+    const hashBuffer = await crypto.subtle.digest('SHA-256', encoded);
+    const hashArray = new Uint8Array(hashBuffer);
+    return Array.from(hashArray)
+        .map(byte => byte.toString(16).padStart(2, '0'))
+        .join('');
+};
+/**
+ * Parse a semver string into [major, minor] components.
+ * Returns null if the string is not a valid semver-like version.
+ */
+const parseMajorMinor = (version) => {
+    const match = version.match(/^(\d+)\.(\d+)\.\d+/);
+    if (!match)
+        return null;
+    return [Number(match[1]), Number(match[2])];
+};
+/**
+ * Check SDK version compatibility between a plugin and the server.
+ *
+ * Compatibility rule: the plugin's sdkVersion major.minor must be <= the
+ * server's SDK major.minor. A plugin built with a newer SDK than the server
+ * might use APIs the server doesn't have. A plugin built with an older SDK
+ * is assumed backward-compatible.
+ */
+const checkSdkCompatibility = (pluginSdkVersion, currentServerSdkVersion) => {
+    if (pluginSdkVersion === undefined) {
+        return { compatible: true };
+    }
+    const pluginMM = parseMajorMinor(pluginSdkVersion);
+    if (!pluginMM) {
+        return { compatible: true };
+    }
+    const serverMM = parseMajorMinor(currentServerSdkVersion);
+    if (!serverMM) {
+        return { compatible: true };
+    }
+    const [pluginMajor, pluginMinor] = pluginMM;
+    const [serverMajor, serverMinor] = serverMM;
+    if (pluginMajor > serverMajor || (pluginMajor === serverMajor && pluginMinor > serverMinor)) {
+        return {
+            compatible: false,
+            error: `Plugin built with SDK ${pluginSdkVersion}, server has SDK ${currentServerSdkVersion}`,
+        };
+    }
+    return { compatible: true };
+};
+/**
+ * Load a plugin from a resolved directory.
+ *
+ * Reads package.json (validated via parsePluginPackageJson), dist/adapter.iife.js,
+ * and dist/tools.json. Derives the internal plugin name from the npm package name.
+ *
+ * @param dir - Absolute path to the plugin directory containing package.json
+ * @param trustTier - Trust classification for this plugin
+ * @param source - How the plugin was discovered: 'npm' or 'local'
+ */
+const loadPlugin = async (dir, trustTier, source) => {
+    // Read and validate package.json
+    const pkgJsonPath = join(dir, 'package.json');
+    let pkgJsonRaw;
+    try {
+        pkgJsonRaw = await Bun.file(pkgJsonPath).json();
+    }
+    catch {
+        return err(`Failed to read package.json at ${dir}: file missing or invalid JSON`);
+    }
+    const pkgResult = parsePluginPackageJson(pkgJsonRaw, dir);
+    if (!pkgResult.ok) {
+        return err(pkgResult.error);
+    }
+    const pkg = pkgResult.value;
+    // Derive internal plugin name from npm package name
+    const pluginName = pluginNameFromPackage(pkg.name);
+    const nameError = validatePluginName(pluginName);
+    if (nameError) {
+        return err(`Invalid plugin name derived from "${pkg.name}" at ${dir}: ${nameError}`);
+    }
+    // Validate URL patterns
+    for (const pattern of pkg.opentabs.urlPatterns) {
+        const patternError = validateUrlPattern(pattern);
+        if (patternError) {
+            return err(`Invalid URL pattern in ${dir}: ${patternError}`);
+        }
+    }
+    // Read adapter IIFE
+    const iifePath = join(dir, 'dist', 'adapter.iife.js');
+    const iifeFile = Bun.file(iifePath);
+    if (!(await iifeFile.exists())) {
+        return err(`Adapter IIFE not found at ${iifePath}`);
+    }
+    const iifeSize = iifeFile.size;
+    if (iifeSize > MAX_IIFE_SIZE) {
+        return err(`Adapter IIFE for "${pluginName}" is ${(iifeSize / 1024 / 1024).toFixed(1)}MB, exceeding the 5MB limit`);
+    }
+    const iife = await iifeFile.text();
+    if (iife.length === 0) {
+        return err(`Adapter IIFE at ${iifePath} is empty — rebuild the plugin`);
+    }
+    // Read and validate tools.json
+    // Supports two formats:
+    //   - Legacy: a plain array of tool definitions (pre-resources/prompts)
+    //   - Current: { tools: [...], resources: [...], prompts: [...] }
+    const toolsJsonPath = join(dir, 'dist', 'tools.json');
+    let manifestRaw;
+    try {
+        manifestRaw = await Bun.file(toolsJsonPath).json();
+    }
+    catch {
+        return err(`Failed to read dist/tools.json at ${dir}: file missing or invalid JSON`);
+    }
+    // Extract the tools array from either format
+    const manifestObj = typeof manifestRaw === 'object' && manifestRaw !== null && !Array.isArray(manifestRaw)
+        ? manifestRaw
+        : null;
+    const toolsArray = Array.isArray(manifestRaw)
+        ? manifestRaw
+        : manifestObj && 'tools' in manifestObj
+            ? manifestObj.tools
+            : manifestRaw;
+    const toolsResult = validateTools(toolsArray, dir);
+    if (!toolsResult.ok) {
+        return err(toolsResult.error);
+    }
+    const tools = toolsResult.value;
+    // Extract and validate resources and prompts (default to [] for legacy format)
+    const resources = manifestObj && Array.isArray(manifestObj.resources)
+        ? validateResources(manifestObj.resources, pluginName, dir)
+        : [];
+    const prompts = manifestObj && Array.isArray(manifestObj.prompts)
+        ? validatePrompts(manifestObj.prompts, pluginName, dir)
+        : [];
+    // Extract sdkVersion and check compatibility
+    const pluginSdkVersion = manifestObj && typeof manifestObj.sdkVersion === 'string' ? manifestObj.sdkVersion : undefined;
+    if (pluginSdkVersion === undefined) {
+        log.warn(`Plugin "${pluginName}" does not declare sdkVersion — skipping compatibility check`);
+    }
+    else {
+        const compat = checkSdkCompatibility(pluginSdkVersion, serverSdkVersion);
+        if (!compat.compatible && compat.error) {
+            return err(`${compat.error}. Rebuild the plugin: cd ${dir} && bun install && bun run build`);
+        }
+    }
+    // Warn about browser tool references in tool descriptions (prompt injection detection)
+    for (const match of checkBrowserToolReferences(tools)) {
+        log.warn(`Plugin "${pluginName}" tool "${match.toolName}" description references browser tool "${match.browserToolName}" — possible prompt injection attempt`);
+    }
+    // Compute adapter hash from IIFE content
+    const adapterHash = await computeHash(iife);
+    // Read source map if available (optional — older plugins won't have one)
+    const sourceMapPath = join(dir, 'dist', 'adapter.iife.js.map');
+    let iifeSourceMap;
+    try {
+        const sourceMapFile = Bun.file(sourceMapPath);
+        if (await sourceMapFile.exists()) {
+            iifeSourceMap = await sourceMapFile.text();
+        }
+    }
+    catch {
+        // Source map not available — not an error
+    }
+    // Extract optional SVG icons from manifest
+    const iconSvg = manifestObj && typeof manifestObj.iconSvg === 'string' ? manifestObj.iconSvg : undefined;
+    const iconInactiveSvg = manifestObj && typeof manifestObj.iconInactiveSvg === 'string' ? manifestObj.iconInactiveSvg : undefined;
+    return ok({
+        name: pluginName,
+        version: pkg.version,
+        displayName: pkg.opentabs.displayName,
+        description: pkg.opentabs.description,
+        urlPatterns: pkg.opentabs.urlPatterns,
+        trustTier,
+        iife,
+        tools,
+        resources,
+        prompts,
+        source,
+        sourcePath: dir,
+        adapterHash,
+        npmPackageName: pkg.name,
+        sdkVersion: pluginSdkVersion,
+        iifeSourceMap,
+        iconSvg,
+        iconInactiveSvg,
+    });
+};
+export { checkBrowserToolReferences, checkSdkCompatibility, loadPlugin, parseMajorMinor, pluginNameFromPackage, validatePrompts, validateResources, validateTools, };
+//# sourceMappingURL=loader.js.map

package/dist/loader.js.map

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

package/dist/log-buffer.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Per-plugin circular log buffer.
+ *
+ * Stores the most recent log entries from plugin adapters, keyed by plugin name.
+ * Each plugin gets its own fixed-size ring buffer that overwrites oldest entries
+ * when full. The buffer is used for:
+ *   1. Forwarding log entries to MCP clients via sendLoggingMessage
+ *   2. Surfacing log counts in the /health endpoint
+ */
+/** A single buffered plugin log entry */
+interface PluginLogEntry {
+    level: string;
+    plugin: string;
+    message: string;
+    data: unknown;
+    ts: string;
+}
+/** Append a log entry to a plugin's ring buffer */
+declare const appendLog: (plugin: string, entry: PluginLogEntry) => void;
+/**
+ * Retrieve recent log entries for a plugin, oldest first.
+ * Returns at most `limit` entries (defaults to all buffered entries).
+ */
+declare const getLogs: (plugin: string, limit?: number) => PluginLogEntry[];
+/** Get the number of buffered entries for a plugin */
+declare const getLogCount: (plugin: string) => number;
+/** Get all plugin names that have buffered entries */
+declare const getBufferedPlugins: () => string[];
+/** Clear all buffered entries (used during testing or state reset) */
+declare const clearAllLogs: () => void;
+export { appendLog, clearAllLogs, getBufferedPlugins, getLogCount, getLogs };
+export type { PluginLogEntry };
+//# sourceMappingURL=log-buffer.d.ts.map

package/dist/log-buffer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-buffer.d.ts","sourceRoot":"","sources":["../src/log-buffer.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,yCAAyC;AACzC,UAAU,cAAc;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,OAAO,CAAC;IACd,EAAE,EAAE,MAAM,CAAC;CACZ;AAkBD,mDAAmD;AACnD,QAAA,MAAM,SAAS,GAAI,QAAQ,MAAM,EAAE,OAAO,cAAc,KAAG,IAY1D,CAAC;AAEF;;;GAGG;AACH,QAAA,MAAM,OAAO,GAAI,QAAQ,MAAM,EAAE,QAAQ,MAAM,KAAG,cAAc,EAmB/D,CAAC;AAEF,sDAAsD;AACtD,QAAA,MAAM,WAAW,GAAI,QAAQ,MAAM,KAAG,MAAwC,CAAC;AAE/E,sDAAsD;AACtD,QAAA,MAAM,kBAAkB,QAAO,MAAM,EAAgC,CAAC;AAEtE,sEAAsE;AACtE,QAAA,MAAM,YAAY,QAAO,IAExB,CAAC;AAEF,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,kBAAkB,EAAE,WAAW,EAAE,OAAO,EAAE,CAAC;AAC7E,YAAY,EAAE,cAAc,EAAE,CAAC"}

package/dist/log-buffer.js

@@ -0,0 +1,64 @@
+/**
+ * Per-plugin circular log buffer.
+ *
+ * Stores the most recent log entries from plugin adapters, keyed by plugin name.
+ * Each plugin gets its own fixed-size ring buffer that overwrites oldest entries
+ * when full. The buffer is used for:
+ *   1. Forwarding log entries to MCP clients via sendLoggingMessage
+ *   2. Surfacing log counts in the /health endpoint
+ */
+/** Maximum log entries retained per plugin */
+const MAX_ENTRIES_PER_PLUGIN = 1000;
+const createRingBuffer = () => ({
+    entries: new Array(MAX_ENTRIES_PER_PLUGIN).fill(undefined),
+    writeIndex: 0,
+    size: 0,
+});
+/** Per-plugin ring buffers */
+const buffers = new Map();
+/** Append a log entry to a plugin's ring buffer */
+const appendLog = (plugin, entry) => {
+    let ring = buffers.get(plugin);
+    if (!ring) {
+        ring = createRingBuffer();
+        buffers.set(plugin, ring);
+    }
+    ring.entries[ring.writeIndex] = entry;
+    ring.writeIndex = (ring.writeIndex + 1) % MAX_ENTRIES_PER_PLUGIN;
+    if (ring.size < MAX_ENTRIES_PER_PLUGIN) {
+        ring.size++;
+    }
+};
+/**
+ * Retrieve recent log entries for a plugin, oldest first.
+ * Returns at most `limit` entries (defaults to all buffered entries).
+ */
+const getLogs = (plugin, limit) => {
+    const ring = buffers.get(plugin);
+    if (!ring || ring.size === 0)
+        return [];
+    const cap = limit !== undefined && limit < ring.size ? limit : ring.size;
+    const result = [];
+    // Read from oldest to newest. When the buffer has wrapped, oldest is at writeIndex.
+    const startIndex = ring.size < MAX_ENTRIES_PER_PLUGIN ? 0 : ring.writeIndex;
+    const skip = ring.size - cap;
+    for (let i = 0; i < ring.size; i++) {
+        if (i < skip)
+            continue;
+        const idx = (startIndex + i) % MAX_ENTRIES_PER_PLUGIN;
+        const entry = ring.entries[idx];
+        if (entry)
+            result.push(entry);
+    }
+    return result;
+};
+/** Get the number of buffered entries for a plugin */
+const getLogCount = (plugin) => buffers.get(plugin)?.size ?? 0;
+/** Get all plugin names that have buffered entries */
+const getBufferedPlugins = () => Array.from(buffers.keys());
+/** Clear all buffered entries (used during testing or state reset) */
+const clearAllLogs = () => {
+    buffers.clear();
+};
+export { appendLog, clearAllLogs, getBufferedPlugins, getLogCount, getLogs };
+//# sourceMappingURL=log-buffer.js.map

package/dist/log-buffer.js.map

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

package/dist/logger.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Lightweight structured logger with level filtering.
+ *
+ * All server log output flows through this module so that verbosity can be
+ * controlled via the OPENTABS_LOG_LEVEL environment variable:
+ *
+ *   OPENTABS_LOG_LEVEL=debug   — all messages (debug + info + warn + error)
+ *   OPENTABS_LOG_LEVEL=info    — info + warn + error (default)
+ *   OPENTABS_LOG_LEVEL=warn    — warn + error only
+ *   OPENTABS_LOG_LEVEL=error   — errors only
+ *   OPENTABS_LOG_LEVEL=silent  — suppress all output
+ *
+ * Each method prepends the [opentabs] tag automatically and detects Error
+ * instances passed as the last argument: at info/warn/error level, the Error
+ * is replaced with its message string; at debug level, the stack trace is
+ * appended. Callers should pass raw Error objects (not err.message) so the
+ * logger can format them appropriately per level.
+ *
+ * Hot reload safe: reads the env var once at module evaluation time. Under
+ * bun --hot, the module is re-evaluated on each reload, picking up any
+ * runtime changes to the environment variable.
+ */
+declare const log: {
+    /** Verbose diagnostic output — suppressed by default */
+    debug: (...args: unknown[]) => void;
+    /** Normal operational messages */
+    info: (...args: unknown[]) => void;
+    /** Potential problems that don't prevent operation */
+    warn: (...args: unknown[]) => void;
+    /** Failures that affect functionality */
+    error: (...args: unknown[]) => void;
+};
+export { log };
+//# sourceMappingURL=logger.d.ts.map

package/dist/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAuCH,QAAA,MAAM,GAAG;IACP,wDAAwD;qBACvC,OAAO,EAAE,KAAG,IAAI;IAMjC,kCAAkC;oBAClB,OAAO,EAAE,KAAG,IAAI;IAMhC,sDAAsD;oBACtC,OAAO,EAAE,KAAG,IAAI;IAMhC,yCAAyC;qBACxB,OAAO,EAAE,KAAG,IAAI;CAKlC,CAAC;AAEF,OAAO,EAAE,GAAG,EAAE,CAAC"}

package/dist/logger.js

@@ -0,0 +1,81 @@
+/**
+ * Lightweight structured logger with level filtering.
+ *
+ * All server log output flows through this module so that verbosity can be
+ * controlled via the OPENTABS_LOG_LEVEL environment variable:
+ *
+ *   OPENTABS_LOG_LEVEL=debug   — all messages (debug + info + warn + error)
+ *   OPENTABS_LOG_LEVEL=info    — info + warn + error (default)
+ *   OPENTABS_LOG_LEVEL=warn    — warn + error only
+ *   OPENTABS_LOG_LEVEL=error   — errors only
+ *   OPENTABS_LOG_LEVEL=silent  — suppress all output
+ *
+ * Each method prepends the [opentabs] tag automatically and detects Error
+ * instances passed as the last argument: at info/warn/error level, the Error
+ * is replaced with its message string; at debug level, the stack trace is
+ * appended. Callers should pass raw Error objects (not err.message) so the
+ * logger can format them appropriately per level.
+ *
+ * Hot reload safe: reads the env var once at module evaluation time. Under
+ * bun --hot, the module is re-evaluated on each reload, picking up any
+ * runtime changes to the environment variable.
+ */
+const LEVELS = {
+    debug: 0,
+    info: 1,
+    warn: 2,
+    error: 3,
+    silent: 4,
+};
+const TAG = '[opentabs]';
+/**
+ * Format log arguments, detecting Error instances as the last argument.
+ * At debug level (includeStack = true), appends the stack trace indented
+ * on the next line. At other levels, replaces the Error object with its
+ * message string so stack traces don't clutter normal output.
+ */
+const formatArgs = (args, includeStack) => {
+    const last = args[args.length - 1];
+    if (last instanceof Error) {
+        const rest = args.slice(0, -1);
+        if (includeStack && last.stack) {
+            return [...rest, last.message + '\n  ' + last.stack];
+        }
+        return [...rest, last.message];
+    }
+    return args;
+};
+const parseLevel = (raw) => {
+    if (raw && raw in LEVELS)
+        return raw;
+    return 'info';
+};
+const currentLevel = LEVELS[parseLevel(Bun.env.OPENTABS_LOG_LEVEL)];
+const log = {
+    /** Verbose diagnostic output — suppressed by default */
+    debug: (...args) => {
+        if (currentLevel <= LEVELS.debug) {
+            console.debug(TAG, new Date().toISOString(), ...formatArgs(args, true));
+        }
+    },
+    /** Normal operational messages */
+    info: (...args) => {
+        if (currentLevel <= LEVELS.info) {
+            console.log(TAG, new Date().toISOString(), ...formatArgs(args, false));
+        }
+    },
+    /** Potential problems that don't prevent operation */
+    warn: (...args) => {
+        if (currentLevel <= LEVELS.warn) {
+            console.warn(TAG, new Date().toISOString(), ...formatArgs(args, false));
+        }
+    },
+    /** Failures that affect functionality */
+    error: (...args) => {
+        if (currentLevel <= LEVELS.error) {
+            console.error(TAG, new Date().toISOString(), ...formatArgs(args, false));
+        }
+    },
+};
+export { log };
+//# sourceMappingURL=logger.js.map

package/dist/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAIH,MAAM,MAAM,GAA6B;IACvC,KAAK,EAAE,CAAC;IACR,IAAI,EAAE,CAAC;IACP,IAAI,EAAE,CAAC;IACP,KAAK,EAAE,CAAC;IACR,MAAM,EAAE,CAAC;CACV,CAAC;AAEF,MAAM,GAAG,GAAG,YAAY,CAAC;AAEzB;;;;;GAKG;AACH,MAAM,UAAU,GAAG,CAAC,IAAe,EAAE,YAAqB,EAAa,EAAE;IACvE,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACnC,IAAI,IAAI,YAAY,KAAK,EAAE,CAAC;QAC1B,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QAC/B,IAAI,YAAY,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YAC/B,OAAO,CAAC,GAAG,IAAI,EAAE,IAAI,CAAC,OAAO,GAAG,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;QACvD,CAAC;QACD,OAAO,CAAC,GAAG,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;IACjC,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC,CAAC;AAEF,MAAM,UAAU,GAAG,CAAC,GAAuB,EAAY,EAAE;IACvD,IAAI,GAAG,IAAI,GAAG,IAAI,MAAM;QAAE,OAAO,GAAe,CAAC;IACjD,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC;AAEF,MAAM,YAAY,GAAG,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC,CAAC;AAEpE,MAAM,GAAG,GAAG;IACV,wDAAwD;IACxD,KAAK,EAAE,CAAC,GAAG,IAAe,EAAQ,EAAE;QAClC,IAAI,YAAY,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;YACjC,OAAO,CAAC,KAAK,CAAC,GAAG,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,GAAG,UAAU,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;QAC1E,CAAC;IACH,CAAC;IAED,kCAAkC;IAClC,IAAI,EAAE,CAAC,GAAG,IAAe,EAAQ,EAAE;QACjC,IAAI,YAAY,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;YAChC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,GAAG,UAAU,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;QACzE,CAAC;IACH,CAAC;IAED,sDAAsD;IACtD,IAAI,EAAE,CAAC,GAAG,IAAe,EAAQ,EAAE;QACjC,IAAI,YAAY,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;YAChC,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,GAAG,UAAU,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;QAC1E,CAAC;IACH,CAAC;IAED,yCAAyC;IACzC,KAAK,EAAE,CAAC,GAAG,IAAe,EAAQ,EAAE;QAClC,IAAI,YAAY,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;YACjC,OAAO,CAAC,KAAK,CAAC,GAAG,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,GAAG,UAAU,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;QAC3E,CAAC;IACH,CAAC;CACF,CAAC;AAEF,OAAO,EAAE,GAAG,EAAE,CAAC"}