sqlew 4.3.1 → 5.0.1

package/dist/index.js

@@ -45,7 +45,7 @@ async function startMcpServer() {
     const { parseArgs, validateArgs } = await import('./server/arg-parser.js');
     const { getToolRegistry } = await import('./server/tool-registry.js');
     const { handleToolCall } = await import('./server/tool-handlers.js');
-    const { initializeServer, startFileWatcher } = await import('./server/setup.js');
+    const { initializeServer } = await import('./server/setup.js');
     const { registerShutdownHandlers, performCleanup } = await import('./server/shutdown.js');
     const { handleInitializationError, safeConsoleError } = await import('./utils/error-handler.js');
     // Parse command-line arguments
@@ -74,8 +74,22 @@ async function startMcpServer() {
             tools: getToolRegistry(),
         };
     });
+    // Flag for one-time agent name initialization
+    let agentNameInitialized = false;
     // Handle tool execution
     server.setRequestHandler(CallToolRequestSchema, async (request) => {
+        // Lazy initialization of agent name (after MCP handshake is complete)
+        if (!agentNameInitialized) {
+            agentNameInitialized = true;
+            const clientVersion = server.getClientVersion();
+            if (clientVersion?.name) {
+                const { getBackend } = await import('./backend/backend-factory.js');
+                const backend = getBackend();
+                if (backend.setAgentName) {
+                    backend.setAgentName(clientVersion.name);
+                }
+            }
+        }
         return await handleToolCall(request);
     });
     // Setup centralized global error handlers
@@ -98,15 +112,6 @@ async function startMcpServer() {
             safeConsoleError(`  Database: ${dbPath} (from ${source})`);
         }
         safeConsoleError(`  Project: ${setupResult.projectContext.getProjectName()} (ID: ${setupResult.projectContext.getProjectId()}, source: ${setupResult.detectionSource})`);
-        safeConsoleError(`  Auto-delete config: messages=${setupResult.configValues.messageHours}h, file_history=${setupResult.configValues.fileHistoryDays}d, ignore_weekend=${setupResult.configValues.ignoreWeekend}`);
-        // Start file watcher for auto-task-tracking (after database is ready)
-        try {
-            await startFileWatcher();
-        }
-        catch (error) {
-            safeConsoleError('⚠ Failed to start file watcher:', error);
-            safeConsoleError('  (Auto task tracking will be disabled)');
-        }
     }
     catch (error) {
         // If debug logger not initialized, write to stderr as fallback

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;;;;;GAOG;AAEH,+EAA+E;AAC/E,gEAAgE;AAChE,+EAA+E;AAC/E,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AACtC,MAAM,QAAQ,GAAG,OAAO,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;AAElC,yCAAyC;AACzC,MAAM,WAAW,GAAG;IAClB,SAAS,EAAE,WAAW,EAAE,WAAW,EAAE,OAAO;IAC5C,SAAS,EAAE,YAAY,EAAE,MAAM,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM;IACxE,4BAA4B;IAC5B,kBAAkB,EAAE,SAAS,EAAE,cAAc;CAC9C,CAAC;AACF,sDAAsD;AACtD,MAAM,QAAQ,GAAG,CAAC,QAAQ,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC;AACnD,MAAM,YAAY,GAAG,WAAW,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,QAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;AAEnF,IAAI,YAAY,EAAE,CAAC;IACjB,yBAAyB;IACzB,MAAM,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;QACpC,MAAM,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAC5B,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;QACjB,OAAO,CAAC,KAAK,CAAC,YAAY,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QACpF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;AACL,CAAC;KAAM,CAAC;IACN,mBAAmB;IACnB,cAAc,EAAE,CAAC;AACnB,CAAC;AAED,+EAA+E;AAC/E,aAAa;AACb,+EAA+E;AAC/E,KAAK,UAAU,cAAc;IAC3B,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,MAAM,CAAC,2CAA2C,CAAC,CAAC;IAC7E,MAAM,EAAE,oBAAoB,EAAE,GAAG,MAAM,MAAM,CAAC,2CAA2C,CAAC,CAAC;IAC3F,MAAM,EACJ,qBAAqB,EACrB,sBAAsB,GACvB,GAAG,MAAM,MAAM,CAAC,oCAAoC,CAAC,CAAC;IACvD,MAAM,EAAE,SAAS,EAAE,YAAY,EAAE,GAAG,MAAM,MAAM,CAAC,wBAAwB,CAAC,CAAC;IAC3E,MAAM,EAAE,eAAe,EAAE,GAAG,MAAM,MAAM,CAAC,2BAA2B,CAAC,CAAC;IACtE,MAAM,EAAE,cAAc,EAAE,GAAG,MAAM,MAAM,CAAC,2BAA2B,CAAC,CAAC;IACrE,MAAM,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,GAAG,MAAM,MAAM,CAAC,mBAAmB,CAAC,CAAC;IACjF,MAAM,EAAE,wBAAwB,EAAE,cAAc,EAAE,GAAG,MAAM,MAAM,CAAC,sBAAsB,CAAC,CAAC;IAC1F,MAAM,EAAE,yBAAyB,EAAE,gBAAgB,EAAE,GAAG,MAAM,MAAM,CAAC,0BAA0B,CAAC,CAAC;IAEjG,+BAA+B;IAC/B,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACnC,MAAM,UAAU,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;IAEnC,yCAAyC;IACzC,IAAI,CAAC;QACH,YAAY,CAAC,UAAU,CAAC,CAAC;IAC3B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QAChF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,oBAAoB;IACpB,MAAM,MAAM,GAAG,IAAI,MAAM,CACvB;QACE,IAAI,EAAE,WAAW;QACjB,OAAO,EAAE,OAAO;KACjB,EACD;QACE,YAAY,EAAE;YACZ,KAAK,EAAE,EAAE;SACV;KACF,CACF,CAAC;IAEF,sBAAsB;IACtB,MAAM,CAAC,iBAAiB,CAAC,sBAAsB,EAAE,KAAK,IAAI,EAAE;QAC1D,OAAO;YACL,KAAK,EAAE,eAAe,EAAE;SACzB,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,wBAAwB;IACxB,MAAM,CAAC,iBAAiB,CAAC,qBAAqB,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;QAChE,OAAO,MAAM,cAAc,CAAC,OAAO,CAAC,CAAC;IACvC,CAAC,CAAC,CAAC;IAEH,0CAA0C;IAC1C,wBAAwB,EAAE,CAAC;IAE3B,eAAe;IACf,IAAI,sBAAsB,GAAG,KAAK,CAAC;IAEnC,IAAI,CAAC;QACH,wDAAwD;QACxD,MAAM,WAAW,GAAG,MAAM,gBAAgB,CAAC,UAAU,CAAC,CAAC;QACvD,sBAAsB,GAAG,IAAI,CAAC;QAE9B,gEAAgE;QAChE,2EAA2E;QAC3E,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;QAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAEhC,mEAAmE;QACnE,gBAAgB,CAAC,8CAA8C,CAAC,CAAC;QAEjE,MAAM,MAAM,GAAG,UAAU,CAAC,MAAM,IAAI,WAAW,CAAC,UAAU,CAAC,QAAQ,EAAE,IAAI,CAAC;QAC1E,IAAI,MAAM,EAAE,CAAC;YACX,MAAM,MAAM,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,aAAa,CAAC;YACzD,gBAAgB,CAAC,eAAe,MAAM,UAAU,MAAM,GAAG,CAAC,CAAC;QAC7D,CAAC;QAED,gBAAgB,CAAC,cAAc,WAAW,CAAC,cAAc,CAAC,cAAc,EAAE,SAAS,WAAW,CAAC,cAAc,CAAC,YAAY,EAAE,aAAa,WAAW,CAAC,eAAe,GAAG,CAAC,CAAC;QACzK,gBAAgB,CAAC,kCAAkC,WAAW,CAAC,YAAY,CAAC,YAAY,mBAAmB,WAAW,CAAC,YAAY,CAAC,eAAe,qBAAqB,WAAW,CAAC,YAAY,CAAC,aAAa,EAAE,CAAC,CAAC;QAElN,sEAAsE;QACtE,IAAI,CAAC;YACH,MAAM,gBAAgB,EAAE,CAAC;QAC3B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,gBAAgB,CAAC,iCAAiC,EAAE,KAAK,CAAC,CAAC;YAC3D,gBAAgB,CAAC,yCAAyC,CAAC,CAAC;QAC9D,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,+DAA+D;QAC/D,IAAI,CAAC,sBAAsB,EAAE,CAAC;YAC5B,OAAO,CAAC,KAAK,CAAC,uDAAuD,EAAE,KAAK,CAAC,CAAC;YAC9E,IAAI,KAAK,YAAY,KAAK,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;gBAC1C,OAAO,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;YACvC,CAAC;QACH,CAAC;QAED,oEAAoE;QACpE,yBAAyB,CAAC,KAAK,CAAC,CAAC;QAEjC,cAAc,EAAE,CAAC;QACjB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/init-rules.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Auto-initialize sqlew on server startup
+ *
+ * As of v5.0.0, this module handles:
+ * - Global CLAUDE.md injection (~/.claude/CLAUDE.md)
+ * - Project .gitignore updates
+ *
+ * Skills and Hooks are managed by the sqlew-plugin (Claude Code Plugin).
+ * @see https://github.com/sqlew-io/sqlew-plugin for Skills/Hooks/Agents
+ */
+/**
+ * Inject sqlew snippets into global ~/.claude/CLAUDE.md
+ *
+ * As of v5.0.0, snippets are injected directly into CLAUDE.md instead of
+ * being copied to ~/.claude/rules/sqlew/. This ensures higher priority
+ * and better compatibility with other CLI tools (Codex, Gemini CLI).
+ *
+ * The injected section is wrapped with HTML comment markers for:
+ * - Easy identification of auto-managed content
+ * - Safe updates (replace existing section)
+ * - No impact on Markdown rendering
+ *
+ * TODO: Add client detection to conditionally inject based on CLI type
+ * Use server.getClientVersion() after MCP initialization
+ */
+export declare function injectToGlobalClaudeMd(): void;
+/**
+ * Initialize sqlew on MCP server startup
+ *
+ * As of v5.0.0:
+ * - Injects snippets into ~/.claude/CLAUDE.md (not rules/)
+ * - Updates project .gitignore
+ *
+ * @param projectRoot - Project root directory (for .gitignore updates)
+ */
+export declare function initializeSqlewRules(projectRoot: string): void;
+/**
+ * Initialize .sqlew/.gitignore with sqlew auto-generated file entries
+ * Creates .sqlew/.gitignore if it doesn't exist, adds missing entries if sqlew section exists
+ */
+export declare function initializeGitignore(projectRoot: string): void;
+//# sourceMappingURL=init-rules.d.ts.map

package/dist/init-rules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init-rules.d.ts","sourceRoot":"","sources":["../src/init-rules.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAwBH;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,sBAAsB,IAAI,IAAI,CAyE7C;AASD;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAS9D;AAoBD;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAkE7D"}

package/dist/init-rules.js

@@ -0,0 +1,217 @@
+/**
+ * Auto-initialize sqlew on server startup
+ *
+ * As of v5.0.0, this module handles:
+ * - Global CLAUDE.md injection (~/.claude/CLAUDE.md)
+ * - Project .gitignore updates
+ *
+ * Skills and Hooks are managed by the sqlew-plugin (Claude Code Plugin).
+ * @see https://github.com/sqlew-io/sqlew-plugin for Skills/Hooks/Agents
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import * as os from 'os';
+import { fileURLToPath } from 'url';
+import { debugLog } from './utils/debug-logger.js';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+/**
+ * Get path to assets directory (relative to dist/)
+ */
+function getAssetsPath() {
+    const distDir = __dirname; // .../dist
+    const packageRoot = path.dirname(distDir); // .../mcp-sqlew
+    return path.join(packageRoot, 'assets');
+}
+/** Marker for sqlew auto-injected section in CLAUDE.md */
+const CLAUDE_MD_MARKER_START = '<!-- sqlew:auto-injected:start -->';
+const CLAUDE_MD_MARKER_END = '<!-- sqlew:auto-injected:end -->';
+/**
+ * Inject sqlew snippets into global ~/.claude/CLAUDE.md
+ *
+ * As of v5.0.0, snippets are injected directly into CLAUDE.md instead of
+ * being copied to ~/.claude/rules/sqlew/. This ensures higher priority
+ * and better compatibility with other CLI tools (Codex, Gemini CLI).
+ *
+ * The injected section is wrapped with HTML comment markers for:
+ * - Easy identification of auto-managed content
+ * - Safe updates (replace existing section)
+ * - No impact on Markdown rendering
+ *
+ * TODO: Add client detection to conditionally inject based on CLI type
+ * Use server.getClientVersion() after MCP initialization
+ */
+export function injectToGlobalClaudeMd() {
+    const home = os.homedir();
+    const claudeDir = path.join(home, '.claude');
+    const claudeMdPath = path.join(claudeDir, 'CLAUDE.md');
+    const snippetsDir = path.join(getAssetsPath(), 'claude-md-snippets');
+    // Check if snippets directory exists
+    if (!fs.existsSync(snippetsDir)) {
+        debugLog('WARN', 'Claude MD snippets directory not found', { snippetsDir });
+        return;
+    }
+    // Create ~/.claude/ directory if needed
+    if (!fs.existsSync(claudeDir)) {
+        try {
+            fs.mkdirSync(claudeDir, { recursive: true });
+            debugLog('INFO', 'Created ~/.claude directory', { claudeDir });
+        }
+        catch (error) {
+            debugLog('WARN', 'Failed to create ~/.claude directory', { error });
+            return;
+        }
+    }
+    // Read current CLAUDE.md content (or empty string if doesn't exist)
+    let content = '';
+    if (fs.existsSync(claudeMdPath)) {
+        content = fs.readFileSync(claudeMdPath, 'utf-8');
+    }
+    else {
+        debugLog('INFO', 'Creating new ~/.claude/CLAUDE.md', { claudeMdPath });
+    }
+    // Find all .md files in snippets directory
+    const snippetFiles = fs.readdirSync(snippetsDir).filter(f => f.endsWith('.md'));
+    if (snippetFiles.length === 0) {
+        debugLog('WARN', 'No snippet files found', { snippetsDir });
+        return;
+    }
+    // Concatenate all snippet contents
+    const snippetContent = snippetFiles
+        .map(f => fs.readFileSync(path.join(snippetsDir, f), 'utf-8'))
+        .join('\n\n');
+    // Build the injected section
+    const injectedSection = `${CLAUDE_MD_MARKER_START}\n${snippetContent}\n${CLAUDE_MD_MARKER_END}`;
+    // Check if section already exists
+    if (content.includes(CLAUDE_MD_MARKER_START)) {
+        // Check if content is the same (no update needed)
+        const regex = new RegExp(`${escapeRegex(CLAUDE_MD_MARKER_START)}[\\s\\S]*?${escapeRegex(CLAUDE_MD_MARKER_END)}`, 'g');
+        const existingMatch = content.match(regex);
+        if (existingMatch && existingMatch[0] === injectedSection) {
+            debugLog('DEBUG', 'CLAUDE.md sqlew section is up-to-date');
+            return;
+        }
+        // Replace existing section
+        content = content.replace(regex, injectedSection);
+        debugLog('INFO', 'Updated sqlew section in CLAUDE.md', { files: snippetFiles.length });
+    }
+    else {
+        // Append new section
+        content = content.trimEnd() + '\n\n' + injectedSection + '\n';
+        debugLog('INFO', 'Injected sqlew section into CLAUDE.md', { files: snippetFiles.length });
+    }
+    // Write updated content
+    try {
+        fs.writeFileSync(claudeMdPath, content, 'utf-8');
+    }
+    catch (error) {
+        debugLog('WARN', 'Failed to write CLAUDE.md', { error });
+    }
+}
+/**
+ * Escape special regex characters in a string
+ */
+function escapeRegex(str) {
+    return str.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+/**
+ * Initialize sqlew on MCP server startup
+ *
+ * As of v5.0.0:
+ * - Injects snippets into ~/.claude/CLAUDE.md (not rules/)
+ * - Updates project .gitignore
+ *
+ * @param projectRoot - Project root directory (for .gitignore updates)
+ */
+export function initializeSqlewRules(projectRoot) {
+    debugLog('DEBUG', 'Initializing sqlew', { projectRoot });
+    // Inject snippets into global ~/.claude/CLAUDE.md
+    // TODO: Add client detection to conditionally inject
+    injectToGlobalClaudeMd();
+    // Initialize .gitignore entries for sqlew-generated files
+    initializeGitignore(projectRoot);
+}
+/**
+ * Files/directories auto-generated by sqlew that should be gitignored
+ *
+ * As of v5.0.0:
+ * - Skills and Hooks are managed by sqlew-plugin (not per-project)
+ * - Gitignore is placed inside .sqlew/ directory
+ *
+ * Note: *.db* catches .db, .db-journal, .db-wal, .db-shm files
+ */
+const SQLEW_GITIGNORE_ENTRIES = [
+    'queue/',
+    'tmp/',
+    '*.db*',
+];
+/** Marker comment for sqlew gitignore */
+const SQLEW_GITIGNORE_MARKER = '# sqlew auto-generated files';
+/**
+ * Initialize .sqlew/.gitignore with sqlew auto-generated file entries
+ * Creates .sqlew/.gitignore if it doesn't exist, adds missing entries if sqlew section exists
+ */
+export function initializeGitignore(projectRoot) {
+    const sqlewDir = path.join(projectRoot, '.sqlew');
+    const gitignorePath = path.join(sqlewDir, '.gitignore');
+    // Create .sqlew directory if needed
+    if (!fs.existsSync(sqlewDir)) {
+        try {
+            fs.mkdirSync(sqlewDir, { recursive: true });
+        }
+        catch (error) {
+            debugLog('WARN', 'Failed to create .sqlew directory', { error });
+            return;
+        }
+    }
+    // Read current .gitignore content (or empty string if doesn't exist)
+    let content = '';
+    if (fs.existsSync(gitignorePath)) {
+        content = fs.readFileSync(gitignorePath, 'utf-8');
+    }
+    else {
+        debugLog('INFO', '.sqlew/.gitignore not found, creating new file', { gitignorePath });
+    }
+    // Check if sqlew section already exists
+    if (content.includes(SQLEW_GITIGNORE_MARKER)) {
+        // Find missing entries
+        const missingEntries = SQLEW_GITIGNORE_ENTRIES.filter(entry => !content.includes(entry));
+        if (missingEntries.length === 0) {
+            debugLog('DEBUG', 'sqlew gitignore section is up-to-date');
+            return;
+        }
+        // Append missing entries after the marker
+        try {
+            const markerIndex = content.indexOf(SQLEW_GITIGNORE_MARKER);
+            const afterMarker = markerIndex + SQLEW_GITIGNORE_MARKER.length;
+            const newContent = content.slice(0, afterMarker) +
+                '\n' + missingEntries.join('\n') +
+                content.slice(afterMarker);
+            fs.writeFileSync(gitignorePath, newContent, 'utf-8');
+            debugLog('INFO', 'Added missing sqlew entries to .sqlew/.gitignore', {
+                entries: missingEntries
+            });
+        }
+        catch (error) {
+            debugLog('WARN', 'Failed to update .sqlew/.gitignore', { error });
+        }
+        return;
+    }
+    // Build section to add (fresh install)
+    const sectionLines = [
+        SQLEW_GITIGNORE_MARKER,
+        ...SQLEW_GITIGNORE_ENTRIES,
+    ];
+    // Write to .sqlew/.gitignore
+    try {
+        const newContent = content.trimEnd() + (content ? '\n' : '') + sectionLines.join('\n') + '\n';
+        fs.writeFileSync(gitignorePath, newContent, 'utf-8');
+        debugLog('INFO', 'Created .sqlew/.gitignore', {
+            entries: SQLEW_GITIGNORE_ENTRIES.length
+        });
+    }
+    catch (error) {
+        debugLog('WARN', 'Failed to create .sqlew/.gitignore', { error });
+    }
+}
+//# sourceMappingURL=init-rules.js.map

package/dist/init-rules.js.map

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

package/dist/saas-connector/auth/auth-manager.d.ts

@@ -0,0 +1,6 @@
+export declare class AuthManager {
+    private apiKey;
+    constructor(apiKey: string);
+    getAuthorizationHeader(): string;
+}
+//# sourceMappingURL=auth-manager.d.ts.map

package/dist/saas-connector/auth/auth-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth-manager.d.ts","sourceRoot":"","sources":["../../../src/saas-connector/auth/auth-manager.ts"],"names":[],"mappings":"AAAA,qBAAa,WAAW;IACV,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,MAAM;IAMlC,sBAAsB,IAAI,MAAM;CAGjC"}

package/dist/saas-connector/auth/auth-manager.js

@@ -0,0 +1,13 @@
+export class AuthManager {
+    apiKey;
+    constructor(apiKey) {
+        this.apiKey = apiKey;
+        if (!apiKey || apiKey.trim() === '') {
+            throw new Error('API key is required');
+        }
+    }
+    getAuthorizationHeader() {
+        return `Bearer ${this.apiKey}`;
+    }
+}
+//# sourceMappingURL=auth-manager.js.map

package/dist/saas-connector/auth/auth-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth-manager.js","sourceRoot":"","sources":["../../../src/saas-connector/auth/auth-manager.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,WAAW;IACF;IAApB,YAAoB,MAAc;QAAd,WAAM,GAAN,MAAM,CAAQ;QAChC,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;YACpC,MAAM,IAAI,KAAK,CAAC,qBAAqB,CAAC,CAAC;QACzC,CAAC;IACH,CAAC;IAED,sBAAsB;QACpB,OAAO,UAAU,IAAI,CAAC,MAAM,EAAE,CAAC;IACjC,CAAC;CACF"}

package/dist/saas-connector/backend/saas-backend.d.ts

@@ -0,0 +1,20 @@
+import type { CloudConfig, ToolBackend, HealthCheckResult } from '../client/types.js';
+export declare class SaaSBackend implements ToolBackend {
+    readonly backendType: "saas";
+    readonly pluginName = "saas-connector";
+    private httpClient;
+    constructor(config: CloudConfig);
+    execute<T>(tool: string, action: string, params: Record<string, unknown>): Promise<T>;
+    /**
+     * Normalize params for SaaS API compatibility
+     * Maps client param names to SaaS API expected names
+     */
+    private normalizeParams;
+    healthCheck(): Promise<HealthCheckResult>;
+    disconnect(): Promise<void>;
+    /**
+     * Set agent name for X-Agent header (called after MCP handshake)
+     */
+    setAgentName(name: string): void;
+}
+//# sourceMappingURL=saas-backend.d.ts.map

package/dist/saas-connector/backend/saas-backend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"saas-backend.d.ts","sourceRoot":"","sources":["../../../src/saas-connector/backend/saas-backend.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,WAAW,EACX,WAAW,EACX,iBAAiB,EAClB,MAAM,oBAAoB,CAAC;AAE5B,qBAAa,WAAY,YAAW,WAAW;IAC7C,QAAQ,CAAC,WAAW,EAAG,MAAM,CAAU;IACvC,QAAQ,CAAC,UAAU,oBAAoB;IAEvC,OAAO,CAAC,UAAU,CAAa;gBAEnB,MAAM,EAAE,WAAW;IAUzB,OAAO,CAAC,CAAC,EACb,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,OAAO,CAAC,CAAC,CAAC;IA2Bb;;;OAGG;IACH,OAAO,CAAC,eAAe;IAkBjB,WAAW,IAAI,OAAO,CAAC,iBAAiB,CAAC;IAiBzC,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAIjC;;OAEG;IACH,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;CAGjC"}

package/dist/saas-connector/backend/saas-backend.js

@@ -0,0 +1,71 @@
+import { HttpClient } from '../client/http-client.js';
+import { AuthManager } from '../auth/auth-manager.js';
+import { ApiError } from '../errors/api-error.js';
+import { SUPPORTED_TOOLS, isLocalOnlyAction } from '../config/constants.js';
+export class SaaSBackend {
+    backendType = 'saas';
+    pluginName = 'saas-connector';
+    httpClient;
+    constructor(config) {
+        const authManager = new AuthManager(config.apiKey);
+        this.httpClient = new HttpClient(authManager, config.projectName, config.projectId, config.connectionIdentity);
+    }
+    async execute(tool, action, params) {
+        // Check if this action should be handled locally (no DB access required)
+        if (isLocalOnlyAction(tool, action)) {
+            throw new ApiError('LOCAL_ONLY_ACTION', `Action '${tool}.${action}' should be handled locally (no DB access required)`, 200 // Not an error, just a signal to fallback
+            );
+        }
+        // Validate supported tools
+        if (!SUPPORTED_TOOLS.includes(tool)) {
+            throw new ApiError('UNSUPPORTED_TOOL', `Tool '${tool}' is not supported in SaaS mode. Supported tools: ${SUPPORTED_TOOLS.join(', ')}`, 400);
+        }
+        // Normalize params for SaaS API compatibility
+        const normalizedParams = this.normalizeParams(tool, action, params);
+        // Call SaaS API
+        const endpoint = `/api/v1/${tool}/${action}`;
+        return await this.httpClient.post(endpoint, normalizedParams);
+    }
+    /**
+     * Normalize params for SaaS API compatibility
+     * Maps client param names to SaaS API expected names
+     */
+    normalizeParams(tool, action, params) {
+        const result = { ...params };
+        // constraint.deactivate/activate: constraint_id → id
+        if (tool === 'constraint' && (action === 'deactivate' || action === 'activate')) {
+            if ('constraint_id' in result && !('id' in result)) {
+                result.id = result.constraint_id;
+                delete result.constraint_id;
+            }
+        }
+        return result;
+    }
+    async healthCheck() {
+        const start = Date.now();
+        try {
+            await this.httpClient.get('/health');
+            return {
+                ok: true,
+                latency: Date.now() - start,
+            };
+        }
+        catch (error) {
+            return {
+                ok: false,
+                latency: Date.now() - start,
+                message: error instanceof Error ? error.message : String(error),
+            };
+        }
+    }
+    async disconnect() {
+        // HTTP client doesn't need explicit disconnect
+    }
+    /**
+     * Set agent name for X-Agent header (called after MCP handshake)
+     */
+    setAgentName(name) {
+        this.httpClient.setAgentName(name);
+    }
+}
+//# sourceMappingURL=saas-backend.js.map

package/dist/saas-connector/backend/saas-backend.js.map

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

package/dist/saas-connector/client/http-client.d.ts

@@ -0,0 +1,33 @@
+import { AuthManager } from '../auth/auth-manager.js';
+import type { ConnectionIdentity } from './types.js';
+export declare class HttpClient {
+    private authManager;
+    private projectName?;
+    private projectId?;
+    private connectionIdentity?;
+    private agentName?;
+    constructor(authManager: AuthManager, projectName?: string | undefined, projectId?: string | undefined, connectionIdentity?: ConnectionIdentity | undefined);
+    /**
+     * Set agent name for X-Agent header (called after MCP handshake)
+     */
+    setAgentName(name: string): void;
+    post<T>(path: string, body: Record<string, unknown>): Promise<T>;
+    get<T>(path: string): Promise<T>;
+    private executeWithRetry;
+    private handleResponse;
+    private calculateRetryDelay;
+    private sleep;
+}
+/**
+ * Resolve project name to UUID via /api/v1/project/resolve
+ *
+ * This is a standalone function used before HttpClient is fully initialized,
+ * since we need the projectId to construct HttpClient.
+ *
+ * @param apiKey - API key for authentication
+ * @param projectName - Project name from config.toml
+ * @returns Resolved project UUID
+ * @throws ApiError on authentication or resolution failure
+ */
+export declare function resolveProject(apiKey: string, projectName: string): Promise<string>;
+//# sourceMappingURL=http-client.d.ts.map

package/dist/saas-connector/client/http-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-client.d.ts","sourceRoot":"","sources":["../../../src/saas-connector/client/http-client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAStD,OAAO,KAAK,EAAe,kBAAkB,EAA0B,MAAM,YAAY,CAAC;AAE1F,qBAAa,UAAU;IAInB,OAAO,CAAC,WAAW;IACnB,OAAO,CAAC,WAAW,CAAC;IACpB,OAAO,CAAC,SAAS,CAAC;IAClB,OAAO,CAAC,kBAAkB,CAAC;IAN7B,OAAO,CAAC,SAAS,CAAC,CAAS;gBAGjB,WAAW,EAAE,WAAW,EACxB,WAAW,CAAC,EAAE,MAAM,YAAA,EACpB,SAAS,CAAC,EAAE,MAAM,YAAA,EAClB,kBAAkB,CAAC,EAAE,kBAAkB,YAAA;IAGjD;;OAEG;IACH,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAI1B,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAuChE,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;YAwBxB,gBAAgB;YAuChB,cAAc;IA4C5B,OAAO,CAAC,mBAAmB;IAmB3B,OAAO,CAAC,KAAK;CAGd;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,cAAc,CAClC,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,MAAM,CAAC,CAoDjB"}