@fractary/core-mcp 0.2.2 → 0.3.0

package/dist/config.d.ts

@@ -1,5 +1,9 @@
+import { sanitizeSecrets } from '@fractary/core/common/secrets';
 /**
  * Configuration interface for the MCP server
+ *
+ * This is a flattened view of the SDK's handler-based configuration,
+ * designed for simpler tool access patterns.
  */
 export interface Config {
     work?: {
@@ -24,17 +28,41 @@ export interface Config {
     };
     file?: {
         basePath?: string;
+        sources?: Record<string, {
+            type: 'local' | 's3' | 'r2' | 'gcs' | 'gdrive';
+            bucket?: string;
+            prefix?: string;
+            region?: string;
+            projectId?: string;
+            accountId?: string;
+            folderId?: string;
+            local?: {
+                basePath: string;
+            };
+            auth?: {
+                profile?: string;
+                accessKeyId?: string;
+                secretAccessKey?: string;
+                keyFilePath?: string;
+            };
+            publicUrl?: string;
+        }>;
     };
     docs?: {
         docsDir?: string;
     };
 }
 /**
- * Load configuration from environment variables and config files
- * Priority:
- * 1. Environment variables
- * 2. Project config: {cwd}/.fractary/core/config.yaml
- * 3. User config: ~/.fractary/core/config.yaml
+ * Load configuration using the SDK's unified config loader
+ *
+ * This delegates to @fractary/core's loadConfig which handles:
+ * - Loading .env files
+ * - Loading YAML config from .fractary/config.yaml or .fractary/core/config.yaml
+ * - Environment variable substitution
+ * - Token provider creation
+ *
+ * The SDK config is then converted to MCP's flat format for tool access.
  */
 export declare function loadConfig(): Promise<Config>;
+export { sanitizeSecrets };
 //# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAOA;;GAEG;AACH,MAAM,WAAW,MAAM;IACrB,IAAI,CAAC,EAAE;QACL,QAAQ,EAAE,QAAQ,GAAG,MAAM,GAAG,QAAQ,CAAC;QACvC,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,IAAI,CAAC,EAAE;QACL,QAAQ,EAAE,QAAQ,GAAG,QAAQ,GAAG,WAAW,CAAC;QAC5C,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,aAAa,CAAC,EAAE,MAAM,CAAC;KACxB,CAAC;IACF,IAAI,CAAC,EAAE;QACL,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;IACF,IAAI,CAAC,EAAE;QACL,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;IACF,IAAI,CAAC,EAAE;QACL,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC;IACF,IAAI,CAAC,EAAE;QACL,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;CACH;AAED;;;;;;GAMG;AACH,wBAAsB,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC,CAsIlD"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAEhE;;;;;GAKG;AACH,MAAM,WAAW,MAAM;IACrB,IAAI,CAAC,EAAE;QACL,QAAQ,EAAE,QAAQ,GAAG,MAAM,GAAG,QAAQ,CAAC;QACvC,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,IAAI,CAAC,EAAE;QACL,QAAQ,EAAE,QAAQ,GAAG,QAAQ,GAAG,WAAW,CAAC;QAC5C,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,aAAa,CAAC,EAAE,MAAM,CAAC;KACxB,CAAC;IACF,IAAI,CAAC,EAAE;QACL,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;IACF,IAAI,CAAC,EAAE;QACL,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;IACF,IAAI,CAAC,EAAE;QACL,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,OAAO,CAAC,EAAE,MAAM,CACd,MAAM,EACN;YACE,IAAI,EAAE,OAAO,GAAG,IAAI,GAAG,IAAI,GAAG,KAAK,GAAG,QAAQ,CAAC;YAC/C,MAAM,CAAC,EAAE,MAAM,CAAC;YAChB,MAAM,CAAC,EAAE,MAAM,CAAC;YAChB,MAAM,CAAC,EAAE,MAAM,CAAC;YAChB,SAAS,CAAC,EAAE,MAAM,CAAC;YACnB,SAAS,CAAC,EAAE,MAAM,CAAC;YACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;YAClB,KAAK,CAAC,EAAE;gBAAE,QAAQ,EAAE,MAAM,CAAA;aAAE,CAAC;YAC7B,IAAI,CAAC,EAAE;gBACL,OAAO,CAAC,EAAE,MAAM,CAAC;gBACjB,WAAW,CAAC,EAAE,MAAM,CAAC;gBACrB,eAAe,CAAC,EAAE,MAAM,CAAC;gBACzB,WAAW,CAAC,EAAE,MAAM,CAAC;aACtB,CAAC;YACF,SAAS,CAAC,EAAE,MAAM,CAAC;SACpB,CACF,CAAC;KACH,CAAC;IACF,IAAI,CAAC,EAAE;QACL,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;CACH;AA+JD;;;;;;;;;;GAUG;AACH,wBAAsB,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC,CAoBlD;AAGD,OAAO,EAAE,eAAe,EAAE,CAAC"}

package/dist/config.js

@@ -1,136 +1,133 @@
-import { access } from 'fs/promises';
-import { join } from 'path';
-import { homedir } from 'os';
-import { constants } from 'fs';
-import { sanitizeSecrets } from './handlers/security.js';
-import { loadYamlConfig, findProjectRoot } from '@fractary/core/common/yaml-config';
+import { loadConfig as sdkLoadConfig, loadEnv, } from '@fractary/core/config';
+import { sanitizeSecrets } from '@fractary/core/common/secrets';
 /**
- * Load configuration from environment variables and config files
- * Priority:
- * 1. Environment variables
- * 2. Project config: {cwd}/.fractary/core/config.yaml
- * 3. User config: ~/.fractary/core/config.yaml
+ * Type guard to safely check if a value is an object
  */
-export async function loadConfig() {
+function isObject(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+/**
+ * Convert SDK's LoadedConfig to MCP's flat Config format
+ *
+ * The SDK uses a handler-based config structure (active_handler + handlers map),
+ * while MCP uses a flattened structure for simpler tool access.
+ */
+function convertToMcpConfig(sdkConfig) {
     const config = {};
-    // 1. Load from environment variables
-    // Priority order: GITHUB > JIRA > LINEAR for work, GITHUB > GITLAB > BITBUCKET for repo
-    // Only set if not already configured (respects priority)
-    // Work configuration (GitHub takes priority)
-    if (process.env.GITHUB_TOKEN && !config.work) {
+    // Convert work config
+    if (sdkConfig.work) {
+        const activeHandler = sdkConfig.work.active_handler;
+        const handlerConfig = sdkConfig.work.handlers?.[activeHandler] || {};
         config.work = {
-            platform: 'github',
-            owner: process.env.GITHUB_OWNER,
-            repo: process.env.GITHUB_REPO,
-            token: process.env.GITHUB_TOKEN,
+            platform: activeHandler,
+            owner: handlerConfig.owner,
+            repo: handlerConfig.repo,
+            token: handlerConfig.token,
+            project: handlerConfig.project,
         };
     }
-    if (process.env.JIRA_TOKEN && !config.work) {
-        config.work = {
-            platform: 'jira',
-            token: process.env.JIRA_TOKEN,
-            project: process.env.JIRA_PROJECT,
+    // Convert repo config
+    if (sdkConfig.repo) {
+        const activeHandler = sdkConfig.repo.active_handler;
+        const handlerConfig = sdkConfig.repo.handlers?.[activeHandler] || {};
+        config.repo = {
+            platform: activeHandler,
+            owner: handlerConfig.owner,
+            repo: handlerConfig.repo,
+            token: handlerConfig.token,
+            defaultBranch: sdkConfig.repo.defaults?.default_branch,
         };
     }
-    if (process.env.LINEAR_API_KEY && !config.work) {
-        config.work = {
-            platform: 'linear',
-            token: process.env.LINEAR_API_KEY,
+    // Convert spec config - SDK uses storage-based config
+    if (sdkConfig.spec && isObject(sdkConfig.spec)) {
+        const storage = sdkConfig.spec.storage;
+        config.spec = {
+            localPath: storage?.local?.path,
         };
     }
-    // Repo configuration (GitHub takes priority)
-    if (process.env.GITHUB_TOKEN && !config.repo) {
-        config.repo = {
-            platform: 'github',
-            owner: process.env.GITHUB_OWNER,
-            repo: process.env.GITHUB_REPO,
-            token: process.env.GITHUB_TOKEN,
+    // Convert logs config - SDK uses storage-based config
+    if (sdkConfig.logs && isObject(sdkConfig.logs)) {
+        const storage = sdkConfig.logs.storage;
+        config.logs = {
+            localPath: storage?.local?.path,
         };
     }
-    if (process.env.GITLAB_TOKEN && !config.repo) {
-        config.repo = {
-            platform: 'gitlab',
-            owner: process.env.GITLAB_OWNER,
-            repo: process.env.GITLAB_REPO,
-            token: process.env.GITLAB_TOKEN,
+    // Convert file config - SDK uses sources-based config
+    if (sdkConfig.file && isObject(sdkConfig.file)) {
+        const fileConfig = sdkConfig.file;
+        const sources = fileConfig.sources;
+        const mcpSources = {};
+        if (sources) {
+            for (const [name, source] of Object.entries(sources)) {
+                if (source && source.type) {
+                    mcpSources[name] = {
+                        type: source.type,
+                        bucket: source.bucket,
+                        prefix: source.prefix,
+                        region: source.region,
+                        projectId: source.projectId,
+                        accountId: source.accountId,
+                        folderId: source.folderId,
+                        local: source.local,
+                        auth: source.auth,
+                        publicUrl: source.publicUrl,
+                    };
+                }
+            }
+        }
+        config.file = {
+            basePath: fileConfig.global_settings?.basePath,
+            sources: Object.keys(mcpSources).length > 0 ? mcpSources : undefined,
         };
     }
-    if (process.env.BITBUCKET_TOKEN && !config.repo) {
-        config.repo = {
-            platform: 'bitbucket',
-            owner: process.env.BITBUCKET_OWNER,
-            repo: process.env.BITBUCKET_REPO,
-            token: process.env.BITBUCKET_TOKEN,
+    // Convert docs config - SDK uses output_paths or custom_templates_path
+    if (sdkConfig.docs && isObject(sdkConfig.docs)) {
+        const docsConfig = sdkConfig.docs;
+        config.docs = {
+            docsDir: docsConfig.output_paths?.default || docsConfig.custom_templates_path,
         };
     }
-    // 2. Load from YAML config files (project first, then user)
-    const projectRoot = findProjectRoot(process.cwd());
-    const configPaths = [
-        join(projectRoot, '.fractary', 'core', 'config.yaml'),
-        join(homedir(), '.fractary', 'core', 'config.yaml'),
-    ];
-    for (const configPath of configPaths) {
-        try {
-            // Check if file exists
-            await access(configPath, constants.F_OK);
-            // Load YAML config using unified loader
-            const fileConfig = loadYamlConfig({
-                projectRoot: configPath.includes(homedir()) ? homedir() : projectRoot,
-                warnMissingEnvVars: false, // Don't warn in MCP server context
-            });
-            if (!fileConfig) {
-                continue;
-            }
-            // Merge file config with existing config (env vars take precedence)
-            // Convert SDK's handler-based config to MCP's flat config format
-            if (fileConfig.work && !config.work) {
-                const activeHandler = fileConfig.work.active_handler;
-                const handlerConfig = fileConfig.work.handlers?.[activeHandler] || {};
-                config.work = {
-                    platform: activeHandler,
-                    owner: handlerConfig.owner,
-                    repo: handlerConfig.repo,
-                    token: handlerConfig.token,
-                    project: handlerConfig.project,
-                };
-            }
-            if (fileConfig.repo && !config.repo) {
-                const activeHandler = fileConfig.repo.active_handler;
-                const handlerConfig = fileConfig.repo.handlers?.[activeHandler] || {};
-                config.repo = {
-                    platform: activeHandler,
-                    owner: handlerConfig.owner,
-                    repo: handlerConfig.repo,
-                    token: handlerConfig.token,
-                    defaultBranch: fileConfig.repo.defaults?.default_branch,
-                };
-            }
-            if (fileConfig.spec) {
-                config.spec = { ...fileConfig.spec, ...config.spec };
-            }
-            if (fileConfig.logs) {
-                config.logs = { ...fileConfig.logs, ...config.logs };
-            }
-            if (fileConfig.file) {
-                config.file = { ...fileConfig.file, ...config.file };
-            }
-            if (fileConfig.docs) {
-                config.docs = { ...fileConfig.docs, ...config.docs };
-            }
-            // Use first config file found
-            break;
-        }
-        catch (error) {
-            // File doesn't exist or read error - skip to next path
-            if (error instanceof Error && 'code' in error && error.code !== 'ENOENT') {
-                // Sanitize error message to prevent token/secret exposure (only for non-ENOENT errors)
-                // Uses comprehensive secret detection to catch tokens, API keys, bearer auth, etc.
-                const sanitizedError = sanitizeSecrets(error.message);
-                const sanitizedPath = sanitizeSecrets(configPath);
-                console.error(`Failed to load config from ${sanitizedPath}:`, sanitizedError);
-            }
+    return config;
+}
+/**
+ * Sanitize an error for safe logging, including both message and stack trace
+ */
+function sanitizeError(error) {
+    const sanitizedMessage = sanitizeSecrets(error.message);
+    const sanitizedStack = error.stack ? sanitizeSecrets(error.stack) : undefined;
+    return sanitizedStack || sanitizedMessage;
+}
+/**
+ * Load configuration using the SDK's unified config loader
+ *
+ * This delegates to @fractary/core's loadConfig which handles:
+ * - Loading .env files
+ * - Loading YAML config from .fractary/config.yaml or .fractary/core/config.yaml
+ * - Environment variable substitution
+ * - Token provider creation
+ *
+ * The SDK config is then converted to MCP's flat format for tool access.
+ */
+export async function loadConfig() {
+    try {
+        // Ensure .env is loaded before config
+        loadEnv();
+        // Use SDK's unified config loader
+        const sdkConfig = await sdkLoadConfig({
+            warnMissingEnvVars: false, // Don't warn in MCP server context
+        });
+        // Convert SDK's handler-based config to MCP's flat format
+        return convertToMcpConfig(sdkConfig);
+    }
+    catch (error) {
+        // Sanitize error message AND stack trace to prevent token/secret exposure
+        if (error instanceof Error) {
+            console.error(`Failed to load config: ${sanitizeError(error)}`);
         }
+        // Return empty config on error - tools will handle missing config gracefully
+        return {};
     }
-    return config;
 }
+// Re-export sanitizeSecrets for use by handlers
+export { sanitizeSecrets };
 //# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/handlers/file.d.ts

@@ -5,6 +5,7 @@ import { Config } from '../config.js';
  */
 export declare function handleFileRead(params: {
     path: string;
+    source?: string;
     encoding?: string;
 }, config: Config): Promise<CallToolResult>;
 /**
@@ -13,6 +14,7 @@ export declare function handleFileRead(params: {
 export declare function handleFileWrite(params: {
     path: string;
     content: string;
+    source?: string;
     encoding?: string;
     overwrite?: boolean;
 }, config: Config): Promise<CallToolResult>;
@@ -21,6 +23,7 @@ export declare function handleFileWrite(params: {
  */
 export declare function handleFileList(params: {
     path?: string;
+    source?: string;
     pattern?: string;
     recursive?: boolean;
 }, config: Config): Promise<CallToolResult>;
@@ -29,12 +32,14 @@ export declare function handleFileList(params: {
  */
 export declare function handleFileDelete(params: {
     path: string;
+    source?: string;
 }, config: Config): Promise<CallToolResult>;
 /**
  * Handler for fractary_file_exists
  */
 export declare function handleFileExists(params: {
     path: string;
+    source?: string;
 }, config: Config): Promise<CallToolResult>;
 /**
  * Handler for fractary_file_copy
@@ -42,6 +47,7 @@ export declare function handleFileExists(params: {
 export declare function handleFileCopy(params: {
     source: string;
     destination: string;
+    sourceStorage?: string;
     overwrite?: boolean;
 }, config: Config): Promise<CallToolResult>;
 /**
@@ -50,6 +56,15 @@ export declare function handleFileCopy(params: {
 export declare function handleFileMove(params: {
     source: string;
     destination: string;
+    sourceStorage?: string;
     overwrite?: boolean;
 }, config: Config): Promise<CallToolResult>;
+/**
+ * Handler for fractary_file_get_url
+ */
+export declare function handleFileGetUrl(params: {
+    path: string;
+    source?: string;
+    expiresIn?: number;
+}, config: Config): Promise<CallToolResult>;
 //# sourceMappingURL=file.d.ts.map

package/dist/handlers/file.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"file.d.ts","sourceRoot":"","sources":["../../src/handlers/file.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAGpE,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAItC;;GAEG;AACH,wBAAsB,cAAc,CAClC,MAAM,EAAE;IACN,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,EACD,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,cAAc,CAAC,CAczB;AAED;;GAEG;AACH,wBAAsB,eAAe,CACnC,MAAM,EAAE;IACN,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB,EACD,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,cAAc,CAAC,CAuBzB;AAED;;GAEG;AACH,wBAAsB,cAAc,CAClC,MAAM,EAAE;IACN,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB,EACD,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,cAAc,CAAC,CAsBzB;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,MAAM,EAAE;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,EACxB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,cAAc,CAAC,CAczB;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,MAAM,EAAE;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,EACxB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,cAAc,CAAC,CAczB;AAED;;GAEG;AACH,wBAAsB,cAAc,CAClC,MAAM,EAAE;IACN,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB,EACD,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,cAAc,CAAC,CAwBzB;AAED;;GAEG;AACH,wBAAsB,cAAc,CAClC,MAAM,EAAE;IACN,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB,EACD,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,cAAc,CAAC,CAwBzB"}
+{"version":3,"file":"file.d.ts","sourceRoot":"","sources":["../../src/handlers/file.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAIpE,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAkCtC;;GAEG;AACH,wBAAsB,cAAc,CAClC,MAAM,EAAE;IACN,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,EACD,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,cAAc,CAAC,CAczB;AAED;;GAEG;AACH,wBAAsB,eAAe,CACnC,MAAM,EAAE;IACN,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB,EACD,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,cAAc,CAAC,CAuBzB;AAED;;GAEG;AACH,wBAAsB,cAAc,CAClC,MAAM,EAAE;IACN,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB,EACD,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,cAAc,CAAC,CA0BzB;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,MAAM,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,EACzC,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,cAAc,CAAC,CAczB;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,MAAM,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,EACzC,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,cAAc,CAAC,CAczB;AAED;;GAEG;AACH,wBAAsB,cAAc,CAClC,MAAM,EAAE;IACN,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB,EACD,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,cAAc,CAAC,CA4BzB;AAED;;GAEG;AACH,wBAAsB,cAAc,CAClC,MAAM,EAAE;IACN,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB,EACD,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,cAAc,CAAC,CA4BzB;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,MAAM,EAAE;IACN,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,EACD,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,cAAc,CAAC,CAczB"}

package/dist/handlers/file.js

@@ -1,16 +1,40 @@
-import { FileManager } from '@fractary/core/file';
+import { FileManager, createStorageFromSource } from '@fractary/core/file';
 import { minimatch } from 'minimatch';
 import { successResult, errorResult } from './helpers.js';
 import { validatePath } from './security.js';
+/**
+ * Create a FileManager based on config
+ *
+ * Supports:
+ * 1. Named source from config.file.sources
+ * 2. Direct storage config
+ * 3. Base path (local storage)
+ */
+function createFileManager(config, options) {
+    // If a specific source is requested
+    if (options?.source && config.file?.sources?.[options.source]) {
+        const storage = createStorageFromSource(options.source, {
+            sources: config.file.sources,
+        });
+        return new FileManager({ storage });
+    }
+    // If direct storage config is provided
+    if (options?.storageConfig) {
+        return new FileManager({ storageConfig: options.storageConfig });
+    }
+    // Default: local storage
+    const basePath = config.file?.basePath || '.fractary/files';
+    return new FileManager({ basePath });
+}
 /**
  * Handler for fractary_file_read
  */
 export async function handleFileRead(params, config) {
     try {
         const basePath = config.file?.basePath || '.fractary/files';
-        // Validate path to prevent directory traversal
-        const safePath = validatePath(params.path, basePath);
-        const manager = new FileManager({ basePath });
+        // Validate path to prevent directory traversal (only for local storage)
+        const safePath = params.source ? params.path : validatePath(params.path, basePath);
+        const manager = createFileManager(config, { source: params.source });
         const content = await manager.read(safePath);
         return successResult({ path: safePath, content });
     }
@@ -25,9 +49,9 @@ export async function handleFileRead(params, config) {
 export async function handleFileWrite(params, config) {
     try {
         const basePath = config.file?.basePath || '.fractary/files';
-        // Validate path to prevent directory traversal
-        const safePath = validatePath(params.path, basePath);
-        const manager = new FileManager({ basePath });
+        // Validate path to prevent directory traversal (only for local storage)
+        const safePath = params.source ? params.path : validatePath(params.path, basePath);
+        const manager = createFileManager(config, { source: params.source });
         // Check if file exists and overwrite is false
         if (params.overwrite === false) {
             const exists = await manager.exists(safePath);
@@ -49,9 +73,13 @@ export async function handleFileWrite(params, config) {
 export async function handleFileList(params, config) {
     try {
         const basePath = config.file?.basePath || '.fractary/files';
-        // Validate path to prevent directory traversal (if provided)
-        const safePath = params.path ? validatePath(params.path, basePath) : undefined;
-        const manager = new FileManager({ basePath });
+        // Validate path to prevent directory traversal (if provided and local storage)
+        const safePath = params.path
+            ? params.source
+                ? params.path
+                : validatePath(params.path, basePath)
+            : undefined;
+        const manager = createFileManager(config, { source: params.source });
         const files = await manager.list(safePath);
         // Apply pattern filtering if provided using safe minimatch library
         let filteredFiles = files;
@@ -72,9 +100,9 @@ export async function handleFileList(params, config) {
 export async function handleFileDelete(params, config) {
     try {
         const basePath = config.file?.basePath || '.fractary/files';
-        // Validate path to prevent directory traversal
-        const safePath = validatePath(params.path, basePath);
-        const manager = new FileManager({ basePath });
+        // Validate path to prevent directory traversal (only for local storage)
+        const safePath = params.source ? params.path : validatePath(params.path, basePath);
+        const manager = createFileManager(config, { source: params.source });
         await manager.delete(safePath);
         return successResult({ path: safePath, deleted: true });
     }
@@ -89,9 +117,9 @@ export async function handleFileDelete(params, config) {
 export async function handleFileExists(params, config) {
     try {
         const basePath = config.file?.basePath || '.fractary/files';
-        // Validate path to prevent directory traversal
-        const safePath = validatePath(params.path, basePath);
-        const manager = new FileManager({ basePath });
+        // Validate path to prevent directory traversal (only for local storage)
+        const safePath = params.source ? params.path : validatePath(params.path, basePath);
+        const manager = createFileManager(config, { source: params.source });
         const exists = await manager.exists(safePath);
         return successResult({ path: safePath, exists });
     }
@@ -106,10 +134,14 @@ export async function handleFileExists(params, config) {
 export async function handleFileCopy(params, config) {
     try {
         const basePath = config.file?.basePath || '.fractary/files';
-        // Validate both source and destination paths to prevent directory traversal
-        const safeSource = validatePath(params.source, basePath);
-        const safeDestination = validatePath(params.destination, basePath);
-        const manager = new FileManager({ basePath });
+        // Validate both source and destination paths to prevent directory traversal (only for local)
+        const safeSource = params.sourceStorage
+            ? params.source
+            : validatePath(params.source, basePath);
+        const safeDestination = params.sourceStorage
+            ? params.destination
+            : validatePath(params.destination, basePath);
+        const manager = createFileManager(config, { source: params.sourceStorage });
         // Check if destination exists and overwrite is false
         if (params.overwrite === false) {
             const exists = await manager.exists(safeDestination);
@@ -131,10 +163,14 @@ export async function handleFileCopy(params, config) {
 export async function handleFileMove(params, config) {
     try {
         const basePath = config.file?.basePath || '.fractary/files';
-        // Validate both source and destination paths to prevent directory traversal
-        const safeSource = validatePath(params.source, basePath);
-        const safeDestination = validatePath(params.destination, basePath);
-        const manager = new FileManager({ basePath });
+        // Validate both source and destination paths to prevent directory traversal (only for local)
+        const safeSource = params.sourceStorage
+            ? params.source
+            : validatePath(params.source, basePath);
+        const safeDestination = params.sourceStorage
+            ? params.destination
+            : validatePath(params.destination, basePath);
+        const manager = createFileManager(config, { source: params.sourceStorage });
         // Check if destination exists and overwrite is false
         if (params.overwrite === false) {
             const exists = await manager.exists(safeDestination);
@@ -150,4 +186,23 @@ export async function handleFileMove(params, config) {
         return errorResult(`Error moving file: ${message}`);
     }
 }
+/**
+ * Handler for fractary_file_get_url
+ */
+export async function handleFileGetUrl(params, config) {
+    try {
+        const manager = createFileManager(config, { source: params.source });
+        const url = await manager.getUrl(params.path, params.expiresIn);
+        if (url) {
+            return successResult({ path: params.path, url });
+        }
+        else {
+            return errorResult('URL generation not supported for this storage type');
+        }
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : 'Unknown error';
+        return errorResult(`Error getting file URL: ${message}`);
+    }
+}
 //# sourceMappingURL=file.js.map

package/dist/handlers/file.js.map

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

package/dist/handlers/security.d.ts

@@ -1,3 +1,4 @@
+export { sanitizeSecrets, containsSecrets } from '@fractary/core/common/secrets';
 /**
  * Security helper functions for preventing common vulnerabilities
  */
@@ -20,19 +21,4 @@ export declare function validatePath(userPath: string, basePath: string): string
  * @throws Error if any path attempts directory traversal
  */
 export declare function validatePaths(paths: string[], basePath: string): string[];
-/**
- * Sanitizes token/secret values from error messages and logs
- * Replaces common secret patterns with [REDACTED]
- *
- * @param message - Error message or log string
- * @returns Sanitized message with secrets redacted
- */
-export declare function sanitizeSecrets(message: string): string;
-/**
- * Checks if a string contains potential security-sensitive information
- *
- * @param value - String to check
- * @returns True if string might contain secrets
- */
-export declare function containsSecrets(value: string): boolean;
 //# sourceMappingURL=security.d.ts.map

package/dist/handlers/security.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"security.d.ts","sourceRoot":"","sources":["../../src/handlers/security.ts"],"names":[],"mappings":"AAEA;;GAEG;AAEH;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAevE;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAEzE;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAcvD;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAatD"}
+{"version":3,"file":"security.d.ts","sourceRoot":"","sources":["../../src/handlers/security.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAEjF;;GAEG;AAEH;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAevE;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAEzE"}

package/dist/handlers/security.js

@@ -1,4 +1,7 @@
 import { resolve, relative } from 'path';
+// Re-export secrets utilities from SDK for backward compatibility
+// All secret sanitization logic now lives in @fractary/core/common/secrets
+export { sanitizeSecrets, containsSecrets } from '@fractary/core/common/secrets';
 /**
  * Security helper functions for preventing common vulnerabilities
  */
@@ -33,47 +36,6 @@ export function validatePath(userPath, basePath) {
  * @throws Error if any path attempts directory traversal
  */
 export function validatePaths(paths, basePath) {
-    return paths.map(path => validatePath(path, basePath));
-}
-/**
- * Sanitizes token/secret values from error messages and logs
- * Replaces common secret patterns with [REDACTED]
- *
- * @param message - Error message or log string
- * @returns Sanitized message with secrets redacted
- */
-export function sanitizeSecrets(message) {
-    return message
-        // Redact tokens in key-value patterns (JSON, env vars, config)
-        .replace(/(token|key|password|secret|api[_-]?key|access[_-]?token|auth[_-]?token|bearer)["']?\s*[=:]\s*["']?[^\s"',}]+/gi, '$1: [REDACTED]')
-        // Redact bearer tokens
-        .replace(/Bearer\s+[A-Za-z0-9\-._~+/]+=*/gi, 'Bearer [REDACTED]')
-        // Redact Basic auth
-        .replace(/Basic\s+[A-Za-z0-9+/=]+/gi, 'Basic [REDACTED]')
-        // Redact GitHub tokens (ghp_, gho_, ghs_, ghu_)
-        .replace(/gh[pousr]_[A-Za-z0-9]{36,}/gi, '[REDACTED_GITHUB_TOKEN]')
-        // Redact GitLab tokens
-        .replace(/glpat-[A-Za-z0-9_\-]{20,}/gi, '[REDACTED_GITLAB_TOKEN]')
-        // Redact generic API keys (long alphanumeric strings after common keywords)
-        .replace(/(api[_-]?key|apikey|access[_-]?key)\s*[=:]\s*["']?[A-Za-z0-9\-._~+/]{20,}["']?/gi, '$1: [REDACTED]');
-}
-/**
- * Checks if a string contains potential security-sensitive information
- *
- * @param value - String to check
- * @returns True if string might contain secrets
- */
-export function containsSecrets(value) {
-    const secretPatterns = [
-        /token/i,
-        /password/i,
-        /secret/i,
-        /api[_-]?key/i,
-        /bearer/i,
-        /authorization/i,
-        /gh[pousr]_/,
-        /glpat-/,
-    ];
-    return secretPatterns.some(pattern => pattern.test(value));
+    return paths.map((path) => validatePath(path, basePath));
 }
 //# sourceMappingURL=security.js.map

package/dist/handlers/security.js.map

@@ -1 +1 @@
-{"version":3,"file":"security.js","sourceRoot":"","sources":["../../src/handlers/security.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,MAAM,CAAC;AAEzC;;GAEG;AAEH;;;;;;;;GAQG;AACH,MAAM,UAAU,YAAY,CAAC,QAAgB,EAAE,QAAgB;IAC7D,oDAAoD;IACpD,MAAM,cAAc,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IACzC,MAAM,cAAc,GAAG,OAAO,CAAC,cAAc,EAAE,QAAQ,CAAC,CAAC;IAEzD,0DAA0D;IAC1D,MAAM,YAAY,GAAG,QAAQ,CAAC,cAAc,EAAE,cAAc,CAAC,CAAC;IAE9D,yEAAyE;IACzE,IAAI,YAAY,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,OAAO,CAAC,YAAY,CAAC,KAAK,YAAY,EAAE,CAAC;QAC5E,MAAM,IAAI,KAAK,CAAC,4BAA4B,QAAQ,oCAAoC,CAAC,CAAC;IAC5F,CAAC;IAED,oDAAoD;IACpD,OAAO,YAAY,CAAC;AACtB,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,aAAa,CAAC,KAAe,EAAE,QAAgB;IAC7D,OAAO,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,YAAY,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC;AACzD,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,eAAe,CAAC,OAAe;IAC7C,OAAO,OAAO;QACZ,+DAA+D;SAC9D,OAAO,CAAC,gHAAgH,EAAE,gBAAgB,CAAC;QAC5I,uBAAuB;SACtB,OAAO,CAAC,kCAAkC,EAAE,mBAAmB,CAAC;QACjE,oBAAoB;SACnB,OAAO,CAAC,2BAA2B,EAAE,kBAAkB,CAAC;QACzD,gDAAgD;SAC/C,OAAO,CAAC,8BAA8B,EAAE,yBAAyB,CAAC;QACnE,uBAAuB;SACtB,OAAO,CAAC,6BAA6B,EAAE,yBAAyB,CAAC;QAClE,4EAA4E;SAC3E,OAAO,CAAC,kFAAkF,EAAE,gBAAgB,CAAC,CAAC;AACnH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,KAAa;IAC3C,MAAM,cAAc,GAAG;QACrB,QAAQ;QACR,WAAW;QACX,SAAS;QACT,cAAc;QACd,SAAS;QACT,gBAAgB;QAChB,YAAY;QACZ,QAAQ;KACT,CAAC;IAEF,OAAO,cAAc,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;AAC7D,CAAC"}
+{"version":3,"file":"security.js","sourceRoot":"","sources":["../../src/handlers/security.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,MAAM,CAAC;AAEzC,kEAAkE;AAClE,2EAA2E;AAC3E,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAEjF;;GAEG;AAEH;;;;;;;;GAQG;AACH,MAAM,UAAU,YAAY,CAAC,QAAgB,EAAE,QAAgB;IAC7D,oDAAoD;IACpD,MAAM,cAAc,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IACzC,MAAM,cAAc,GAAG,OAAO,CAAC,cAAc,EAAE,QAAQ,CAAC,CAAC;IAEzD,0DAA0D;IAC1D,MAAM,YAAY,GAAG,QAAQ,CAAC,cAAc,EAAE,cAAc,CAAC,CAAC;IAE9D,yEAAyE;IACzE,IAAI,YAAY,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,OAAO,CAAC,YAAY,CAAC,KAAK,YAAY,EAAE,CAAC;QAC5E,MAAM,IAAI,KAAK,CAAC,4BAA4B,QAAQ,oCAAoC,CAAC,CAAC;IAC5F,CAAC;IAED,oDAAoD;IACpD,OAAO,YAAY,CAAC;AACtB,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,aAAa,CAAC,KAAe,EAAE,QAAgB;IAC7D,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,YAAY,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC;AAC3D,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fractary/core-mcp",
-  "version": "0.2.2",
+  "version": "0.3.0",
   "description": "MCP server for Fractary Core SDK - universal tool access for work, repo, spec, logs, file, docs",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -48,7 +48,7 @@
   },
   "homepage": "https://github.com/fractary/core/tree/main/mcp/server#readme",
   "dependencies": {
-    "@fractary/core": "^0.3.2",
+    "@fractary/core": "^0.5.0",
     "@modelcontextprotocol/sdk": "^1.0.0",
     "js-yaml": "^4.1.1",
     "minimatch": "^10.1.1"
@@ -56,7 +56,6 @@
   "devDependencies": {
     "@types/jest": "^29.5.11",
     "@types/js-yaml": "^4.0.9",
-    "@types/minimatch": "^5.1.2",
     "@types/node": "^20.10.6",
     "@typescript-eslint/eslint-plugin": "^6.17.0",
     "@typescript-eslint/parser": "^6.17.0",