@within-7/minto 0.4.2 → 0.4.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@within-7/minto",
-  "version": "0.4.2",
+  "version": "0.4.3",
   "type": "module",
   "description": "AI-powered strategic research and planning assistant",
   "author": "Lib <within-7>",
@@ -43,10 +43,10 @@
     "x64"
   ],
   "files": [
+    "cli.js",
     "cli.cjs",
     "yoga.wasm",
-    "dist/**/*",
-    "!dist/binaries",
+    "vendor/**/*",
     "scripts/postinstall.cjs",
     ".npmrc"
   ],
@@ -56,7 +56,7 @@
     "build": "node scripts/build.mjs",
     "build:packages": "node scripts/build-platform-packages.mjs",
     "build:website": "node scripts/build-website.mjs",
-    "clean": "rm -rf cli.cjs dist binaries packages",
+    "clean": "rm -rf cli.js cli.cjs dist vendor binaries packages build-meta.json",
     "test": "bun test ./tests ./src",
     "test:unit": "bun test ./tests",
     "test:src": "bun test ./src",
@@ -70,21 +70,25 @@
     "release": "node scripts/release-full.cjs",
     "release:dry-run": "node scripts/release-full.cjs --dry-run"
   },
-  "optionalDependencies": {
-    "@within-7/minto-darwin-arm64": "0.4.2",
-    "@within-7/minto-darwin-x64": "0.4.2",
-    "@within-7/minto-linux-arm64": "0.4.2",
-    "@within-7/minto-linux-x64": "0.4.2",
-    "@within-7/minto-win32-x64": "0.4.2"
-  },
-  "dependencies": {
+  "devDependencies": {
     "@anthropic-ai/bedrock-sdk": "^0.12.6",
     "@anthropic-ai/sdk": "^0.39.0",
     "@anthropic-ai/vertex-sdk": "^0.7.0",
     "@commander-js/extra-typings": "^13.1.0",
     "@inkjs/ui": "^2.0.0",
     "@modelcontextprotocol/sdk": "^1.15.1",
+    "@types/bun": "latest",
+    "@types/debug": "^4.1.12",
+    "@types/diff": "^7.0.0",
+    "@types/lodash-es": "^4.17.12",
+    "@types/minimatch": "^6.0.0",
+    "@types/node": "^22.0.0",
+    "@types/react": "^18.3.18",
+    "@types/semver": "^7.5.8",
+    "@types/shell-quote": "^1.7.5",
+    "@types/turndown": "^5.0.5",
     "ansi-escapes": "^7.0.0",
+    "bun-types": "latest",
     "chalk": "^5.4.1",
     "cli-highlight": "^2.1.11",
     "cli-table3": "^0.6.5",
@@ -93,6 +97,7 @@
     "diff": "^7.0.0",
     "dotenv": "^16.6.1",
     "env-paths": "^3.0.0",
+    "esbuild": "^0.25.0",
     "figures": "^6.1.0",
     "glob": "^11.0.3",
     "gray-matter": "^4.0.3",
@@ -109,45 +114,23 @@
     "node-fetch": "^3.3.2",
     "node-html-parser": "^7.0.1",
     "openai": "^4.104.0",
+    "prettier": "^3.6.2",
     "react": "^18.3.1",
     "semver": "^7.7.2",
+    "sharp": "^0.34.5",
     "shell-quote": "^1.8.3",
     "signal-exit": "3.0.7",
     "spawn-rx": "^5.1.2",
     "string-width": "4.2.3",
     "strip-ansi": "6.0.1",
+    "tsx": "^4.20.3",
     "turndown": "^7.2.0",
+    "typescript": "^5.9.2",
     "undici": "^6.22.0",
     "wrap-ansi": "8.1.0",
     "zod": "^3.25.76",
     "zod-to-json-schema": "^3.24.6"
   },
-  "devDependencies": {
-    "@types/bun": "latest",
-    "@types/debug": "^4.1.12",
-    "@types/diff": "^7.0.0",
-    "@types/lodash-es": "^4.17.12",
-    "@types/minimatch": "^6.0.0",
-    "@types/node": "^22.0.0",
-    "@types/react": "^18.3.18",
-    "@types/semver": "^7.5.8",
-    "@types/shell-quote": "^1.7.5",
-    "@types/turndown": "^5.0.5",
-    "bun-types": "latest",
-    "esbuild": "^0.25.0",
-    "prettier": "^3.6.2",
-    "sharp": "^0.34.5",
-    "tsx": "^4.20.3",
-    "typescript": "^5.9.2"
-  },
-  "peerDependencies": {
-    "react": "^18.0.0"
-  },
-  "peerDependenciesMeta": {
-    "react": {
-      "optional": true
-    }
-  },
   "resolutions": {
     "signal-exit": "3.0.7",
     "string-width": "4.2.3",

package/scripts/postinstall.cjs

@@ -2,151 +2,34 @@
 
 /**
  * Minto Post-Install Script
- *
- * This script runs after npm install to:
- * 1. Check if the platform-specific binary was installed
- * 2. Display helpful getting-started information
- *
- * The binary is installed automatically via optionalDependencies.
- * If it fails (e.g., unsupported platform), we fall back to JS mode.
+ * Displays getting-started information after npm install.
  */
 
-const fs = require('fs');
-const path = require('path');
-
-const PACKAGE_ROOT = path.join(__dirname, '..');
+function postinstall() {
+  if (process.env.npm_lifecycle_event !== 'postinstall') return;
 
-/**
- * Get the package version from package.json
- */
-function getPackageVersion() {
   try {
-    const pkgPath = path.join(PACKAGE_ROOT, 'package.json');
-    const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf8'));
-    return pkg.version;
-  } catch {
-    return 'unknown';
-  }
-}
-
-/**
- * Get the expected package name for this platform
- */
-function getPlatformPackageName() {
-  const platform = process.platform; // darwin, linux, win32
-  const arch = process.arch; // arm64, x64
-  return `@within-7/minto-${platform}-${arch}`;
-}
+    var fs = require('fs');
+    var path = require('path');
+    var pkgPath = path.join(__dirname, '..', 'package.json');
+    var version = 'unknown';
+    try { version = JSON.parse(fs.readFileSync(pkgPath, 'utf8')).version; } catch(e) {}
 
-/**
- * Check if the platform binary package was installed
- */
-function checkBinaryInstalled() {
-  const packageName = getPlatformPackageName();
-  const binaryName = process.platform === 'win32' ? 'minto.exe' : 'minto';
-
-  // Check possible installation locations
-  const possiblePaths = [
-    // Standard npm install location
-    path.join(PACKAGE_ROOT, 'node_modules', packageName, binaryName),
-    // Hoisted location
-    path.join(PACKAGE_ROOT, '..', packageName, binaryName),
-    // Global install
-    path.join(PACKAGE_ROOT, '..', '..', packageName, binaryName),
-  ];
+    var isGlobal = process.env.npm_config_global === 'true';
 
-  for (const binaryPath of possiblePaths) {
-    if (fs.existsSync(binaryPath)) {
-      // Ensure executable permission on Unix
-      if (process.platform !== 'win32') {
-        try {
-          fs.chmodSync(binaryPath, 0o755);
-        } catch {
-          // Ignore permission errors
-        }
-      }
-      return {
-        installed: true,
-        path: binaryPath,
-        packageName,
-      };
+    console.error('');
+    console.error('  Minto v' + version + ' installed successfully');
+    console.error('');
+    if (isGlobal) {
+      console.error('  Run: minto');
+    } else {
+      console.error('  Run: npx minto');
     }
-  }
-
-  return {
-    installed: false,
-    packageName,
-  };
-}
-
-/**
- * Display installation success message
- */
-function displaySuccessMessage(binaryStatus) {
-  const version = getPackageVersion();
-  const isGlobal = process.env.npm_config_global === 'true';
-
-  console.error('');
-  console.error('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
-  console.error('');
-  console.error('  ✨ Minto 安装成功！');
-  console.error('  📦 版本: ' + version);
-
-  if (binaryStatus.installed) {
-    console.error('  🚀 运行模式: 原生二进制 (最佳性能)');
-  } else {
-    console.error('  📋 运行模式: JavaScript');
-    console.error('  💡 提示: 原生二进制不可用，将使用 JS 回退模式');
-  }
-
-  console.error('');
-  console.error('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
-  console.error('');
-  console.error('  🚀 快速开始:');
-  console.error('');
-
-  if (isGlobal) {
-    console.error('     minto              # 启动交互模式');
-    console.error('     minto --help       # 查看所有命令');
-  } else {
-    console.error('     npx minto          # 启动交互模式');
-    console.error('     npx minto --help   # 查看所有命令');
-  }
-
-  console.error('');
-  console.error('  📚 文档: https://minto.within-7.com/');
-  console.error('  🐛 问题反馈: https://github.com/within-7/minto/issues');
-  console.error('');
-  console.error('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
-  console.error('');
-
-  if (!isGlobal) {
-    console.error('  💡 提示: 全局安装可以更方便地使用:');
-    console.error('     npm install -g @within-7/minto');
+    console.error('  Docs: https://minto.within-7.com/');
     console.error('');
+  } catch(e) {
+    // postinstall should never break installation
   }
 }
 
-/**
- * Main postinstall function
- */
-function postinstall() {
-  // Only run during actual npm postinstall
-  if (process.env.npm_lifecycle_event !== 'postinstall') {
-    return;
-  }
-
-  try {
-    // Check if binary was installed
-    const binaryStatus = checkBinaryInstalled();
-
-    // Display success message
-    displaySuccessMessage(binaryStatus);
-  } catch (err) {
-    // Silently fail - postinstall should never break installation
-    // Users can still use JavaScript fallback mode
-  }
-}
-
-// Run postinstall
 postinstall();

package/dist/Tool.js

@@ -1,46 +0,0 @@
-function getToolDescription(tool) {
-  if (tool.cachedDescription) {
-    return tool.cachedDescription;
-  }
-  if (typeof tool.description === "string") {
-    return tool.description;
-  }
-  return `Tool: ${tool.name}`;
-}
-async function getToolDescriptionAsync(tool, input) {
-  if (typeof tool.description === "string") {
-    return tool.description;
-  }
-  if (typeof tool.description === "function") {
-    return await tool.description(input);
-  }
-  return `Tool: ${tool.name}`;
-}
-async function cacheToolDescriptions(tools) {
-  const { zodToJsonSchema } = await import("zod-to-json-schema");
-  await Promise.all(
-    tools.map(async (tool) => {
-      if (typeof tool.description === "function" && !tool.cachedDescription) {
-        try {
-          tool.cachedDescription = await tool.description();
-        } catch (error) {
-          tool.cachedDescription = `Tool: ${tool.name}`;
-        }
-      } else if (typeof tool.description === "string" && !tool.cachedDescription) {
-        tool.cachedDescription = tool.description;
-      }
-      if (!tool.inputJSONSchema && tool.inputSchema) {
-        try {
-          tool.inputJSONSchema = zodToJsonSchema(tool.inputSchema);
-        } catch {
-        }
-      }
-    })
-  );
-}
-export {
-  cacheToolDescriptions,
-  getToolDescription,
-  getToolDescriptionAsync
-};
-//# sourceMappingURL=Tool.js.map

package/dist/Tool.js.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../src/Tool.ts"],
-  "sourcesContent": ["import { z } from 'zod'\nimport * as React from 'react'\nimport type { UserQuestion, UserAnswer } from './types/askUserQuestion'\nimport type {\n  ToolUseOptions,\n  ResponseState,\n  ValidationResult as CoreValidationResult,\n} from './types/core'\n\n/**\n * Core Tool interface for Minto's extensible tool system\n * Provides standardized contract for all tool implementations\n *\n * IMPORTANT: Tool descriptions can be either:\n * - A string (synchronous, preferred for adapters)\n * - An async function (for dynamic descriptions)\n * - An async function that accepts input (for context-aware descriptions)\n *\n * Use getToolDescription() helper for safe synchronous access.\n */\n\nexport type SetToolJSXFn = (\n  jsx: {\n    jsx: React.ReactNode | null\n    shouldHidePromptInput: boolean\n  } | null,\n) => void\n\n/**\n * Function type for asking the user questions\n */\nexport type AskUserFn = (questions: UserQuestion[]) => Promise<UserAnswer[]>\n\nexport interface ToolUseContext {\n  messageId: string | undefined\n  agentId?: string\n  /** The tool_use ID from the API (for tracking concurrent executions) */\n  toolUseId?: string\n  safeMode?: boolean\n  abortController: AbortController\n  readFileTimestamps: { [filePath: string]: number }\n  options?: ToolUseOptions\n  responseState?: ResponseState\n}\n\nexport interface ExtendedToolUseContext extends ToolUseContext {\n  setToolJSX: SetToolJSXFn\n  askUser?: AskUserFn\n}\n\n// Re-export for backward compatibility\nexport type ValidationResult = CoreValidationResult\n\n/**\n * Tool interface \u2014 non-generic to avoid variance issues with tool collections.\n *\n * Individual tool implementations use `satisfies Tool` for type checking\n * at the definition site, with their own schema-inferred types internally.\n * The non-generic interface allows tools to be collected in Tool[] arrays\n * without requiring `as unknown as Tool` casts.\n */\n/* eslint-disable @typescript-eslint/no-explicit-any -- Intentional: non-generic interface uses `any`\n   for tool-specific input/output types. Individual tools use concrete types via `satisfies Tool`. */\nexport interface Tool {\n  name: string\n  /**\n   * Tool description - can be:\n   * - A string (synchronous, best for adapters)\n   * - An async function returning string (for dynamic descriptions)\n   * - An async function accepting input (for context-aware descriptions)\n   *\n   * Use getToolDescription() for safe synchronous access in adapters.\n   */\n  description?: string | ((input?: any) => Promise<string>)\n  /**\n   * Cached description for synchronous access.\n   * Populated by cacheToolDescriptions() at startup.\n   */\n  cachedDescription?: string\n  inputSchema: z.ZodObject<any>\n  inputJSONSchema?: Record<string, unknown>\n  prompt: (options?: { safeMode?: boolean }) => Promise<string>\n  /** User-facing name for display. Can optionally accept input for context. */\n  userFacingName?: (input?: any) => string\n  isEnabled: () => Promise<boolean>\n  /** Whether this tool only reads data (no side effects). */\n  isReadOnly: (input?: any) => boolean\n  /** Whether this tool is safe to run concurrently with other tools. */\n  isConcurrencySafe: (input?: any) => boolean\n  needsPermissions: (input?: any) => boolean\n  /** Whether this tool requires user interaction (e.g., confirmation dialogs). */\n  requiresUserInteraction?: (input?: any) => boolean\n  validateInput?: (\n    input: any,\n    context?: ToolUseContext,\n  ) => Promise<ValidationResult>\n  renderResultForAssistant: (output: any) => string | any[]\n  renderToolUseMessage: (\n    input: any,\n    options: { verbose: boolean },\n  ) => string | React.ReactElement | null\n  renderToolUseRejectedMessage?: (...args: any[]) => React.ReactElement | null\n  /** Render the tool result for display. */\n  renderToolResultMessage?: (\n    output: any,\n    options?: { verbose: boolean },\n  ) => React.ReactNode\n  call: (\n    input: any,\n    context: ToolUseContext,\n  ) => AsyncGenerator<\n    | {\n        type: 'result'\n        data: any\n        resultForAssistant?: string | any[]\n        newMessages?: unknown[]\n        contextModifier?: {\n          modifyContext: (ctx: ToolUseContext) => ToolUseContext\n        }\n      }\n    | {\n        type: 'progress'\n        content: any\n        normalizedMessages?: any[]\n        tools?: any[]\n      },\n    void,\n    unknown\n  >\n}\n/* eslint-enable @typescript-eslint/no-explicit-any */\n\n/**\n * Get tool description synchronously.\n * Returns cached description if available, or falls back to string description,\n * or a default value if description is async and not cached.\n *\n * @param tool - The tool to get description from\n * @returns The tool description string\n */\nexport function getToolDescription(tool: Tool): string {\n  // First check cached description\n  if (tool.cachedDescription) {\n    return tool.cachedDescription\n  }\n\n  // If description is a string, return it directly\n  if (typeof tool.description === 'string') {\n    return tool.description\n  }\n\n  // Fallback for async descriptions that haven't been cached\n  return `Tool: ${tool.name}`\n}\n\n/**\n * Get tool description asynchronously.\n * Always returns the actual description, resolving async functions if needed.\n *\n * @param tool - The tool to get description from\n * @param input - Optional input for context-aware descriptions\n * @returns Promise resolving to the tool description string\n */\nexport async function getToolDescriptionAsync(\n  tool: Tool,\n  input?: unknown,\n): Promise<string> {\n  if (typeof tool.description === 'string') {\n    return tool.description\n  }\n\n  if (typeof tool.description === 'function') {\n    return await tool.description(input)\n  }\n\n  return `Tool: ${tool.name}`\n}\n\n/**\n * Cache descriptions and JSON schemas for all tools.\n * Should be called at startup to ensure synchronous access works\n * and to avoid per-request zodToJsonSchema() calls.\n *\n * @param tools - Array of tools to cache descriptions for\n */\nexport async function cacheToolDescriptions(tools: Tool[]): Promise<void> {\n  // Lazy import to avoid circular dependency at module load time\n  const { zodToJsonSchema } = await import('zod-to-json-schema')\n\n  await Promise.all(\n    tools.map(async tool => {\n      // Cache description\n      if (typeof tool.description === 'function' && !tool.cachedDescription) {\n        try {\n          tool.cachedDescription = await tool.description()\n        } catch (error) {\n          // Fallback on error\n          tool.cachedDescription = `Tool: ${tool.name}`\n        }\n      } else if (\n        typeof tool.description === 'string' &&\n        !tool.cachedDescription\n      ) {\n        tool.cachedDescription = tool.description\n      }\n\n      // Cache JSON schema (avoids zodToJsonSchema per-request per-tool)\n      if (!tool.inputJSONSchema && tool.inputSchema) {\n        try {\n          tool.inputJSONSchema = zodToJsonSchema(tool.inputSchema) as Record<\n            string,\n            unknown\n          >\n        } catch {\n          // Schema will be computed on-demand by providers as fallback\n        }\n      }\n    }),\n  )\n}\n"],
-  "mappings": "AA4IO,SAAS,mBAAmB,MAAoB;AAErD,MAAI,KAAK,mBAAmB;AAC1B,WAAO,KAAK;AAAA,EACd;AAGA,MAAI,OAAO,KAAK,gBAAgB,UAAU;AACxC,WAAO,KAAK;AAAA,EACd;AAGA,SAAO,SAAS,KAAK,IAAI;AAC3B;AAUA,eAAsB,wBACpB,MACA,OACiB;AACjB,MAAI,OAAO,KAAK,gBAAgB,UAAU;AACxC,WAAO,KAAK;AAAA,EACd;AAEA,MAAI,OAAO,KAAK,gBAAgB,YAAY;AAC1C,WAAO,MAAM,KAAK,YAAY,KAAK;AAAA,EACrC;AAEA,SAAO,SAAS,KAAK,IAAI;AAC3B;AASA,eAAsB,sBAAsB,OAA8B;AAExE,QAAM,EAAE,gBAAgB,IAAI,MAAM,OAAO,oBAAoB;AAE7D,QAAM,QAAQ;AAAA,IACZ,MAAM,IAAI,OAAM,SAAQ;AAEtB,UAAI,OAAO,KAAK,gBAAgB,cAAc,CAAC,KAAK,mBAAmB;AACrE,YAAI;AACF,eAAK,oBAAoB,MAAM,KAAK,YAAY;AAAA,QAClD,SAAS,OAAO;AAEd,eAAK,oBAAoB,SAAS,KAAK,IAAI;AAAA,QAC7C;AAAA,MACF,WACE,OAAO,KAAK,gBAAgB,YAC5B,CAAC,KAAK,mBACN;AACA,aAAK,oBAAoB,KAAK;AAAA,MAChC;AAGA,UAAI,CAAC,KAAK,mBAAmB,KAAK,aAAa;AAC7C,YAAI;AACF,eAAK,kBAAkB,gBAAgB,KAAK,WAAW;AAAA,QAIzD,QAAQ;AAAA,QAER;AAAA,MACF;AAAA,IACF,CAAC;AAAA,EACH;AACF;",
-  "names": []
-}