Skip to content

Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.

chore(cli): add shebangs and top-level doc comments to build scripts

jkomyno0f44283533be
diff --git a/ts/packages/cli/scripts/build-all-binaries.ts b/ts/packages/cli/scripts/build-all-binaries.ts
index fd35b82f8..8cb9c13d7 100644
--- a/ts/packages/cli/scripts/build-all-binaries.ts
+++ b/ts/packages/cli/scripts/build-all-binaries.ts
@@ -1,3 +1,17 @@
+#!/usr/bin/env bun
+
+/**
+ * Build all platform binaries via Bun cross-compilation.
+ *
+ * Usage: `bun scripts/build-all-binaries.ts`
+ *
+ * Builds all 4 targets sequentially:
+ * composio-darwin-aarch64, composio-darwin-x64,
+ * composio-linux-x64, composio-linux-aarch64
+ *
+ * Output: `dist/binaries/composio-*`
+ */
+
import process from 'node:process';
import {
Cause,
@@ -71,12 +85,6 @@ function runBunBuild(target: string, outfile: string) {
});
}
-/**
- * Build all platform binaries via cross-compilation.
- *
- * Usage: `bun scripts/build-all-binaries.ts`
- * Output: `dist/binaries/composio-{darwin-aarch64,darwin-x64,linux-x64,linux-aarch64}`
- */
export function buildAllBinaries() {
return Effect.gen(function* () {
yield* Console.log(`Building ${TARGETS.length} platform binaries...`);
diff --git a/ts/packages/cli/scripts/build-binary-cross.ts b/ts/packages/cli/scripts/build-binary-cross.ts
index a40cea37b..30f2f297d 100644
--- a/ts/packages/cli/scripts/build-binary-cross.ts
+++ b/ts/packages/cli/scripts/build-binary-cross.ts
@@ -1,3 +1,19 @@
+#!/usr/bin/env bun
+
+/**
+ * Cross-compile a CLI binary for a specific Bun target.
+ *
+ * Usage: `bun scripts/build-binary-cross.ts --target <target>`
+ *
+ * Valid targets:
+ * bun-darwin-arm64 → composio-darwin-aarch64
+ * bun-darwin-x64 → composio-darwin-x64
+ * bun-linux-x64 → composio-linux-x64
+ * bun-linux-arm64 → composio-linux-aarch64
+ *
+ * Output: `dist/binaries/<artifact-name>`
+ */
+
import process from 'node:process';
import {
Cause,
@@ -46,12 +62,6 @@ function parseTarget(): { target: string; artifact: string } {
return { target, artifact };
}
-/**
- * Cross-compile a CLI binary for a specific Bun target.
- *
- * Usage: `bun scripts/build-binary-cross.ts --target bun-darwin-arm64`
- * Output: `dist/binaries/composio-darwin-aarch64`
- */
export function buildBinaryCross() {
const { target, artifact } = parseTarget();
diff --git a/ts/packages/cli/scripts/generate-checksums.ts b/ts/packages/cli/scripts/generate-checksums.ts
index 9326d9a3e..6bab41c43 100644
--- a/ts/packages/cli/scripts/generate-checksums.ts
+++ b/ts/packages/cli/scripts/generate-checksums.ts
@@ -1,3 +1,19 @@
+#!/usr/bin/env bun
+
+/**
+ * Generate `checksums.txt` from all `.zip` files in `dist/binaries/`.
+ *
+ * Usage: `bun scripts/generate-checksums.ts`
+ *
+ * Output format (sha256sum-compatible):
+ * <sha256hex> composio-darwin-aarch64.zip
+ * <sha256hex> composio-darwin-x64.zip
+ * <sha256hex> composio-linux-x64.zip
+ * <sha256hex> composio-linux-aarch64.zip
+ *
+ * Output: `dist/binaries/checksums.txt`
+ */
+
import process from 'node:process';
import {
Cause,
@@ -17,14 +33,6 @@ import path from 'node:path';
const BINARIES_DIR = './dist/binaries';
-/**
- * Generate checksums.txt from all .zip files in dist/binaries/.
- *
- * Output format (sha256sum compatible):
- * <sha256hex> <filename>
- *
- * Usage: `bun scripts/generate-checksums.ts`
- */
export function generateChecksums() {
return Effect.gen(function* () {
const entries = yield* Effect.tryPromise(() => readdir(BINARIES_DIR));
diff --git a/ts/packages/cli/scripts/package-binaries.ts b/ts/packages/cli/scripts/package-binaries.ts
index ad7e9df20..0bf2c9a16 100644
--- a/ts/packages/cli/scripts/package-binaries.ts
+++ b/ts/packages/cli/scripts/package-binaries.ts
@@ -1,3 +1,19 @@
+#!/usr/bin/env bun
+
+/**
+ * Package each raw binary in `dist/binaries/` into a `.zip` archive.
+ *
+ * Usage: `bun scripts/package-binaries.ts`
+ *
+ * Creates a nested directory structure inside each zip:
+ * composio-<target>/composio
+ *
+ * This matches the structure expected by `install.sh`.
+ *
+ * Input: `dist/binaries/composio-{platform-arch}` (raw binaries)
+ * Output: `dist/binaries/composio-{platform-arch}.zip`
+ */
+
import process from 'node:process';
import {
Cause,
@@ -28,16 +44,6 @@ const ARTIFACT_NAMES = [
'composio-linux-aarch64',
];
-/**
- * Package each raw binary in dist/binaries/ into a .zip archive.
- *
- * Creates a nested directory structure inside the zip:
- * composio-<target>/composio
- *
- * This matches the structure expected by install.sh.
- *
- * Usage: `bun scripts/package-binaries.ts`
- */
export function packageBinaries() {
return Effect.gen(function* () {
const entries = yield* Effect.tryPromise(() => readdir(BINARIES_DIR));