@matimo/cli 0.1.0-alpha.9 → 0.1.2

package/dist/bin.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=bin.d.ts.map

package/dist/bin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.d.ts","sourceRoot":"","sources":["../src/bin.ts"],"names":[],"mappings":""}

package/dist/bin.js

@@ -0,0 +1,50 @@
+#!/usr/bin/env node
+/**
+ * Matimo CLI entry point
+ *
+ * This is the npm bin target — compiled to dist/bin.js.
+ * All command routing (install, list, search, mcp, etc.) is handled by cli.ts.
+ *
+ * Uses tsx to register ESM hooks so extensionless imports in @matimo/core work
+ * correctly. This is required because @matimo/core compiles TypeScript with
+ * "moduleResolution": "bundler" which omits .js extensions in the output.
+ *
+ * Tool discovery works automatically via ToolLoader.getNodeModulesPath():
+ *   1. Walks up from process.cwd() to find node_modules/@matimo/*
+ *   2. Falls back to __dirname-based discovery (for Claude Desktop where cwd='/')
+ *
+ * Users run:
+ *   npx matimo mcp                         # stdio mode
+ *   npx matimo mcp --transport http        # http mode
+ *   npx matimo install slack gmail         # install providers
+ *   npx matimo list                        # list installed tools
+ */
+import { spawn } from 'child_process';
+import { dirname, join } from 'path';
+import { fileURLToPath } from 'url';
+import { createRequire } from 'module';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+// Resolve tsx from this package's dependencies
+const require = createRequire(import.meta.url);
+let tsxBin;
+try {
+    const tsxPkgPath = require.resolve('tsx/package.json');
+    tsxBin = join(dirname(tsxPkgPath), 'dist', 'cli.mjs');
+}
+catch {
+    tsxBin = 'tsx';
+}
+const cliScript = join(__dirname, 'cli.js');
+const child = spawn(process.execPath, [tsxBin, cliScript, ...process.argv.slice(2)], {
+    stdio: 'inherit',
+    env: process.env,
+});
+child.on('error', (error) => {
+    console.error('❌ Failed to start Matimo CLI. Make sure tsx is installed.');
+    console.error('   Run: npm install tsx');
+    console.error('   Error:', error.message);
+    process.exit(1);
+});
+child.on('exit', (code) => process.exit(code || 0));
+//# sourceMappingURL=bin.js.map

package/dist/bin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.js","sourceRoot":"","sources":["../src/bin.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AACtC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AACrC,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AACpC,OAAO,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AAEvC,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAClD,MAAM,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;AAEtC,+CAA+C;AAC/C,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC/C,IAAI,MAAc,CAAC;AACnB,IAAI,CAAC;IACH,MAAM,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAC;IACvD,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC;AACxD,CAAC;AAAC,MAAM,CAAC;IACP,MAAM,GAAG,KAAK,CAAC;AACjB,CAAC;AAED,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;AAC5C,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE;IACnF,KAAK,EAAE,SAAS;IAChB,GAAG,EAAE,OAAO,CAAC,GAAG;CACjB,CAAC,CAAC;AAEH,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,KAAY,EAAE,EAAE;IACjC,OAAO,CAAC,KAAK,CAAC,2DAA2D,CAAC,CAAC;IAC3E,OAAO,CAAC,KAAK,CAAC,yBAAyB,CAAC,CAAC;IACzC,OAAO,CAAC,KAAK,CAAC,WAAW,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;IAC1C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC;AAEH,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAmB,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC"}

package/dist/cli.d.ts.map

@@ -1 +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"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAmBA,wBAAgB,QAAQ,IAAI,IAAI,CAmE/B;AAED;;GAEG;AACH,wBAAsB,IAAI,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAiD5D"}

package/dist/cli.js

@@ -1,8 +1,11 @@
 import { readFileSync } from 'fs';
-import { join } from 'path';
+import { join, basename } from 'path';
 import { installCommand } from './commands/install.js';
 import { listCommand } from './commands/list.js';
 import { searchCommand } from './commands/search.js';
+import { mcpCommand } from './commands/mcp.js';
+import { doctorCommand } from './commands/doctor.js';
+import { reviewCommand } from './commands/review.js';
 function getPackageVersion() {
     try {
         const pkgPath = join(process.cwd(), 'package.json');
@@ -29,10 +32,34 @@ Commands:
   search <query>        Search for available tools
                        Example: matimo search slack
   
+  mcp                   Start MCP server (Model Context Protocol)
+                       Example: matimo mcp
+                       Example: matimo mcp --transport http --port 3000
+  
+  mcp setup             Generate config for Claude Desktop / Cursor
+                       Example: matimo mcp setup
+  
+  doctor               Diagnose your Matimo setup (env vars, YAML validity, Node version)
+                       Example: matimo doctor
+  
+  review               Review agent-created tools awaiting human approval
+                       Example: matimo review list
+                       Example: matimo review approve my_tool
+                       Example: matimo review reject my_tool
+  
   help                  Show this help message
   
   version               Show version information
 
+MCP Options:
+  --transport <type>    Transport mode: stdio (default) or http
+  --port <number>       HTTP port (default: 3000)
+  --tools <list>        Comma-separated tool allowlist
+  --exclude <list>      Comma-separated tool denylist
+  --secrets <list>      Secret resolvers: env,dotenv,vault,aws
+  --token <string>      Bearer token for HTTP mode
+  --env-file <path>     Path to .env file
+
 Examples:
   # Install new tools
   $ matimo install slack
@@ -43,7 +70,15 @@ Examples:
   
   # Search for tools
   $ matimo search email
-  $ matimo search database
+  
+  # Start MCP server for Claude Desktop
+  $ matimo mcp
+  
+  # Start MCP HTTP server with auth
+  $ MATIMO_MCP_TOKEN=secret matimo mcp --transport http
+  
+  # Generate Claude Desktop config
+  $ matimo mcp setup
 
 Documentation: https://github.com/tallclub/matimo#readme
 Issues: https://github.com/tallclub/matimo/issues
@@ -71,6 +106,15 @@ export async function main(cliArgs) {
             case 'search':
                 await searchCommand(params[0] || '');
                 break;
+            case 'mcp':
+                await mcpCommand(params);
+                break;
+            case 'doctor':
+                await doctorCommand();
+                break;
+            case 'review':
+                await reviewCommand(params);
+                break;
             case 'help':
             case '-h':
             case '--help':
@@ -92,4 +136,22 @@ export async function main(cliArgs) {
         process.exit(1);
     }
 }
+// Auto-execute when run directly (e.g., via tsx src/cli.ts or through bin.ts).
+// bin.ts spawns: node <tsx-cli.mjs> <cli.js> ...args
+// - When tsx shifts its own entry out of argv: process.argv[1] == cli.js
+// - When tsx does NOT shift argv:              process.argv[2] == cli.js
+// Checking both slots handles either tsx version. When imported as a module
+// (tests, bin.ts import) neither slot contains 'cli.js'.
+// Use basename() to normalise path separators (POSIX / and Windows \).
+/* istanbul ignore next */
+const toCliJs = (s) => basename(s).replace(/\.ts$/, '.js');
+/* istanbul ignore next */
+const isRunDirectly = toCliJs(process.argv[1] ?? '') === 'cli.js' || toCliJs(process.argv[2] ?? '') === 'cli.js';
+/* istanbul ignore next */
+if (isRunDirectly) {
+    main().catch((error) => {
+        console.error('❌ Fatal error:', error);
+        process.exit(1);
+    });
+}
 //# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/commands/doctor.d.ts

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

package/dist/commands/doctor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../src/commands/doctor.ts"],"names":[],"mappings":"AAmDA,wBAAsB,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CA8JnD"}

package/dist/commands/doctor.js

@@ -0,0 +1,174 @@
+import * as fs from 'fs';
+import * as path from 'path';
+const issues = [];
+function check(label, pass, message, severity = 'error') {
+    const icon = pass ? '✅' : severity === 'error' ? '❌' : '⚠️ ';
+    console.info(`  ${icon} ${label}`);
+    if (!pass) {
+        issues.push({ severity, message });
+        console.info(`     ${message}`);
+    }
+}
+function findNodeModules() {
+    let dir = process.cwd();
+    for (let i = 0; i < 10; i++) {
+        const candidate = path.join(dir, 'node_modules');
+        if (fs.existsSync(candidate))
+            return candidate;
+        const parent = path.dirname(dir);
+        if (parent === dir)
+            break;
+        dir = parent;
+    }
+    return null;
+}
+async function loadMatimoCoreExport(exportName) {
+    try {
+        // Dynamic import works in both ESM (built CLI) and CJS (ts-jest test transform)
+        const core = (await import('@matimo/core'));
+        return core[exportName] ?? null;
+    }
+    catch {
+        return null;
+    }
+}
+export async function doctorCommand() {
+    // Ensure issues do not accumulate across multiple invocations
+    issues.length = 0;
+    console.info('\n🩺 Matimo Doctor — Checking your setup...\n');
+    // ─── 1. Node.js version ────────────────────────────────────────────────
+    console.info('Node.js:');
+    const nodeVersion = process.versions.node;
+    const [major] = nodeVersion.split('.').map(Number);
+    check(`Node.js v${nodeVersion}`, major >= 18, `Node.js 18+ required. You are running ${nodeVersion}. Upgrade: https://nodejs.org`);
+    console.info('');
+    // ─── 2. @matimo/* packages ─────────────────────────────────────────────
+    const nodeModulesPath = findNodeModules();
+    console.info('@matimo/* packages:');
+    if (!nodeModulesPath) {
+        check('node_modules', false, 'node_modules not found. Run "pnpm install" or "npm install".');
+        console.info('');
+    }
+    else {
+        const matimoScope = path.join(nodeModulesPath, '@matimo');
+        const hasScope = fs.existsSync(matimoScope);
+        if (!hasScope) {
+            check('@matimo scope', false, 'No @matimo/* packages installed. Run "matimo install slack" to get started.', 'warn');
+        }
+        else {
+            const packages = fs.readdirSync(matimoScope).filter((d) => !d.startsWith('.'));
+            if (packages.length === 0) {
+                check('@matimo scope', false, 'No @matimo/* packages installed. Run "matimo install slack" to get started.', 'warn');
+            }
+            else {
+                for (const pkg of packages) {
+                    const pkgDir = path.join(matimoScope, pkg);
+                    const pkgJsonPath = path.join(pkgDir, 'package.json');
+                    if (!fs.existsSync(pkgJsonPath))
+                        continue;
+                    console.info(`  📦 @matimo/${pkg}`);
+                    // Check env vars for auth placeholders
+                    const toolsDir = path.join(pkgDir, 'tools');
+                    if (fs.existsSync(toolsDir)) {
+                        const toolDirs = fs.readdirSync(toolsDir).filter((d) => {
+                            return fs.existsSync(path.join(toolsDir, d, 'definition.yaml'));
+                        });
+                        const missingEnv = [];
+                        const seenVars = new Set();
+                        for (const toolName of toolDirs) {
+                            const yamlPath = path.join(toolsDir, toolName, 'definition.yaml');
+                            const content = fs.readFileSync(yamlPath, 'utf-8');
+                            // Scan for {ENV_VAR_NAME} placeholders in headers/URLs
+                            const placeholderRegex = /\{(\w+)\}/g;
+                            let match;
+                            while ((match = placeholderRegex.exec(content)) !== null) {
+                                const name = match[1];
+                                if (isAuthVar(name) && !seenVars.has(name)) {
+                                    seenVars.add(name);
+                                    if (!process.env[name]) {
+                                        missingEnv.push(name);
+                                    }
+                                }
+                            }
+                        }
+                        if (missingEnv.length > 0) {
+                            issues.push({
+                                severity: 'error',
+                                message: `@matimo/${pkg}: missing env vars: ${missingEnv.join(', ')}`,
+                            });
+                            for (const v of missingEnv) {
+                                console.info(`     ❌ Missing env var: ${v}`);
+                            }
+                        }
+                        else {
+                            console.info(`     ✅ All required env vars are set`);
+                        }
+                        // Validate YAML schemas
+                        let yamlErrors = 0;
+                        const validateToolDefinition = await loadMatimoCoreExport('validateToolDefinition');
+                        if (validateToolDefinition) {
+                            const yaml = await import('js-yaml');
+                            for (const toolName of toolDirs) {
+                                const yamlPath = path.join(toolsDir, toolName, 'definition.yaml');
+                                try {
+                                    const parsed = yaml.load(fs.readFileSync(yamlPath, 'utf-8'));
+                                    validateToolDefinition(parsed);
+                                }
+                                catch (err) {
+                                    yamlErrors++;
+                                    issues.push({
+                                        severity: 'error',
+                                        message: `@matimo/${pkg}/${toolName}: YAML invalid — ${err.message}`,
+                                    });
+                                    console.info(`     ❌ ${toolName}: invalid YAML`);
+                                    console.info(`        ${err.message.split('\n')[0]}`);
+                                }
+                            }
+                            if (yamlErrors === 0 && toolDirs.length > 0) {
+                                console.info(`     ✅ ${toolDirs.length} tool YAML(s) valid`);
+                            }
+                        }
+                    }
+                    console.info('');
+                }
+            }
+        }
+    }
+    // ─── 3. MATIMO_APPROVAL_SECRET ─────────────────────────────────────────
+    console.info('Policy / Approval:');
+    const hasApprovalSecret = !!process.env.MATIMO_APPROVAL_SECRET;
+    check('MATIMO_APPROVAL_SECRET', hasApprovalSecret, 'MATIMO_APPROVAL_SECRET is not set. Agent-created tool approvals will use a random secret (not persistent across restarts). Set it in your .env file.', 'warn');
+    console.info('');
+    // ─── 4. Summary ────────────────────────────────────────────────────────
+    const errors = issues.filter((i) => i.severity === 'error');
+    const warnings = issues.filter((i) => i.severity === 'warn');
+    console.info('─'.repeat(60));
+    if (errors.length === 0 && warnings.length === 0) {
+        console.info('\n✅ Matimo is ready! No issues found.\n');
+    }
+    else {
+        if (errors.length > 0) {
+            console.info(`\n❌ ${errors.length} error(s) found — fix before using Matimo:\n`);
+            errors.forEach((e, i) => console.info(`  ${i + 1}. ${e.message}`));
+            console.info('');
+        }
+        if (warnings.length > 0) {
+            console.info(`⚠️  ${warnings.length} warning(s):\n`);
+            warnings.forEach((w, i) => console.info(`  ${i + 1}. ${w.message}`));
+            console.info('');
+        }
+    }
+    if (errors.length > 0)
+        process.exit(1);
+}
+/** Heuristic: is this placeholder likely an auth/secret env var? */
+function isAuthVar(name) {
+    const upper = name.toUpperCase();
+    return (upper.includes('TOKEN') ||
+        upper.includes('SECRET') ||
+        upper.includes('KEY') ||
+        upper.includes('PASSWORD') ||
+        upper.includes('CREDENTIAL') ||
+        upper.includes('AUTH'));
+}
+//# sourceMappingURL=doctor.js.map

package/dist/commands/doctor.js.map

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

package/dist/commands/mcp-setup.d.ts

@@ -0,0 +1,9 @@
+/**
+ * CLI command: matimo mcp setup
+ *
+ * Interactive config generator for MCP server.
+ * Detects installed tools, scans for required auth env vars,
+ * and outputs a ready-to-paste Claude Desktop / Cursor config.
+ */
+export declare function mcpSetupCommand(): Promise<void>;
+//# sourceMappingURL=mcp-setup.d.ts.map

package/dist/commands/mcp-setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-setup.d.ts","sourceRoot":"","sources":["../../src/commands/mcp-setup.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,wBAAsB,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC,CAiHrD"}

package/dist/commands/mcp-setup.js

@@ -0,0 +1,106 @@
+/**
+ * CLI command: matimo mcp setup
+ *
+ * Interactive config generator for MCP server.
+ * Detects installed tools, scans for required auth env vars,
+ * and outputs a ready-to-paste Claude Desktop / Cursor config.
+ */
+export async function mcpSetupCommand() {
+    console.info('\n🔨 Matimo MCP Setup\n');
+    console.info('Scanning for installed tool packages...\n');
+    try {
+        // @ts-ignore - dynamic import of package resolved at runtime
+        const { ToolLoader, extractAuthPlaceholders } = await import('@matimo/core');
+        const loader = new ToolLoader();
+        // Auto-discover installed packages
+        const toolPaths = loader.autoDiscoverPackages();
+        if (toolPaths.length === 0) {
+            console.info('No @matimo/* tool packages found.');
+            console.info('Install tools first: matimo install slack github\n');
+            return;
+        }
+        // Load all tools
+        const tools = loader.loadToolsFromMultiplePaths(toolPaths);
+        console.info(`Found ${tools.size} tools across ${toolPaths.length} package(s):\n`);
+        // Group tools by provider (extract from tool name prefix)
+        const providers = new Map();
+        const authVars = new Set();
+        for (const [name, tool] of tools) {
+            // Extract provider from tool name (e.g., "slack_send" → "slack")
+            const provider = name.includes('_')
+                ? name.split('_')[0]
+                : name.includes('-')
+                    ? name.split('-')[0]
+                    : 'core';
+            if (!providers.has(provider)) {
+                providers.set(provider, []);
+            }
+            providers.get(provider).push(name);
+            // Extract auth placeholders
+            const placeholders = extractAuthPlaceholders(tool);
+            for (const p of placeholders) {
+                authVars.add(p);
+            }
+        }
+        // Display providers and tools
+        for (const [provider, toolNames] of providers) {
+            console.info(`  📦 ${provider} (${toolNames.length} tools)`);
+            for (const name of toolNames.slice(0, 5)) {
+                console.info(`     • ${name}`);
+            }
+            if (toolNames.length > 5) {
+                console.info(`     ... and ${toolNames.length - 5} more`);
+            }
+        }
+        console.info('');
+        // Display required env vars
+        if (authVars.size > 0) {
+            console.info('🔐 Required environment variables:\n');
+            for (const v of authVars) {
+                const value = process.env[v] || process.env[`MATIMO_${v}`];
+                const status = value ? '✅' : '❌';
+                console.info(`  ${status} ${v}`);
+            }
+            console.info('');
+        }
+        // Generate Claude Desktop config
+        const envBlock = {};
+        for (const v of authVars) {
+            envBlock[v] = process.env[v] || process.env[`MATIMO_${v}`] || '<your-token>';
+        }
+        const claudeConfig = {
+            mcpServers: {
+                matimo: {
+                    command: 'npx',
+                    args: ['matimo', 'mcp'],
+                    env: envBlock,
+                },
+            },
+        };
+        console.info('📋 Claude Desktop config (paste into Settings → Developer → MCP Servers):\n');
+        console.info(JSON.stringify(claudeConfig, null, 2));
+        // Generate Cursor config
+        console.info('\n📋 Cursor config (paste into .cursor/mcp.json):\n');
+        const cursorConfig = {
+            mcpServers: {
+                matimo: {
+                    command: 'npx',
+                    args: ['matimo', 'mcp'],
+                    env: envBlock,
+                },
+            },
+        };
+        console.info(JSON.stringify(cursorConfig, null, 2));
+        // HTTP mode example
+        console.info('\n📋 HTTP mode (for remote hosting / Docker):\n');
+        const envExport = [...authVars].map((v) => `  ${v}=<your-token>`).join(' \\\n');
+        console.info(`  ${envExport} \\`);
+        console.info(`  MATIMO_MCP_TOKEN=<your-server-secret> \\`);
+        console.info(`  npx matimo mcp --transport http --port 3000\n`);
+    }
+    catch (error) {
+        console.error('❌ Setup failed:', error instanceof Error ? error.message : String(error));
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=mcp-setup.js.map

package/dist/commands/mcp-setup.js.map

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

package/dist/commands/mcp.d.ts

@@ -0,0 +1,17 @@
+/**
+ * CLI command: matimo mcp
+ *
+ * Starts the Matimo MCP server with configurable transport and options.
+ *
+ * Usage:
+ *   matimo mcp                                    # stdio mode (default)
+ *   matimo mcp --transport http --port 3000       # HTTP mode
+ *   matimo mcp --tools slack,github               # only these tools
+ *   matimo mcp --exclude postgres                 # exclude these tools
+ *   matimo mcp --secrets env,vault                # secret resolver chain
+ *   matimo mcp --token my-secret                  # HTTP bearer token
+ *   matimo mcp --tool-paths /path/to/tools         # custom tool paths
+ *   matimo mcp --skill-paths /path/to/skills       # custom skill paths
+ */
+export declare function mcpCommand(params: string[]): Promise<void>;
+//# sourceMappingURL=mcp.d.ts.map

package/dist/commands/mcp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../../src/commands/mcp.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AA8KH,wBAAsB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CA8FhE"}

package/dist/commands/mcp.js

@@ -0,0 +1,228 @@
+/**
+ * CLI command: matimo mcp
+ *
+ * Starts the Matimo MCP server with configurable transport and options.
+ *
+ * Usage:
+ *   matimo mcp                                    # stdio mode (default)
+ *   matimo mcp --transport http --port 3000       # HTTP mode
+ *   matimo mcp --tools slack,github               # only these tools
+ *   matimo mcp --exclude postgres                 # exclude these tools
+ *   matimo mcp --secrets env,vault                # secret resolver chain
+ *   matimo mcp --token my-secret                  # HTTP bearer token
+ *   matimo mcp --tool-paths /path/to/tools         # custom tool paths
+ *   matimo mcp --skill-paths /path/to/skills       # custom skill paths
+ */
+function parseArgs(params) {
+    const args = {
+        transport: 'stdio',
+        port: 3000,
+    };
+    /** Assert that a value-consuming flag was given an argument, not another flag or end-of-input. */
+    const requireValue = (flag, value) => {
+        if (!value || value.startsWith('-')) {
+            console.error(`❌ ${flag} requires a value`);
+            process.exit(1);
+        }
+        return value;
+    };
+    for (let i = 0; i < params.length; i++) {
+        const flag = params[i];
+        const next = params[i + 1];
+        switch (flag) {
+            case '--transport':
+            case '-t':
+                if (next === 'stdio' || next === 'http') {
+                    args.transport = next;
+                    i++;
+                }
+                else {
+                    console.error('❌ --transport must be "stdio" or "http"');
+                    process.exit(1);
+                }
+                break;
+            case '--port':
+            case '-p':
+                args.port = parseInt(next, 10);
+                if (isNaN(args.port)) {
+                    console.error('❌ --port must be a number');
+                    process.exit(1);
+                }
+                i++;
+                break;
+            case '--tools':
+                args.tools = requireValue('--tools', next)
+                    .split(',')
+                    .map((s) => s.trim());
+                i++;
+                break;
+            case '--exclude':
+                args.excludeTools = requireValue('--exclude', next)
+                    .split(',')
+                    .map((s) => s.trim());
+                i++;
+                break;
+            case '--secrets':
+                args.secrets = requireValue('--secrets', next)
+                    .split(',')
+                    .map((s) => s.trim());
+                i++;
+                break;
+            case '--env-file':
+                args.envFile = requireValue('--env-file', next);
+                i++;
+                break;
+            case '--vault-path':
+                args.vaultPath = requireValue('--vault-path', next);
+                i++;
+                break;
+            case '--aws-secret-id':
+                args.awsSecretId = requireValue('--aws-secret-id', next);
+                i++;
+                break;
+            case '--token':
+                args.token = requireValue('--token', next);
+                i++;
+                break;
+            case '--tool-paths':
+                args.toolPaths = requireValue('--tool-paths', next)
+                    .split(',')
+                    .map((s) => s.trim());
+                i++;
+                break;
+            case '--skill-paths':
+                args.skillPaths = requireValue('--skill-paths', next)
+                    .split(',')
+                    .map((s) => s.trim());
+                i++;
+                break;
+            case '--https':
+                args.https = true;
+                break;
+            case '--self-signed':
+                args.https = true;
+                args.selfSigned = true;
+                break;
+            case '--cert':
+                args.certPath = requireValue('--cert', next);
+                args.https = true;
+                i++;
+                break;
+            case '--key':
+                args.keyPath = requireValue('--key', next);
+                args.https = true;
+                i++;
+                break;
+            case 'setup':
+                // Handled separately in cli.ts
+                break;
+            default:
+                if (flag.startsWith('-')) {
+                    console.error(`❌ Unknown flag: ${flag}`);
+                    process.exit(1);
+                }
+        }
+    }
+    return args;
+}
+function buildResolverConfig(args) {
+    const secretTypes = args.secrets ?? ['env', 'dotenv'];
+    const resolvers = secretTypes.map((type) => {
+        switch (type) {
+            case 'env':
+                return { type: 'env' };
+            case 'dotenv':
+                return { type: 'dotenv', path: args.envFile };
+            case 'vault':
+                return { type: 'vault', secretPath: args.vaultPath };
+            case 'aws':
+                return { type: 'aws', secretId: args.awsSecretId };
+            default:
+                console.error(`❌ Unknown secret resolver: ${type}. Use: env, dotenv, vault, aws`);
+                process.exit(1);
+        }
+    });
+    return { resolvers };
+}
+export async function mcpCommand(params) {
+    // Check for 'setup' subcommand
+    if (params[0] === 'setup') {
+        const { mcpSetupCommand } = await import('./mcp-setup.js');
+        await mcpSetupCommand();
+        return;
+    }
+    const args = parseArgs(params);
+    // Lazy-import core MCP server
+    // @ts-ignore - dynamic import of package resolved at runtime
+    const { MCPServer } = await import('@matimo/core');
+    const server = new MCPServer({
+        transport: args.transport,
+        port: args.port,
+        tools: args.tools,
+        excludeTools: args.excludeTools,
+        secretResolver: buildResolverConfig(args),
+        mcpToken: args.token,
+        toolPaths: args.toolPaths,
+        skillPaths: args.skillPaths,
+        autoDiscover: true,
+        https: args.https,
+        selfSigned: args.selfSigned,
+        certPath: args.certPath,
+        keyPath: args.keyPath,
+    });
+    // Graceful shutdown
+    const shutdown = async () => {
+        // Only log to stderr in stdio mode (stdout is JSON-RPC)
+        if (args.transport === 'stdio') {
+            process.stderr.write('\nShutting down Matimo MCP server...\n');
+        }
+        else {
+            console.info('\nShutting down Matimo MCP server...');
+        }
+        await server.stop();
+        process.exit(0);
+    };
+    process.on('SIGINT', shutdown);
+    process.on('SIGTERM', shutdown);
+    try {
+        await server.start();
+        if (args.transport === 'http') {
+            const protocol = args.https ? 'https' : 'http';
+            const url = `${protocol}://localhost:${args.port}/mcp`;
+            const token = server.getActiveToken();
+            console.info('');
+            console.info(`🚀 Matimo MCP server running at ${url}`);
+            if (args.https) {
+                if (args.selfSigned || (!args.certPath && !args.keyPath)) {
+                    console.info('🔒 HTTPS enabled (self-signed certificate)');
+                    console.info('   ⚠️  Clients may need to disable cert verification for self-signed certs');
+                }
+                else {
+                    console.info('🔒 HTTPS enabled');
+                }
+            }
+            if (token) {
+                const isAutoGenerated = !args.token && !process.env.MATIMO_MCP_TOKEN;
+                console.info('');
+                console.info(`🔐 Bearer Token${isAutoGenerated ? ' (auto-generated)' : ''}:`);
+                console.info(`   ${token}`);
+                console.info('');
+                console.info('   Connect your MCP client:');
+                console.info(`   url: ${url}`);
+                console.info(`   Authorization: Bearer ${token}`);
+                if (isAutoGenerated) {
+                    console.info('');
+                    console.info('   To use a fixed token, set MATIMO_MCP_TOKEN or use --token <value>');
+                }
+            }
+            console.info('');
+            console.info('   Press Ctrl+C to stop');
+            console.info('');
+        }
+    }
+    catch (error) {
+        console.error('❌ Failed to start MCP server:', error instanceof Error ? error.message : String(error));
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=mcp.js.map

package/dist/commands/mcp.js.map

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

package/dist/commands/review.d.ts

@@ -0,0 +1,10 @@
+/**
+ * `matimo review` — Human oversight for agent-created tools.
+ *
+ * Subcommands:
+ *   matimo review list              Show all tools awaiting approval
+ *   matimo review approve <name>    Approve a pending tool (requires MATIMO_APPROVAL_SECRET)
+ *   matimo review reject  <name>    Reject / revoke a tool's approval
+ */
+export declare function reviewCommand(args: string[]): Promise<void>;
+//# sourceMappingURL=review.d.ts.map

package/dist/commands/review.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"review.d.ts","sourceRoot":"","sources":["../../src/commands/review.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AA+LH,wBAAsB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAoBjE"}

package/dist/commands/review.js

@@ -0,0 +1,176 @@
+/**
+ * `matimo review` — Human oversight for agent-created tools.
+ *
+ * Subcommands:
+ *   matimo review list              Show all tools awaiting approval
+ *   matimo review approve <name>    Approve a pending tool (requires MATIMO_APPROVAL_SECRET)
+ *   matimo review reject  <name>    Reject / revoke a tool's approval
+ */
+import path from 'path';
+import * as YAML from 'yaml';
+function resolveManifestDir() {
+    // Look for the approvals file in cwd or the MATIMO_TOOL_DIR env var.
+    const toolDir = process.env.MATIMO_TOOL_DIR;
+    return toolDir ? path.resolve(toolDir) : process.cwd();
+}
+/** Try to import @matimo/core and return ApprovalManifest, or null if unavailable. */
+async function tryLoadManifest(dir) {
+    try {
+        // Dynamic import works in both ESM (built CLI) and CJS (ts-jest test transform)
+        const core = (await import('@matimo/core'));
+        const ApprovalManifest = core['ApprovalManifest'];
+        return new ApprovalManifest(dir);
+    }
+    catch {
+        return null;
+    }
+}
+function printTable(headers, rows) {
+    const cols = headers.length;
+    const widths = headers.map((h, i) => Math.max(h.length, ...rows.map((r) => (r[i] ?? '').length)));
+    const divider = widths.map((w) => '─'.repeat(w + 2)).join('┼');
+    const fmt = (row) => '│ ' + row.map((cell, idx) => cell.padEnd(widths[idx])).join(' │ ') + ' │';
+    console.info('┌' + widths.map((w) => '─'.repeat(w + 2)).join('┬') + '┐');
+    console.info(fmt(headers));
+    console.info('├' + divider + '┤');
+    for (const row of rows) {
+        console.info(fmt(row.map((c) => c ?? '').slice(0, cols)));
+    }
+    console.info('└' + widths.map((w) => '─'.repeat(w + 2)).join('┴') + '┘');
+}
+async function listPending(dir) {
+    const manifest = await tryLoadManifest(dir);
+    if (!manifest) {
+        console.error('❌ @matimo/core is not available. Run `pnpm install` first.');
+        process.exit(1);
+    }
+    const pending = manifest.getPendingTools();
+    const approved = manifest.listApproved();
+    if (pending.length === 0 && approved.length === 0) {
+        console.info('ℹ️  No tools are pending or approved.');
+        return;
+    }
+    if (pending.length > 0) {
+        console.info('\n⏳ Pending approval:\n');
+        const rows = pending.map((name) => [name, 'pending', '—', '—']);
+        printTable(['Tool name', 'Status', 'Approved by', 'Approved at'], rows);
+    }
+    if (approved.length > 0) {
+        console.info('\n✅ Approved tools:\n');
+        const rows = approved.map((name) => {
+            const rec = manifest.getApproval(name);
+            return [name, 'approved', rec.approvedBy ?? '—', rec.approvedAt];
+        });
+        printTable(['Tool name', 'Status', 'Approved by', 'Approved at'], rows);
+    }
+    if (pending.length > 0) {
+        console.info(`\nRun "matimo review approve <tool-name>" to approve, or "matimo review reject <tool-name>" to reject.`);
+    }
+}
+async function approveTool(toolName, dir) {
+    if (!toolName) {
+        console.error('❌ Usage: matimo review approve <tool-name>');
+        process.exit(1);
+    }
+    const manifest = await tryLoadManifest(dir);
+    if (!manifest) {
+        console.error('❌ @matimo/core is not available. Run `pnpm install` first.');
+        process.exit(1);
+    }
+    const pending = manifest.getPendingTools();
+    if (!pending.includes(toolName)) {
+        const approved = manifest.listApproved();
+        if (approved.includes(toolName)) {
+            console.info(`ℹ️  "${toolName}" is already approved.`);
+            return;
+        }
+        console.error(`❌ No pending tool named "${toolName}". Run "matimo review list" to see pending tools.`);
+        process.exit(1);
+    }
+    // Require a human-set approval secret — not the auto-generated one
+    const secret = process.env.MATIMO_APPROVAL_SECRET;
+    if (!secret) {
+        console.error('❌ MATIMO_APPROVAL_SECRET is not set.\n' +
+            '   Set it to approve tools: export MATIMO_APPROVAL_SECRET=<your-secret>');
+        process.exit(1);
+    }
+    // Find the definition YAML to hash it
+    const fs = await import('fs');
+    const toolDir = path.join(dir, toolName);
+    const yamlPath = path.join(toolDir, 'definition.yaml');
+    if (!fs.existsSync(yamlPath)) {
+        console.error(`❌ Cannot find definition.yaml for tool "${toolName}" at:\n   ${yamlPath}`);
+        process.exit(1);
+    }
+    const originalYamlContent = fs.readFileSync(yamlPath, 'utf-8');
+    let finalYamlContent = originalYamlContent;
+    // Promote status in definition.yaml to "approved" so runtime policy sees the approval.
+    try {
+        const parsed = YAML.parse(originalYamlContent) ?? {};
+        if (parsed && typeof parsed === 'object') {
+            const currentStatus = parsed.status;
+            if (currentStatus !== 'approved') {
+                parsed.status = 'approved';
+                finalYamlContent = YAML.stringify(parsed);
+                // Write atomically using tmp + rename pattern
+                const tmpPath = yamlPath + '.tmp';
+                fs.writeFileSync(tmpPath, finalYamlContent, 'utf-8');
+                fs.renameSync(tmpPath, yamlPath);
+                console.info(`   📝 Updated status: draft → approved in definition.yaml`);
+            }
+        }
+    }
+    catch {
+        console.warn('⚠️  Failed to update status in definition.yaml; proceeding with manifest approval only.');
+    }
+    const hash = manifest.computeHash(finalYamlContent);
+    const approvedBy = process.env.USER ?? process.env.USERNAME ?? 'cli';
+    manifest.approve(toolName, hash, approvedBy);
+    console.info(`✅ Tool "${toolName}" approved.`);
+}
+async function rejectTool(toolName, dir) {
+    if (!toolName) {
+        console.error('❌ Usage: matimo review reject <tool-name>');
+        process.exit(1);
+    }
+    const manifest = await tryLoadManifest(dir);
+    if (!manifest) {
+        console.error('❌ @matimo/core is not available. Run `pnpm install` first.');
+        process.exit(1);
+    }
+    const wasApproved = manifest.revoke(toolName);
+    // Remove from pending even if it wasn't in approved set
+    // (revoke only removes from approved; pending is cleaned up on next loadFromDisk)
+    // Re-save by marking and un-marking is not clean — just confirm action
+    const pending = manifest.getPendingTools();
+    const wasPending = pending.includes(toolName);
+    if (!wasApproved && !wasPending) {
+        console.info(`ℹ️  No record of tool "${toolName}". Nothing to reject.`);
+        return;
+    }
+    console.info(`🗑  Tool "${toolName}" has been rejected/revoked.`);
+    if (wasApproved) {
+        console.info('   (Approval signature removed — the tool will be blocked until re-approved.)');
+    }
+}
+export async function reviewCommand(args) {
+    const sub = args[0];
+    const dir = resolveManifestDir();
+    switch (sub) {
+        case 'list':
+        case undefined:
+            await listPending(dir);
+            break;
+        case 'approve':
+            await approveTool(args[1], dir);
+            break;
+        case 'reject':
+            await rejectTool(args[1], dir);
+            break;
+        default:
+            console.error(`❌ Unknown review subcommand: "${sub}"`);
+            console.info('Usage: matimo review [list|approve|reject] [tool-name]');
+            process.exit(1);
+    }
+}
+//# sourceMappingURL=review.js.map

package/dist/commands/review.js.map

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

package/package.json

@@ -1,28 +1,27 @@
 {
   "name": "@matimo/cli",
-  "version": "0.1.0-alpha.9",
+  "version": "0.1.2",
   "description": "CLI tools for managing Matimo tool installations",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "type": "module",
   "bin": {
-    "matimo": "bin/matimo.cjs"
+    "matimo": "dist/bin.js"
   },
   "files": [
-    "bin",
     "dist",
     "README.md"
   ],
   "dependencies": {
-    "@matimo/core": "0.1.0-alpha.9"
+    "tsx": "^4.21.0",
+    "@matimo/core": "0.1.2"
   },
   "devDependencies": {
     "@types/node": "^25.1.0",
-    "typescript": "^5.9.3",
-    "tsx": "^4.21.0"
+    "typescript": "^5.9.3"
   },
   "peerDependencies": {
-    "matimo": "0.1.0-alpha.9"
+    "matimo": "0.1.2"
   },
   "scripts": {
     "build": "tsc",

package/LICENSE

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2026 tallclub
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.

package/bin/matimo.cjs

@@ -1,26 +0,0 @@
-#!/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);
-});