thinkwell 0.4.0 → 0.4.2

package/bin/thinkwell

@@ -58,6 +58,11 @@ function getTypesCommandPath() {
   return resolve(__dirname, "../dist/cli/types-command.js");
 }
 
+// Get the path to the build command script
+function getBuildCommandPath() {
+  return resolve(__dirname, "../dist/cli/build.js");
+}
+
 // Get the path to the bundled CLI loader
 function getLoaderPath() {
   return resolve(__dirname, "../dist-pkg/cli-loader.cjs");
@@ -165,6 +170,7 @@ thinkwell - Run TypeScript scripts with automatic schema generation
 Usage:
   thinkwell <script.ts> [args...]     Run a TypeScript script
   thinkwell run <script.ts> [args...] Explicit run command
+  thinkwell build <script.ts>         Compile to standalone executable
   thinkwell init [project-name]       Initialize a new project
   thinkwell types [dir]               Generate .d.ts files for IDE support
   thinkwell types --watch [dir]       Watch and regenerate .d.ts files
@@ -174,6 +180,7 @@ Usage:
 Examples:
   thinkwell hello.ts                 Run hello.ts
   thinkwell run hello.ts --verbose   Run with arguments
+  thinkwell build src/agent.ts       Compile to binary
   thinkwell init my-agent            Create a new project
   ./script.ts                        Via shebang: #!/usr/bin/env thinkwell
   thinkwell types                    Generate declarations in current dir
@@ -275,6 +282,37 @@ async function runUserScript(scriptPath, args) {
   }
 }
 
+/**
+ * Run the build command to compile scripts into standalone executables.
+ */
+async function runBuildCommand(args) {
+  const buildCommandPath = getBuildCommandPath();
+  if (!existsSync(buildCommandPath)) {
+    console.error("Error: thinkwell installation appears to be corrupted.");
+    console.error(`  - Build command not found: ${buildCommandPath}`);
+    console.error("\nTry reinstalling with: npm install thinkwell");
+    process.exit(1);
+  }
+
+  // Import and run the build command
+  const { parseBuildArgs, runBuild, showBuildHelp } = await import(buildCommandPath);
+
+  // Check for help flag
+  if (args.includes("--help") || args.includes("-h")) {
+    showBuildHelp();
+    process.exit(0);
+  }
+
+  try {
+    const options = parseBuildArgs(args);
+    await runBuild(options);
+  } catch (error) {
+    console.error(`Error: ${error.message}`);
+    process.exit(1);
+  }
+  process.exit(0);
+}
+
 /**
  * Run the types command.
  *
@@ -327,8 +365,12 @@ async function main() {
     process.exit(0);
   }
 
-  // Handle --help (global)
-  if (args.includes("--help") || args.includes("-h") || args.length === 0) {
+  // Handle --help (global) - but not if it's a subcommand's help
+  // e.g., "thinkwell build --help" should show build help, not global help
+  const subcommands = ["init", "build", "types", "run"];
+  const firstArg = args[0];
+  const isSubcommandHelp = subcommands.includes(firstArg) && (args.includes("--help") || args.includes("-h"));
+  if (!isSubcommandHelp && (args.includes("--help") || args.includes("-h") || args.length === 0)) {
     showHelp();
     process.exit(0);
   }
@@ -346,6 +388,12 @@ async function main() {
     return;
   }
 
+  // Handle "build" subcommand
+  if (args[0] === "build") {
+    await runBuildCommand(args.slice(1));
+    return;
+  }
+
   // All script execution requires Node 24+ and proper installation
   validateNodeVersion();
   validateInstallation();

package/dist/cli/build.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Build command for creating self-contained executables from user scripts.
+ *
+ * This module provides the `thinkwell build` command that compiles user scripts
+ * into standalone binaries using the same pkg-based tooling as the thinkwell CLI.
+ *
+ * The build process follows a two-stage pipeline:
+ * 1. **Pre-bundle with esbuild** - Bundle user script + thinkwell packages into CJS
+ * 2. **Compile with pkg** - Create self-contained binary with Node.js runtime
+ */
+export type Target = "darwin-arm64" | "darwin-x64" | "linux-x64" | "linux-arm64" | "host";
+export interface BuildOptions {
+    /** Entry point TypeScript/JavaScript file */
+    entry: string;
+    /** Output file path (default: ./<entry-basename>-<target>) */
+    output?: string;
+    /** Target platforms (default: ["host"]) */
+    targets?: Target[];
+    /** Additional files to embed as assets */
+    include?: string[];
+    /** Packages to exclude from bundling (kept as external imports) */
+    external?: string[];
+    /** Show detailed build output */
+    verbose?: boolean;
+    /** Suppress all non-error output (for CI environments) */
+    quiet?: boolean;
+    /** Show what would be built without actually building */
+    dryRun?: boolean;
+    /** Minify the bundled output for smaller binaries */
+    minify?: boolean;
+    /** Watch for changes and rebuild automatically */
+    watch?: boolean;
+}
+/**
+ * Configuration that can be specified in package.json under "thinkwell.build".
+ */
+export interface PackageJsonBuildConfig {
+    /** Default output path */
+    output?: string;
+    /** Default target platforms */
+    targets?: Target[];
+    /** Default assets to include */
+    include?: string[];
+    /** Default packages to exclude from bundling */
+    external?: string[];
+    /** Default minification setting */
+    minify?: boolean;
+}
+/**
+ * Parse and validate build options from command-line arguments.
+ */
+export declare function parseBuildArgs(args: string[]): BuildOptions;
+/**
+ * Main build function.
+ */
+export declare function runBuild(options: BuildOptions): Promise<void>;
+/**
+ * Show help for the build command.
+ */
+export declare function showBuildHelp(): void;
+//# sourceMappingURL=build.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../src/cli/build.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AA6IH,MAAM,MAAM,MAAM,GAAG,cAAc,GAAG,YAAY,GAAG,WAAW,GAAG,aAAa,GAAG,MAAM,CAAC;AA0B1F,MAAM,WAAW,YAAY;IAC3B,6CAA6C;IAC7C,KAAK,EAAE,MAAM,CAAC;IACd,8DAA8D;IAC9D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,2CAA2C;IAC3C,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,0CAA0C;IAC1C,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,mEAAmE;IACnE,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,iCAAiC;IACjC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,0DAA0D;IAC1D,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,yDAAyD;IACzD,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,qDAAqD;IACrD,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,kDAAkD;IAClD,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,0BAA0B;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,+BAA+B;IAC/B,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,gCAAgC;IAChC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,gDAAgD;IAChD,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,mCAAmC;IACnC,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAqGD;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,YAAY,CA4E3D;AAq3BD;;GAEG;AACH,wBAAsB,QAAQ,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CA0FnE;AAkJD;;GAEG;AACH,wBAAgB,aAAa,IAAI,IAAI,CA+DpC"}