matimo 0.1.0-alpha.1 → 0.1.0-alpha.11

package/package.json

@@ -1,15 +1,16 @@
 {
   "name": "matimo",
-  "version": "0.1.0-alpha.1",
-  "description": "Framework-agnostic YAML-driven tool ecosystem for AI agents. Define tools once in YAML, use them everywhere: SDK, MCP, CLI, REST API.",
-  "main": "dist/index.js",
-  "types": "dist/index.d.ts",
+  "version": "0.1.0-alpha.11",
+  "description": "Universal tool provider SDK: Framework-agnostic YAML-driven tool ecosystem for AI agents. Execute a library of pre-built tools (Slack, Gmail, GitHub, AWS, etc.) or define your own in YAML.",
+  "main": "packages/core/dist/index.js",
+  "types": "packages/core/dist/index.d.ts",
   "type": "module",
   "packageManager": "pnpm@8.15.0",
+  "private": false,
   "exports": {
     ".": {
-      "types": "./dist/index.d.ts",
-      "default": "./dist/index.js"
+      "types": "./packages/core/dist/index.d.ts",
+      "default": "./packages/core/dist/index.js"
     }
   },
   "engines": {
@@ -44,25 +45,23 @@
     "url": "https://github.com/tallclub/matimo/issues"
   },
   "files": [
-    "dist",
+    "packages/core/dist",
+    "packages/cli/dist",
+    "packages/cli/bin",
     "README.md",
-    "LICENSE",
-    "docs"
+    "LICENSE"
   ],
   "publishConfig": {
     "access": "public"
   },
   "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.25.3",
-    "axios": "^1.13.4",
-    "dotenv": "^17.2.3",
-    "js-yaml": "^4.1.1",
-    "yaml": "^2.8.2",
-    "zod": "^4.3.6"
+    "@matimo/cli": "0.1.0-alpha.11",
+    "@matimo/core": "0.1.0-alpha.11"
   },
   "devDependencies": {
     "@commitlint/cli": "^20.3.1",
     "@commitlint/config-conventional": "^20.3.1",
+    "@langchain/core": "^1.1.19",
     "@types/jest": "^30.0.0",
     "@types/js-yaml": "^4.0.9",
     "@types/node": "^25.1.0",
@@ -71,6 +70,7 @@
     "eslint": "^9.39.2",
     "husky": "^9.1.7",
     "jest": "^30.2.0",
+    "langchain": "^1.2.18",
     "prettier": "^3.8.1",
     "ts-jest": "^29.4.6",
     "ts-node": "^10.9.2",
@@ -78,19 +78,19 @@
     "typescript": "^5.9.3"
   },
   "scripts": {
-    "build": "tsc",
-    "watch": "tsc --watch",
+    "build": "pnpm --filter='./packages/**' build",
+    "watch": "pnpm --filter='./packages/**' watch",
     "test": "jest",
     "test:watch": "jest --watch",
     "test:coverage": "jest --coverage",
-    "lint": "eslint src test --ext .ts",
-    "lint:fix": "eslint src test --ext .ts --fix",
-    "format": "prettier --write \"src/**/*.ts\" \"test/**/*.ts\" \"*.json\" \"*.md\"",
-    "format:check": "prettier --check \"src/**/*.ts\" \"test/**/*.ts\"",
+    "lint": "eslint packages --ext .ts",
+    "lint:fix": "eslint packages --ext .ts --fix",
+    "format": "prettier --write \"packages/*/src/**/*.ts\" \"packages/*/test/**/*.ts\" \"examples/**/*.ts\" \"*.json\" \"*.md\"",
+    "format:check": "prettier --check \"packages/*/src/**/*.ts\" \"packages/*/test/**/*.ts\" \"examples/**/*.ts\"",
     "commitlint": "commitlint --from HEAD~1 --to HEAD",
     "validate-tools": "tsx scripts/validate-tool.ts",
-    "test-tools": "jest test/fixtures/tools",
-    "dev": "tsx src/index.ts",
-    "clean": "rm -rf dist coverage"
+    "test-tools": "jest packages/core/test/fixtures/tools",
+    "dev": "tsx packages/core/src/index.ts",
+    "clean": "rm -rf dist coverage && find packages -type f \\( -name '*.js' -o -name '*.d.ts' -o -name '*.js.map' -o -name '*.d.ts.map' \\) -not -path '*/dist/*' -not -path '*/node_modules/*' -delete"
   }
 }

package/packages/cli/bin/matimo.cjs

@@ -0,0 +1,26 @@
+#!/usr/bin/env node
+
+// Simple CommonJS entry point - avoids ESM/test issues
+const path = require('path');
+
+// Check for version flag
+const versionFlags = ['-v', '-V', '--version'];
+if (versionFlags.includes(process.argv[process.argv.length - 1])) {
+  try {
+    const pkg = require(path.join(__dirname, '../package.json'));
+    console.log(`matimo-cli v${pkg.version}`);
+    process.exit(0);
+  } catch {
+    console.log('matimo-cli v unknown');
+    process.exit(0);
+  }
+}
+
+// Import and run the ESM main function
+(async () => {
+  const { main } = await import(path.join(__dirname, '../dist/cli.js'));
+  await main();
+})().catch((error) => {
+  console.error('❌ Fatal error:', error);
+  process.exit(1);
+});

package/packages/cli/dist/cli.d.ts

@@ -0,0 +1,6 @@
+export declare function showHelp(): void;
+/**
+ * Main CLI handler - parses commands and routes to appropriate handlers
+ */
+export declare function main(cliArgs?: string[]): Promise<void>;
+//# sourceMappingURL=cli.d.ts.map

package/packages/cli/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAgBA,wBAAgB,QAAQ,IAAI,IAAI,CAmC/B;AAED;;GAEG;AACH,wBAAsB,IAAI,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAwC5D"}

package/packages/cli/dist/cli.js

@@ -0,0 +1,95 @@
+import { readFileSync } from 'fs';
+import { join } from 'path';
+import { installCommand } from './commands/install.js';
+import { listCommand } from './commands/list.js';
+import { searchCommand } from './commands/search.js';
+function getPackageVersion() {
+    try {
+        const pkgPath = join(process.cwd(), 'package.json');
+        const pkg = JSON.parse(readFileSync(pkgPath, 'utf8'));
+        return pkg.version;
+    }
+    catch {
+        return 'unknown';
+    }
+}
+export function showHelp() {
+    console.info(`
+🔨 Matimo CLI - Tool Package Manager
+
+Usage: matimo [command] [options]
+
+Commands:
+  install <tools...>    Install tool packages
+                       Example: matimo install slack gmail
+  
+  list                  List installed Matimo tools
+                       Example: matimo list
+  
+  search <query>        Search for available tools
+                       Example: matimo search slack
+  
+  help                  Show this help message
+  
+  version               Show version information
+
+Examples:
+  # Install new tools
+  $ matimo install slack
+  $ matimo install gmail stripe
+  
+  # List all installed tools
+  $ matimo list
+  
+  # Search for tools
+  $ matimo search email
+  $ matimo search database
+
+Documentation: https://github.com/tallclub/matimo#readme
+Issues: https://github.com/tallclub/matimo/issues
+`);
+}
+/**
+ * Main CLI handler - parses commands and routes to appropriate handlers
+ */
+export async function main(cliArgs) {
+    const args = cliArgs || process.argv.slice(2);
+    const command = args[0];
+    const params = args.slice(1);
+    if (!command) {
+        showHelp();
+        process.exit(0);
+    }
+    try {
+        switch (command.toLowerCase()) {
+            case 'install':
+                await installCommand(params);
+                break;
+            case 'list':
+                await listCommand();
+                break;
+            case 'search':
+                await searchCommand(params[0] || '');
+                break;
+            case 'help':
+            case '-h':
+            case '--help':
+                showHelp();
+                break;
+            case 'version':
+            case '-v':
+            case '--version':
+                console.info(`matimo-cli v${getPackageVersion()}`);
+                break;
+            default:
+                console.error(`❌ Unknown command: ${command}`);
+                console.info('\nRun "matimo help" for available commands');
+                process.exit(1);
+        }
+    }
+    catch (error) {
+        console.error('❌ Error:', error instanceof Error ? error.message : String(error));
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=cli.js.map

package/packages/cli/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAErD,SAAS,iBAAiB;IACxB,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,cAAc,CAAC,CAAC;QACpD,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC;QACtD,OAAO,GAAG,CAAC,OAAO,CAAC;IACrB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,QAAQ;IACtB,OAAO,CAAC,IAAI,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiCd,CAAC,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,IAAI,CAAC,OAAkB;IAC3C,MAAM,IAAI,GAAG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAC9C,MAAM,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IACxB,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAE7B,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,QAAQ,EAAE,CAAC;QACX,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,IAAI,CAAC;QACH,QAAQ,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC;YAC9B,KAAK,SAAS;gBACZ,MAAM,cAAc,CAAC,MAAM,CAAC,CAAC;gBAC7B,MAAM;YACR,KAAK,MAAM;gBACT,MAAM,WAAW,EAAE,CAAC;gBACpB,MAAM;YACR,KAAK,QAAQ;gBACX,MAAM,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;gBACrC,MAAM;YACR,KAAK,MAAM,CAAC;YACZ,KAAK,IAAI,CAAC;YACV,KAAK,QAAQ;gBACX,QAAQ,EAAE,CAAC;gBACX,MAAM;YACR,KAAK,SAAS,CAAC;YACf,KAAK,IAAI,CAAC;YACV,KAAK,WAAW;gBACd,OAAO,CAAC,IAAI,CAAC,eAAe,iBAAiB,EAAE,EAAE,CAAC,CAAC;gBACnD,MAAM;YACR;gBACE,OAAO,CAAC,KAAK,CAAC,sBAAsB,OAAO,EAAE,CAAC,CAAC;gBAC/C,OAAO,CAAC,IAAI,CAAC,4CAA4C,CAAC,CAAC;gBAC3D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACpB,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,UAAU,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QAClF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC"}

package/packages/cli/dist/commands/install.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Install command - Install a specific tool package
+ * matimo install slack gmail stripe
+ */
+export declare function installCommand(toolNames: string[]): Promise<void>;
+//# sourceMappingURL=install.d.ts.map

package/packages/cli/dist/commands/install.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../src/commands/install.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,wBAAsB,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CA+CvE"}

package/packages/cli/dist/commands/install.js

@@ -0,0 +1,48 @@
+import { execFileSync } from 'child_process';
+/**
+ * Install command - Install a specific tool package
+ * matimo install slack gmail stripe
+ */
+export async function installCommand(toolNames) {
+    if (!toolNames || toolNames.length === 0) {
+        console.error('❌ Error: Please specify at least one tool to install');
+        console.info('\nUsage: matimo install [tool1] [tool2] [tool3]...');
+        console.info('Example: matimo install slack gmail stripe');
+        process.exit(1);
+    }
+    const packages = toolNames.map((name) => `@matimo/${name}`);
+    try {
+        console.info(`📦 Installing ${packages.join(', ')}...`);
+        // Run npm install for the packages without invoking a shell
+        execFileSync('npm', ['install', ...packages], { stdio: 'inherit' });
+        console.info('\n✅ Installation complete!');
+        console.info('\nNext steps:');
+        console.info('1. Import and initialize Matimo with auto-discovery (Recommended):');
+        console.info('   const matimo = await MatimoInstance.init({ autoDiscover: true });');
+        console.info('\n2. Or explicitly load the tools (ESM):');
+        console.info(`   import { createRequire } from 'module';
+   const require = createRequire(import.meta.url);
+   const matimo = await MatimoInstance.init({
+     toolPaths: [
+       require.resolve('@matimo/slack/tools'),
+       require.resolve('@matimo/gmail/tools'),
+     ]
+   });`);
+        console.info('\n3. Or use file URLs (Alternative ESM approach):');
+        console.info(`   import { fileURLToPath } from 'url';
+   import path from 'path';
+   const __dirname = path.dirname(fileURLToPath(import.meta.url));
+   const matimo = await MatimoInstance.init({
+     toolPaths: [
+       path.join(__dirname, 'node_modules/@matimo/slack/tools'),
+       path.join(__dirname, 'node_modules/@matimo/gmail/tools'),
+     ]
+   });`);
+        console.info('\n📖 For more info: https://github.com/tallclub/matimo#readme');
+    }
+    catch (error) {
+        console.error('❌ Installation failed:', error instanceof Error ? error.message : String(error));
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=install.js.map

package/packages/cli/dist/commands/install.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.js","sourceRoot":"","sources":["../../src/commands/install.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE7C;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,SAAmB;IACtD,IAAI,CAAC,SAAS,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzC,OAAO,CAAC,KAAK,CAAC,sDAAsD,CAAC,CAAC;QACtE,OAAO,CAAC,IAAI,CAAC,oDAAoD,CAAC,CAAC;QACnE,OAAO,CAAC,IAAI,CAAC,4CAA4C,CAAC,CAAC;QAC3D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,QAAQ,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC;IAE5D,IAAI,CAAC;QACH,OAAO,CAAC,IAAI,CAAC,iBAAiB,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAExD,4DAA4D;QAC5D,YAAY,CAAC,KAAK,EAAE,CAAC,SAAS,EAAE,GAAG,QAAQ,CAAC,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;QAEpE,OAAO,CAAC,IAAI,CAAC,4BAA4B,CAAC,CAAC;QAC3C,OAAO,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QAC9B,OAAO,CAAC,IAAI,CAAC,oEAAoE,CAAC,CAAC;QACnF,OAAO,CAAC,IAAI,CAAC,sEAAsE,CAAC,CAAC;QACrF,OAAO,CAAC,IAAI,CAAC,0CAA0C,CAAC,CAAC;QACzD,OAAO,CAAC,IAAI,CAAC;;;;;;;OAOV,CAAC,CAAC;QACL,OAAO,CAAC,IAAI,CAAC,mDAAmD,CAAC,CAAC;QAClE,OAAO,CAAC,IAAI,CAAC;;;;;;;;OAQV,CAAC,CAAC;QACL,OAAO,CAAC,IAAI,CAAC,+DAA+D,CAAC,CAAC;IAChF,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CACX,wBAAwB,EACxB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CACvD,CAAC;QACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC"}

package/packages/cli/dist/commands/list.d.ts

@@ -0,0 +1,9 @@
+/**
+ * List command - List all installed Matimo tools
+ * matimo list
+ */
+export declare function listCommand(): Promise<void>;
+declare function getNodeModulesPath(): string | null;
+export declare const getNodeModulesPathForTesting: typeof getNodeModulesPath;
+export {};
+//# sourceMappingURL=list.d.ts.map

package/packages/cli/dist/commands/list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../src/commands/list.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,wBAAsB,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CAuDjD;AAED,iBAAS,kBAAkB,IAAI,MAAM,GAAG,IAAI,CAqB3C;AAGD,eAAO,MAAM,4BAA4B,2BAAqB,CAAC"}

package/packages/cli/dist/commands/list.js

@@ -0,0 +1,70 @@
+import * as fs from 'fs';
+import * as path from 'path';
+/**
+ * List command - List all installed Matimo tools
+ * matimo list
+ */
+export async function listCommand() {
+    try {
+        const nodeModulesPath = getNodeModulesPath();
+        if (!nodeModulesPath) {
+            console.info('❌ Error: node_modules not found');
+            process.exit(1);
+        }
+        const matimoScope = path.join(nodeModulesPath, '@matimo');
+        if (!fs.existsSync(matimoScope)) {
+            console.info('⚠️  No Matimo tools installed yet');
+            console.info('\nInstall some tools:');
+            console.info('  matimo install slack gmail stripe');
+            return;
+        }
+        const packages = fs.readdirSync(matimoScope).filter((dir) => !dir.startsWith('.'));
+        if (packages.length === 0) {
+            console.info('⚠️  No Matimo tools installed yet');
+            return;
+        }
+        console.info('📦 Installed Matimo Packages:\n');
+        for (const pkg of packages) {
+            const pkgJsonPath = path.join(matimoScope, pkg, 'package.json');
+            if (fs.existsSync(pkgJsonPath)) {
+                const pkgJson = JSON.parse(fs.readFileSync(pkgJsonPath, 'utf-8'));
+                const matimo = pkgJson.matimo || {};
+                console.info(`  📍 @matimo/${pkg}`);
+                if (pkgJson.description) {
+                    console.info(`     ${pkgJson.description}`);
+                }
+                if (matimo.tools && Array.isArray(matimo.tools)) {
+                    console.info(`     Tools: ${matimo.tools.slice(0, 3).join(', ')}${matimo.tools.length > 3 ? ', ...' : ''}`);
+                }
+                console.info('');
+            }
+        }
+        console.info(`Total: ${packages.length} package${packages.length > 1 ? 's' : ''} installed`);
+    }
+    catch (error) {
+        console.error('❌ Error listing tools:', error instanceof Error ? error.message : String(error));
+        process.exit(1);
+    }
+}
+function getNodeModulesPath() {
+    // Walk up from current working directory to find node_modules
+    // This is the appropriate approach for a CLI tool
+    let currentPath = process.cwd();
+    const maxLevels = 20; // Prevent infinite loops
+    for (let i = 0; i < maxLevels; i++) {
+        const nodeModules = path.join(currentPath, 'node_modules');
+        if (fs.existsSync(nodeModules) && fs.statSync(nodeModules).isDirectory()) {
+            return nodeModules;
+        }
+        const parent = path.dirname(currentPath);
+        if (parent === currentPath) {
+            // Reached filesystem root
+            break;
+        }
+        currentPath = parent;
+    }
+    return null;
+}
+// Export for testing
+export const getNodeModulesPathForTesting = getNodeModulesPath;
+//# sourceMappingURL=list.js.map

package/packages/cli/dist/commands/list.js.map

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

package/packages/cli/dist/commands/search.d.ts

@@ -0,0 +1,2 @@
+export declare function searchCommand(query: string): Promise<void>;
+//# sourceMappingURL=search.d.ts.map

package/packages/cli/dist/commands/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../src/commands/search.ts"],"names":[],"mappings":"AAQA,wBAAsB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAmJhE"}

package/packages/cli/dist/commands/search.js

@@ -0,0 +1,148 @@
+/**
+ * Search command - Search for available Matimo packages
+ * Works for both end-users (searches installed packages) and contributors (searches repo packages)
+ * matimo search slack
+ */
+import fs from 'fs';
+import path from 'path';
+export async function searchCommand(query) {
+    if (!query) {
+        console.error('❌ Error: Please specify a search query');
+        console.info('\nUsage: matimo search <query>');
+        console.info('Example: matimo search slack');
+        process.exit(1);
+    }
+    const availablePackages = [];
+    // Determine search context: contributor (repo) or end-user (installed)
+    // First, check if node_modules/@matimo exists (user project)
+    const installedPackagesDir = path.resolve(process.cwd(), 'node_modules/@matimo');
+    const hasInstalledPackages = fs.existsSync(installedPackagesDir);
+    // Then check if we're in the Matimo repo by looking for pnpm-workspace.yaml
+    const repoRoot = findRepoRoot(process.cwd());
+    const isInRepo = repoRoot !== null;
+    const repoPackagesDir = isInRepo ? path.resolve(repoRoot, 'packages') : null;
+    let searchDir;
+    let searchContext;
+    let skipDirs = [];
+    // Priority: if in repo, search repo; else if installed packages exist, search those
+    if (isInRepo && repoPackagesDir) {
+        searchDir = repoPackagesDir;
+        searchContext = 'repository';
+        skipDirs = ['core', 'cli'];
+    }
+    else if (hasInstalledPackages) {
+        searchDir = installedPackagesDir;
+        searchContext = 'installed';
+    }
+    else {
+        console.error('❌ Error: No Matimo packages found');
+        console.info('Either run this in the Matimo repository or install packages: npm install @matimo/slack');
+        process.exit(1);
+    }
+    try {
+        const entries = fs.readdirSync(searchDir);
+        for (const entry of entries) {
+            // Skip internal packages in repo context
+            if (skipDirs.includes(entry))
+                continue;
+            const packagePath = path.join(searchDir, entry);
+            const packageJsonPath = path.join(packagePath, 'package.json');
+            if (!fs.existsSync(packageJsonPath))
+                continue;
+            try {
+                const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, 'utf-8'));
+                // Count tools in the tools directory
+                const toolsDir = path.join(packagePath, 'tools');
+                let toolCount = 0;
+                if (fs.existsSync(toolsDir)) {
+                    toolCount = fs.readdirSync(toolsDir).filter((f) => {
+                        const stat = fs.statSync(path.join(toolsDir, f));
+                        return stat.isDirectory();
+                    }).length;
+                }
+                // Extract package name (remove @matimo/ prefix)
+                const pkgName = packageJson.name.replace('@matimo/', '');
+                availablePackages.push({
+                    name: pkgName,
+                    description: packageJson.description || 'No description available',
+                    tools: toolCount,
+                    status: 'available',
+                });
+            }
+            catch {
+                // Skip packages with invalid package.json
+                continue;
+            }
+        }
+    }
+    catch {
+        if (searchContext === 'installed') {
+            console.error('❌ Error: Could not discover installed packages');
+            console.info('Make sure you have installed Matimo packages in node_modules/@matimo/');
+        }
+        else {
+            console.error('❌ Error: Could not discover packages in repository');
+            console.info('Make sure you have provider packages in packages/ directory');
+        }
+        process.exit(1);
+    }
+    // Sort packages by name
+    availablePackages.sort((a, b) => a.name.localeCompare(b.name));
+    if (availablePackages.length === 0) {
+        if (searchContext === 'installed') {
+            console.error('❌ Error: No packages found in node_modules/@matimo/');
+            console.info('Install Matimo packages first: npm install @matimo/slack @matimo/gmail');
+        }
+        else {
+            console.error('❌ Error: No packages found in repository');
+            console.info('Make sure you have provider packages in packages/ directory');
+        }
+        process.exit(1);
+    }
+    const q = query.toLowerCase();
+    const results = availablePackages.filter((pkg) => pkg.name.includes(q) || pkg.description.toLowerCase().includes(q));
+    if (results.length === 0) {
+        console.info(`❌ No packages found matching "${query}"`);
+        console.info(`\n📦 Available Packages (from ${searchContext}):`);
+        availablePackages.forEach((pkg) => {
+            console.info(`  • @matimo/${pkg.name} (${pkg.tools} tools)`);
+        });
+        return;
+    }
+    console.info(`🔍 Search results for "${query}" (${searchContext}):\n`);
+    for (const pkg of results) {
+        const statusEmoji = pkg.status === 'available' ? '✅' : '🔜';
+        const statusText = pkg.status === 'available' ? 'Available' : 'Coming Soon';
+        console.info(`${statusEmoji} @matimo/${pkg.name} (${statusText})`);
+        console.info(`   ${pkg.description}`);
+        console.info(`   Tools: ${pkg.tools}`);
+        if (pkg.status === 'available') {
+            if (searchContext === 'installed') {
+                console.info(`   Already installed in your project`);
+            }
+            else {
+                console.info(`   Install: matimo install ${pkg.name}`);
+            }
+        }
+        else {
+            console.info(`   Install: Not yet available`);
+        }
+        console.info('');
+    }
+    console.info(`Total: ${results.length} package${results.length > 1 ? 's' : ''} found`);
+}
+/**
+ * Find the Matimo repository root by looking for pnpm-workspace.yaml
+ */
+function findRepoRoot(startPath) {
+    let current = startPath;
+    // Safety: don't go above filesystem root
+    while (current !== path.dirname(current)) {
+        if (fs.existsSync(path.join(current, 'pnpm-workspace.yaml'))) {
+            return current;
+        }
+        current = path.dirname(current);
+    }
+    return null;
+}
+//# sourceMappingURL=search.js.map

package/packages/cli/dist/commands/search.js.map

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

package/packages/core/dist/approval/approval-handler.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Approval request for any tool operation
+ */
+export interface ApprovalRequest {
+    toolName: string;
+    description?: string;
+    params: Record<string, unknown>;
+}
+/**
+ * Generic approval callback - simple and scalable
+ * Returns true if approved, false if rejected or user declines
+ */
+export type ApprovalCallback = (request: ApprovalRequest) => Promise<boolean>;
+/**
+ * Generic, simple approval handler for all tools
+ *
+ * Design: Single, scalable approval flow for any number of tools
+ * - Tools declare requires_approval in YAML OR contain destructive keywords
+ * - Check MATIMO_AUTO_APPROVE env var (approve all)
+ * - Check MATIMO_APPROVED_PATTERNS env var (pre-approved patterns)
+ * - If not pre-approved, invoke single generic callback
+ * - No per-provider validators or custom logic needed
+ */
+export declare class ApprovalHandler {
+    private autoApprove;
+    private approvedPatterns;
+    private approvalCallback;
+    private destructiveKeywords;
+    constructor();
+    /**
+     * Load destructive keywords from YAML configuration file
+     * Searches for destructive-keywords.yaml in:
+     * 1. packages/core/ (development/workspace)
+     * 2. node_modules/@matimo/core/ (installed package)
+     * 3. Relative to current working directory
+     */
+    private loadDestructiveKeywords;
+    /**
+     * Set default destructive keywords
+     */
+    private useDefaultKeywords;
+    /**
+     * Set approval callback for interactive/custom approval
+     */
+    setApprovalCallback(callback: ApprovalCallback): void;
+    /**
+     * Check if a tool requires approval based on YAML definition or supplied content.
+     * @param requiresApproval In Yaml - From tool definition `requires_approval` field
+     * @param content - Optional content (SQL, shell command, etc.) to check for destructive keywords
+     *
+     * Notes:
+     * -  We now accept any textual content so keyword detection also applies to command/shell and sql
+     *   based tools (e.g. `params.command`).
+     */
+    requiresApproval(requiresApprovalInYaml: boolean | undefined, content?: string): boolean;
+    /**
+     * Check if operation is pre-approved via env vars
+     */
+    isPreApproved(toolName: string): boolean;
+    /**
+     * Request approval for an operation
+     * Throws if not approved and no callback available
+     */
+    requestApproval(request: ApprovalRequest): Promise<void>;
+    /**
+     * Simple pattern matching (supports wildcards)
+     */
+    private matchesPattern;
+}
+/**
+ * Get or create global approval handler
+ */
+export declare function getGlobalApprovalHandler(): ApprovalHandler;
+//# sourceMappingURL=approval-handler.d.ts.map

package/packages/core/dist/approval/approval-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"approval-handler.d.ts","sourceRoot":"","sources":["../../src/approval/approval-handler.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AAED;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,EAAE,eAAe,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;AAE9E;;;;;;;;;GASG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,WAAW,CAAkB;IACrC,OAAO,CAAC,gBAAgB,CAA0B;IAClD,OAAO,CAAC,gBAAgB,CAAiC;IACzD,OAAO,CAAC,mBAAmB,CAAgB;;IAsB3C;;;;;;OAMG;IACH,OAAO,CAAC,uBAAuB;IAqD/B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAyB1B;;OAEG;IACH,mBAAmB,CAAC,QAAQ,EAAE,gBAAgB,GAAG,IAAI;IAIrD;;;;;;;;OAQG;IACH,gBAAgB,CAAC,sBAAsB,EAAE,OAAO,GAAG,SAAS,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO;IAexF;;OAEG;IACH,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAgBxC;;;OAGG;IACG,eAAe,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IA2B9D;;OAEG;IACH,OAAO,CAAC,cAAc;CAavB;AAKD;;GAEG;AACH,wBAAgB,wBAAwB,IAAI,eAAe,CAK1D"}