thinkwell 0.2.0 → 0.3.0-alpha.2

package/bin/thinkwell

@@ -0,0 +1,257 @@
+#!/usr/bin/env node
+
+/**
+ * Thinkwell CLI launcher
+ *
+ * This Node.js script detects if Bun is available and delegates to it
+ * with the @thinkwell/bun-plugin preloaded.
+ */
+
+import { execSync, spawn } from "node:child_process";
+import { dirname, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { existsSync } from "node:fs";
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+
+// Check if Bun is available and return version or null
+function getBunVersion() {
+  try {
+    const version = execSync("bun --version", { encoding: "utf-8" }).trim();
+    return version;
+  } catch {
+    return null;
+  }
+}
+
+// Get the path to the plugin
+function getPluginPath() {
+  // When installed via npm, the plugin is in our node_modules
+  return resolve(__dirname, "../node_modules/@thinkwell/bun-plugin/dist/index.js");
+}
+
+// Get the path to our node_modules (where thinkwell packages are installed)
+function getNodeModulesPath() {
+  return resolve(__dirname, "../node_modules");
+}
+
+// Get the path to the types command script
+function getTypesCommandPath() {
+  return resolve(__dirname, "../dist/cli/types-command.js");
+}
+
+// Validate that required files exist for commands that require Bun
+function validateInstallation() {
+  const pluginPath = getPluginPath();
+  const typesCommandPath = getTypesCommandPath();
+  const errors = [];
+
+  if (!existsSync(pluginPath)) {
+    errors.push(`Plugin not found: ${pluginPath}`);
+  }
+
+  if (!existsSync(typesCommandPath)) {
+    errors.push(`Types command not found: ${typesCommandPath}`);
+  }
+
+  if (errors.length > 0) {
+    console.error("Error: thinkwell installation appears to be corrupted.");
+    for (const error of errors) {
+      console.error(`  - ${error}`);
+    }
+    console.error("\nTry reinstalling with: npm install thinkwell");
+    process.exit(1);
+  }
+}
+
+// Validate init command is available
+function validateInitCommand() {
+  const initCommandPath = getInitCommandPath();
+  if (!existsSync(initCommandPath)) {
+    console.error("Error: thinkwell installation appears to be corrupted.");
+    console.error(`  - Init command not found: ${initCommandPath}`);
+    console.error("\nTry reinstalling with: npm install thinkwell");
+    process.exit(1);
+  }
+}
+
+// Parse version from package.json
+async function getVersion() {
+  const packagePath = resolve(__dirname, "../package.json");
+  const { default: pkg } = await import(packagePath, { with: { type: "json" } });
+  return pkg.version;
+}
+
+// Get the path to the init command script
+function getInitCommandPath() {
+  return resolve(__dirname, "../dist/cli/init-command.js");
+}
+
+// Show help message
+function showHelp() {
+  console.log(`
+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 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
+  thinkwell --help                    Show this help message
+  thinkwell --version                 Show version
+
+Examples:
+  thinkwell hello.ts                 Run hello.ts
+  thinkwell run hello.ts --verbose   Run with arguments
+  thinkwell init my-agent            Create a new project
+  ./script.ts                        Via shebang: #!/usr/bin/env thinkwell
+  thinkwell types                    Generate declarations in current dir
+  thinkwell types src                Generate declarations in src/
+  thinkwell types --watch            Watch for changes and regenerate
+
+The thinkwell CLI automatically:
+  - Generates JSON Schema for types marked with @JSONSchema
+  - Resolves thinkwell:* imports to built-in modules
+  - Creates .thinkwell.d.ts files for IDE autocomplete (types command)
+
+For more information, visit: https://github.com/dherman/thinkwell
+`);
+}
+
+async function main() {
+  const args = process.argv.slice(2);
+
+  // Handle "init" subcommand first - does NOT require Bun
+  // Must be before global --help so "init --help" shows init-specific help
+  if (args[0] === "init") {
+    validateInitCommand();
+    const initArgs = args.slice(1);
+    const initCommandPath = getInitCommandPath();
+
+    // Import and run the init command
+    const { runInit } = await import(initCommandPath);
+    await runInit(initArgs);
+    process.exit(0);
+  }
+
+  // Handle --help (global)
+  if (args.includes("--help") || args.includes("-h") || args.length === 0) {
+    showHelp();
+    process.exit(0);
+  }
+
+  // Handle --version
+  if (args.includes("--version") || args.includes("-v")) {
+    const version = await getVersion();
+    console.log(`thinkwell ${version}`);
+    process.exit(0);
+  }
+
+  // All commands below require Bun
+  const bunVersion = getBunVersion();
+  if (!bunVersion) {
+    console.error("Error: Bun is required to run thinkwell scripts.");
+    console.error("");
+    console.error("The thinkwell runtime uses Bun for TypeScript execution and schema");
+    console.error("generation. This also enables features like compiled executables.");
+    console.error("");
+    console.error("To install Bun:");
+    console.error("  curl -fsSL https://bun.sh/install | bash");
+    console.error("");
+    console.error("Or via Homebrew:");
+    console.error("  brew install oven-sh/bun/bun");
+    console.error("");
+    console.error("For more information: https://bun.sh");
+    process.exit(1);
+  }
+
+  // Validate installation
+  validateInstallation();
+
+  // Handle "types" subcommand
+  if (args[0] === "types") {
+    const typesArgs = args.slice(1);
+    const typesCommandPath = getTypesCommandPath();
+    const bunArgs = [typesCommandPath, ...typesArgs];
+
+    const child = spawn("bun", bunArgs, {
+      stdio: "inherit",
+      env: process.env,
+    });
+
+    child.on("error", (err) => {
+      console.error(`Error: Failed to execute 'bun' command.`);
+      console.error(`  ${err.message}`);
+      if (err.code === "ENOENT") {
+        console.error("");
+        console.error("Bun was detected but cannot be executed.");
+        console.error("Ensure 'bun' is in your PATH and has execute permissions.");
+      }
+      process.exit(1);
+    });
+
+    child.on("exit", (code) => {
+      process.exit(code ?? 0);
+    });
+
+    return;
+  }
+
+  // Handle "run" subcommand - just strip it
+  const runArgs = args[0] === "run" ? args.slice(1) : args;
+
+  // If no script provided after "run", show help
+  if (runArgs.length === 0) {
+    console.error("Error: No script provided.");
+    console.error("");
+    console.error("Usage: thinkwell run <script.ts> [args...]");
+    process.exit(1);
+  }
+
+  // Check if the script file exists
+  const scriptPath = runArgs[0];
+  if (!scriptPath.startsWith("-") && !existsSync(scriptPath)) {
+    // Try resolving relative to cwd
+    const resolvedPath = resolve(process.cwd(), scriptPath);
+    if (!existsSync(resolvedPath)) {
+      console.error(`Error: Script not found: ${scriptPath}`);
+      console.error("");
+      console.error("Make sure the file exists and the path is correct.");
+      process.exit(1);
+    }
+  }
+
+  // Delegate to bun with plugin preloaded
+  const pluginPath = getPluginPath();
+  const nodeModulesPath = getNodeModulesPath();
+  const bunArgs = ["--preload", pluginPath, ...runArgs];
+
+  // Add our node_modules to NODE_PATH so Bun can find thinkwell packages
+  // regardless of where the script is located
+  const nodePath = process.env.NODE_PATH
+    ? `${nodeModulesPath}:${process.env.NODE_PATH}`
+    : nodeModulesPath;
+
+  const child = spawn("bun", bunArgs, {
+    stdio: "inherit",
+    env: { ...process.env, NODE_PATH: nodePath },
+  });
+
+  child.on("error", (err) => {
+    console.error(`Error: Failed to execute 'bun' command.`);
+    console.error(`  ${err.message}`);
+    if (err.code === "ENOENT") {
+      console.error("");
+      console.error("Bun was detected but cannot be executed.");
+      console.error("Ensure 'bun' is in your PATH and has execute permissions.");
+    }
+    process.exit(1);
+  });
+
+  child.on("exit", (code) => {
+    process.exit(code ?? 0);
+  });
+}
+
+main();

package/dist/cli/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Thinkwell CLI
+ *
+ * This module provides the Bun-native entry point for the thinkwell CLI.
+ * For npm distribution, see bin/thinkwell which is a Node.js launcher.
+ *
+ * @packageDocumentation
+ */
+export declare const VERSION = "0.2.0";
+export { THINKWELL_MODULES } from "@thinkwell/bun-plugin";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,eAAO,MAAM,OAAO,UAAU,CAAC;AAE/B,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/cli/index.js

@@ -0,0 +1,11 @@
+/**
+ * Thinkwell CLI
+ *
+ * This module provides the Bun-native entry point for the thinkwell CLI.
+ * For npm distribution, see bin/thinkwell which is a Node.js launcher.
+ *
+ * @packageDocumentation
+ */
+export const VERSION = "0.2.0";
+export { THINKWELL_MODULES } from "@thinkwell/bun-plugin";
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC;AAE/B,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/cli/init-command.d.ts

@@ -0,0 +1,8 @@
+/**
+ * CLI command for initializing a new thinkwell project.
+ *
+ * This command scaffolds a new project with the necessary configuration
+ * and example files. It does not require Bun to run.
+ */
+export declare function runInit(args: string[]): Promise<void>;
+//# sourceMappingURL=init-command.d.ts.map

package/dist/cli/init-command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init-command.d.ts","sourceRoot":"","sources":["../../src/cli/init-command.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAkHH,wBAAsB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAkD3D"}

package/dist/cli/init-command.js

@@ -0,0 +1,149 @@
+/**
+ * CLI command for initializing a new thinkwell project.
+ *
+ * This command scaffolds a new project with the necessary configuration
+ * and example files. It does not require Bun to run.
+ */
+import { existsSync, mkdirSync, writeFileSync } from "node:fs";
+import { basename, join, resolve } from "node:path";
+const PACKAGE_JSON_TEMPLATE = (name) => `{
+  "name": "${name}",
+  "version": "0.1.0",
+  "type": "module",
+  "scripts": {
+    "start": "thinkwell src/main.ts",
+    "types": "thinkwell types src"
+  },
+  "dependencies": {
+    "thinkwell": "^0.2.0"
+  }
+}
+`;
+const MAIN_TS_TEMPLATE = `import { Agent } from "thinkwell:agent";
+
+/**
+ * A greeting response from the agent.
+ * @JSONSchema
+ */
+export interface Greeting {
+  message: string;
+}
+
+async function main() {
+  // Connect to an agent (configure THINKWELL_AGENT_CMD in your environment)
+  const agent = await Agent.connect(process.env.THINKWELL_AGENT_CMD!);
+
+  // Ask the agent to generate a structured greeting
+  const greeting = await agent
+    .think(Greeting)
+    .text("Say hello and introduce yourself briefly.")
+    .run();
+
+  console.log(greeting.message);
+}
+
+main().catch(console.error);
+`;
+const TSCONFIG_TEMPLATE = `{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "declaration": true,
+    "outDir": "./dist"
+  },
+  "include": ["src/**/*"]
+}
+`;
+const GITIGNORE_TEMPLATE = `node_modules/
+dist/
+*.thinkwell.d.ts
+.env
+`;
+const ENV_EXAMPLE_TEMPLATE = `# Configure your agent command
+# Example for Claude Code:
+# THINKWELL_AGENT_CMD=claude --dangerously-skip-permissions
+`;
+function createProject(options) {
+    const { name, targetDir } = options;
+    // Create directories
+    mkdirSync(targetDir, { recursive: true });
+    mkdirSync(join(targetDir, "src"), { recursive: true });
+    // Write files
+    writeFileSync(join(targetDir, "package.json"), PACKAGE_JSON_TEMPLATE(name));
+    writeFileSync(join(targetDir, "src/main.ts"), MAIN_TS_TEMPLATE);
+    writeFileSync(join(targetDir, "tsconfig.json"), TSCONFIG_TEMPLATE);
+    writeFileSync(join(targetDir, ".gitignore"), GITIGNORE_TEMPLATE);
+    writeFileSync(join(targetDir, ".env.example"), ENV_EXAMPLE_TEMPLATE);
+}
+function showHelp() {
+    console.log(`
+thinkwell init - Initialize a new thinkwell project
+
+Usage:
+  thinkwell init [project-name]
+
+Arguments:
+  project-name    Name of the project directory (default: current directory)
+
+Examples:
+  thinkwell init my-agent      Create a new project in ./my-agent
+  thinkwell init               Initialize in the current directory
+
+This command creates:
+  - package.json with thinkwell dependency
+  - tsconfig.json for TypeScript
+  - src/main.ts with example agent code
+  - .gitignore
+  - .env.example
+`);
+}
+export async function runInit(args) {
+    // Check for help flag
+    if (args.includes("--help") || args.includes("-h")) {
+        showHelp();
+        return;
+    }
+    // Get project name from args or use current directory
+    const projectArg = args.find((arg) => !arg.startsWith("-"));
+    const targetDir = projectArg ? resolve(projectArg) : process.cwd();
+    const name = projectArg || basename(process.cwd());
+    // Check if directory exists and is not empty
+    if (existsSync(targetDir)) {
+        const files = ["package.json", "tsconfig.json", "src/main.ts"];
+        const existingFiles = files.filter((f) => existsSync(join(targetDir, f)));
+        if (existingFiles.length > 0) {
+            console.error(`Error: Directory already contains project files:`);
+            for (const file of existingFiles) {
+                console.error(`  - ${file}`);
+            }
+            console.error("");
+            console.error("Use a different directory or remove existing files.");
+            process.exit(1);
+        }
+    }
+    console.log(`Creating thinkwell project in ${targetDir}...`);
+    console.log("");
+    createProject({ name, targetDir });
+    console.log("Created files:");
+    console.log("  - package.json");
+    console.log("  - tsconfig.json");
+    console.log("  - src/main.ts");
+    console.log("  - .gitignore");
+    console.log("  - .env.example");
+    console.log("");
+    console.log("Next steps:");
+    console.log("");
+    if (projectArg) {
+        console.log(`  cd ${projectArg}`);
+    }
+    console.log("  npm install        # or: bun install");
+    console.log("  cp .env.example .env");
+    console.log("  # Edit .env to configure your agent");
+    console.log("  thinkwell src/main.ts");
+    console.log("");
+}
+//# sourceMappingURL=init-command.js.map

package/dist/cli/init-command.js.map

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

package/dist/cli/main.d.ts

@@ -0,0 +1,14 @@
+#!/usr/bin/env bun
+/**
+ * Thinkwell CLI - Bun-native entry point for compiled binary.
+ *
+ * This is the main entry point for the self-contained Bun-compiled binary.
+ * Unlike the Node.js launcher (bin/thinkwell), this runs directly in Bun
+ * and can be compiled with `bun build --compile`.
+ *
+ * The bun-plugin is imported at the top level, which registers it with Bun's
+ * plugin system. This means any TypeScript files loaded after this point
+ * will automatically have @JSONSchema types processed.
+ */
+export {};
+//# sourceMappingURL=main.d.ts.map

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

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

package/dist/cli/main.js

@@ -0,0 +1,231 @@
+#!/usr/bin/env bun
+/**
+ * Thinkwell CLI - Bun-native entry point for compiled binary.
+ *
+ * This is the main entry point for the self-contained Bun-compiled binary.
+ * Unlike the Node.js launcher (bin/thinkwell), this runs directly in Bun
+ * and can be compiled with `bun build --compile`.
+ *
+ * The bun-plugin is imported at the top level, which registers it with Bun's
+ * plugin system. This means any TypeScript files loaded after this point
+ * will automatically have @JSONSchema types processed.
+ */
+import { existsSync } from "node:fs";
+import { resolve, isAbsolute } from "node:path";
+import { pathToFileURL } from "node:url";
+// Import the bun-plugin - this registers it with Bun's plugin system.
+// The plugin will intercept all .ts/.tsx file loads and process @JSONSchema types.
+import { registerModule } from "@thinkwell/bun-plugin";
+// Import thinkwell packages so they get bundled into the compiled binary.
+// These are registered as virtual modules so user scripts can import from them.
+import * as thinkwell from "thinkwell";
+import * as thinkwellAcp from "@thinkwell/acp";
+import * as thinkwellProtocol from "@thinkwell/protocol";
+// Register modules for virtual resolution in compiled binary.
+// This enables user scripts to import from "thinkwell:agent" etc.
+registerModule("thinkwell", thinkwell);
+registerModule("@thinkwell/acp", thinkwellAcp);
+registerModule("@thinkwell/protocol", thinkwellProtocol);
+import { runInit } from "./init-command.js";
+// Get version from package.json at build time
+const VERSION = "0.3.0-alpha.2"; // Will be replaced by build script
+function showHelp() {
+    console.log(`
+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 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
+  thinkwell --help                    Show this help message
+  thinkwell --version                 Show version
+
+Examples:
+  thinkwell hello.ts                 Run hello.ts
+  thinkwell run hello.ts --verbose   Run with arguments
+  thinkwell init my-agent            Create a new project
+  ./script.ts                        Via shebang: #!/usr/bin/env thinkwell
+  thinkwell types                    Generate declarations in current dir
+  thinkwell types src                Generate declarations in src/
+  thinkwell types --watch            Watch for changes and regenerate
+
+The thinkwell CLI automatically:
+  - Generates JSON Schema for types marked with @JSONSchema
+  - Resolves thinkwell:* imports to built-in modules
+  - Creates .thinkwell.d.ts files for IDE autocomplete (types command)
+
+For more information, visit: https://github.com/dherman/thinkwell
+`);
+}
+async function runTypes(args) {
+    // Import the types command implementation from the bundled bun-plugin
+    const { generateDeclarations, watchDeclarations } = await import("@thinkwell/bun-plugin");
+    const watchMode = args.includes("--watch") || args.includes("-w");
+    const dirArg = args.find((arg) => !arg.startsWith("-"));
+    const rootDir = dirArg ? resolve(dirArg) : process.cwd();
+    // Validate directory exists
+    if (!existsSync(rootDir)) {
+        console.error(`Error: Directory not found: ${rootDir}`);
+        process.exit(1);
+    }
+    const formatError = (error, sourceFile) => {
+        const lines = [`Error processing: ${sourceFile}`, `  ${error.message}`];
+        if (process.env.DEBUG) {
+            lines.push(`  Stack: ${error.stack?.split("\n").slice(1, 3).join("\n  ")}`);
+        }
+        return lines.join("\n");
+    };
+    if (watchMode) {
+        console.log(`Watching for changes in ${rootDir}...`);
+        console.log("Press Ctrl+C to stop.\n");
+        const watcher = watchDeclarations({
+            rootDir,
+            onWrite: (_source, decl) => {
+                console.log(`✓ ${decl}`);
+            },
+            onRemove: (_source, decl) => {
+                console.log(`✗ ${decl} (removed)`);
+            },
+            onError: (error, source) => {
+                console.error(formatError(error, source));
+            },
+        });
+        // Initial generation
+        console.log("Generating initial declarations...\n");
+        await generateDeclarations({
+            rootDir,
+            onWrite: (_source, decl) => {
+                console.log(`✓ ${decl}`);
+            },
+            onError: (error, source) => {
+                console.error(formatError(error, source));
+            },
+        });
+        console.log("\nWatching for changes...\n");
+        // Keep process alive
+        process.on("SIGINT", () => {
+            watcher.stop();
+            console.log("\nStopped watching.");
+            process.exit(0);
+        });
+        // Prevent the process from exiting
+        await new Promise(() => { });
+    }
+    else {
+        console.log(`Generating declarations in ${rootDir}...\n`);
+        let errorCount = 0;
+        const generated = await generateDeclarations({
+            rootDir,
+            onWrite: (_source, decl) => {
+                console.log(`✓ ${decl}`);
+            },
+            onError: (error, source) => {
+                errorCount++;
+                console.error(formatError(error, source));
+            },
+        });
+        if (generated.length === 0 && errorCount === 0) {
+            console.log("No @JSONSchema types found.");
+            console.log("");
+            console.log("To mark a type for schema generation, add the @JSONSchema JSDoc tag:");
+            console.log("");
+            console.log("  /** @JSONSchema */");
+            console.log("  interface MyType {");
+            console.log("    name: string;");
+            console.log("  }");
+        }
+        else {
+            console.log(`\nGenerated ${generated.length} declaration file(s).`);
+            if (errorCount > 0) {
+                console.log(`Encountered ${errorCount} error(s).`);
+                process.exit(1);
+            }
+        }
+    }
+}
+async function runScript(args) {
+    const scriptPath = args[0];
+    // Resolve the script path
+    const resolvedPath = isAbsolute(scriptPath)
+        ? scriptPath
+        : resolve(process.cwd(), scriptPath);
+    // Check if the script file exists
+    if (!existsSync(resolvedPath)) {
+        console.error(`Error: Script not found: ${scriptPath}`);
+        console.error("");
+        console.error("Make sure the file exists and the path is correct.");
+        process.exit(1);
+    }
+    // Set up process.argv for the script
+    // The script should see: [bun, script.ts, ...args]
+    const originalArgv = process.argv;
+    process.argv = [process.argv[0], resolvedPath, ...args.slice(1)];
+    try {
+        // Dynamically import the script.
+        // Because the bun-plugin is registered, it will intercept this import
+        // and process any @JSONSchema types in the file.
+        const scriptUrl = pathToFileURL(resolvedPath).href;
+        await import(scriptUrl);
+    }
+    catch (error) {
+        // Restore argv before handling error
+        process.argv = originalArgv;
+        if (error instanceof Error) {
+            // Check if it's a module not found error for thinkwell packages
+            if (error.message.includes("Cannot find module") ||
+                error.message.includes("Cannot find package")) {
+                console.error(`Error: ${error.message}`);
+                console.error("");
+                console.error("If your script uses thinkwell:* imports, make sure to use");
+                console.error("the import syntax like: import { Agent } from 'thinkwell:agent'");
+                process.exit(1);
+            }
+            throw error;
+        }
+        throw error;
+    }
+}
+async function main() {
+    const args = process.argv.slice(2);
+    // Handle "init" subcommand first - does NOT require schema plugin
+    if (args[0] === "init") {
+        await runInit(args.slice(1));
+        process.exit(0);
+    }
+    // Handle --help (global)
+    if (args.includes("--help") || args.includes("-h") || args.length === 0) {
+        showHelp();
+        process.exit(0);
+    }
+    // Handle --version
+    if (args.includes("--version") || args.includes("-v")) {
+        console.log(`thinkwell ${VERSION}`);
+        process.exit(0);
+    }
+    // Handle "types" subcommand
+    if (args[0] === "types") {
+        await runTypes(args.slice(1));
+        process.exit(0);
+    }
+    // Handle "run" subcommand - just strip it
+    const runArgs = args[0] === "run" ? args.slice(1) : args;
+    // If no script provided after "run", show help
+    if (runArgs.length === 0) {
+        console.error("Error: No script provided.");
+        console.error("");
+        console.error("Usage: thinkwell run <script.ts> [args...]");
+        process.exit(1);
+    }
+    await runScript(runArgs);
+}
+main().catch((error) => {
+    console.error("Unexpected error:");
+    console.error(`  ${error.message || error}`);
+    if (process.env.DEBUG) {
+        console.error(error.stack);
+    }
+    process.exit(1);
+});
+//# sourceMappingURL=main.js.map

package/dist/cli/main.js.map

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

package/dist/cli/types-command.d.ts

@@ -0,0 +1,8 @@
+/**
+ * CLI command for generating declaration files.
+ *
+ * This script is invoked by the thinkwell CLI when the user runs
+ * `thinkwell types` or `thinkwell types --watch`.
+ */
+export {};
+//# sourceMappingURL=types-command.d.ts.map

package/dist/cli/types-command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types-command.d.ts","sourceRoot":"","sources":["../../src/cli/types-command.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/cli/types-command.js

@@ -0,0 +1,110 @@
+/**
+ * CLI command for generating declaration files.
+ *
+ * This script is invoked by the thinkwell CLI when the user runs
+ * `thinkwell types` or `thinkwell types --watch`.
+ */
+import { existsSync } from "node:fs";
+import { resolve } from "node:path";
+import { generateDeclarations, watchDeclarations, } from "@thinkwell/bun-plugin";
+/**
+ * Format an error for console output.
+ */
+function formatError(error, sourceFile) {
+    const lines = [
+        `Error processing: ${sourceFile}`,
+        `  ${error.message}`,
+    ];
+    // Add stack trace hint for debugging
+    if (process.env.DEBUG) {
+        lines.push(`  Stack: ${error.stack?.split("\n").slice(1, 3).join("\n  ")}`);
+    }
+    return lines.join("\n");
+}
+async function main() {
+    const args = process.argv.slice(2);
+    const watchMode = args.includes("--watch") || args.includes("-w");
+    const dirArg = args.find((arg) => !arg.startsWith("-"));
+    const rootDir = dirArg ? resolve(dirArg) : process.cwd();
+    // Validate directory exists
+    if (!existsSync(rootDir)) {
+        console.error(`Error: Directory not found: ${rootDir}`);
+        process.exit(1);
+    }
+    if (watchMode) {
+        console.log(`Watching for changes in ${rootDir}...`);
+        console.log("Press Ctrl+C to stop.\n");
+        const watcher = watchDeclarations({
+            rootDir,
+            onWrite: (source, decl) => {
+                console.log(`✓ ${decl}`);
+            },
+            onRemove: (source, decl) => {
+                console.log(`✗ ${decl} (removed)`);
+            },
+            onError: (error, source) => {
+                console.error(formatError(error, source));
+            },
+        });
+        // Initial generation
+        console.log("Generating initial declarations...\n");
+        await generateDeclarations({
+            rootDir,
+            onWrite: (source, decl) => {
+                console.log(`✓ ${decl}`);
+            },
+            onError: (error, source) => {
+                console.error(formatError(error, source));
+            },
+        });
+        console.log("\nWatching for changes...\n");
+        // Keep process alive
+        process.on("SIGINT", () => {
+            watcher.stop();
+            console.log("\nStopped watching.");
+            process.exit(0);
+        });
+        // Prevent the process from exiting
+        await new Promise(() => { });
+    }
+    else {
+        console.log(`Generating declarations in ${rootDir}...\n`);
+        let errorCount = 0;
+        const generated = await generateDeclarations({
+            rootDir,
+            onWrite: (source, decl) => {
+                console.log(`✓ ${decl}`);
+            },
+            onError: (error, source) => {
+                errorCount++;
+                console.error(formatError(error, source));
+            },
+        });
+        if (generated.length === 0 && errorCount === 0) {
+            console.log("No @JSONSchema types found.");
+            console.log("");
+            console.log("To mark a type for schema generation, add the @JSONSchema JSDoc tag:");
+            console.log("");
+            console.log("  /** @JSONSchema */");
+            console.log("  interface MyType {");
+            console.log("    name: string;");
+            console.log("  }");
+        }
+        else {
+            console.log(`\nGenerated ${generated.length} declaration file(s).`);
+            if (errorCount > 0) {
+                console.log(`Encountered ${errorCount} error(s).`);
+                process.exit(1);
+            }
+        }
+    }
+}
+main().catch((error) => {
+    console.error("Unexpected error:");
+    console.error(`  ${error.message || error}`);
+    if (process.env.DEBUG) {
+        console.error(error.stack);
+    }
+    process.exit(1);
+});
+//# sourceMappingURL=types-command.js.map

package/dist/cli/types-command.js.map

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

package/dist/index.d.ts

@@ -4,4 +4,5 @@ export { Session } from "./session.js";
 export { ThinkBuilder } from "./think-builder.js";
 export { schemaOf } from "./schema.js";
 export type { JsonSchema, SchemaProvider, JsonValue, JsonObject } from "@thinkwell/acp";
+export * from "./connectors/index.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACjE,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAGvC,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGlD,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAGvC,YAAY,EAAE,UAAU,EAAE,cAAc,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACjE,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAGvC,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGlD,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAGvC,YAAY,EAAE,UAAU,EAAE,cAAc,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAGxF,cAAc,uBAAuB,CAAC"}

package/dist/index.js

@@ -5,4 +5,6 @@ export { Session } from "./session.js";
 export { ThinkBuilder } from "./think-builder.js";
 // Schema helpers
 export { schemaOf } from "./schema.js";
+// Re-export connectors for convenient single-package import
+export * from "./connectors/index.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,UAAU;AACV,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAEnC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC,gBAAgB;AAChB,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,iBAAiB;AACjB,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,UAAU;AACV,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAEnC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC,gBAAgB;AAChB,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,iBAAiB;AACjB,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAKvC,4DAA4D;AAC5D,cAAc,uBAAuB,CAAC"}

package/package.json

@@ -1,10 +1,13 @@
 {
   "name": "thinkwell",
-  "version": "0.2.0",
+  "version": "0.3.0-alpha.2",
   "description": "TypeScript library for blending deterministic code with LLM-powered reasoning",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
+  "bin": {
+    "thinkwell": "./bin/thinkwell"
+  },
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
@@ -15,7 +18,11 @@
       "import": "./dist/connectors/index.js"
     }
   },
+  "engines": {
+    "node": ">=18"
+  },
   "files": [
+    "bin",
     "dist"
   ],
   "keywords": [
@@ -28,8 +35,10 @@
   "license": "MIT",
   "dependencies": {
     "@agentclientprotocol/sdk": "^0.12.0",
-    "@thinkwell/acp": "0.2.0",
-    "@thinkwell/conductor": "0.2.0"
+    "@thinkwell/acp": "0.3.0-alpha.2",
+    "@thinkwell/bun-plugin": "0.3.0-alpha.2",
+    "@thinkwell/protocol": "0.3.0-alpha.2",
+    "@thinkwell/conductor": "0.3.0-alpha.2"
   },
   "devDependencies": {
     "@types/node": "^24.10.4",
@@ -38,7 +47,8 @@
   },
   "scripts": {
     "build": "tsc",
-    "clean": "rm -rf dist",
+    "build:binary": "bun scripts/build-binary.ts",
+    "clean": "rm -rf dist dist-bin",
     "test": "node --test --import tsx src/**/*.test.ts"
   }
 }