@project-ajax/sdk 0.0.36 → 0.0.47

package/src/cli/commands/auth.ts

@@ -31,7 +31,6 @@ export const authCommands = buildRouteMap({
 						values: Environments,
 						brief: "The environment to use for the command",
 						optional: true,
-						hidden: true,
 					},
 					"base-url": {
 						kind: "parsed",

package/src/cli/commands/connect.impl.ts

@@ -2,7 +2,7 @@ import type { ApiError } from "../api/client.js";
 import { Result } from "../api/result.js";
 import type { FormatFlags, GlobalFlags } from "../flags.js";
 import { type AuthedContext, buildAuthedHandler } from "../handler.js";
-import { openNotionUrl } from "../utils/openNotionUrl.js";
+import { openBrowserUrl } from "../utils/openUrl.js";
 
 export const listProviders = buildAuthedHandler(async function (
 	flags: FormatFlags,
@@ -52,7 +52,7 @@ export const addConnection = buildAuthedHandler(async function (
 
 	this.writer.writeErr("Opening your browser to continue the OAuth flow...");
 	try {
-		await openNotionUrl(this.config.environment ?? "prod", authorizationUrl);
+		await openBrowserUrl(authorizationUrl);
 	} catch (error) {
 		this.writer.writeErr(
 			`Unable to open the browser automatically (${String(

package/src/cli/handler.ts

@@ -24,8 +24,13 @@ export function buildHandler<const FLAGS, const ARGS extends BaseArgs = []>(
 		flags: GlobalFlags & FLAGS,
 		...args: ARGS
 	) {
+		const configFilePath =
+			this.process.env.WORKERS_CONFIG_FILE_PATH ??
+			flags.config ??
+			"./workers.json";
+
 		const config = await Config.load({
-			configFilePath: flags.config ?? "./workers.json",
+			configFilePath,
 			processEnv: process.env,
 		});
 

package/src/cli/routes.ts

@@ -13,6 +13,20 @@ import { TokenNotSetError } from "./config.js";
 const routes = buildRouteMap({
 	docs: {
 		brief: "A CLI for the Project Ajax platform",
+		fullDescription: `
+The Project Ajax CLI is a tool for managing workers, which run code written by
+you, other developers, or AI agents to perform automation tasks, such as syncing
+data, adding slash commands, or performing other actions.
+
+Most flags are configured either with a config file or flags, but environment
+variables can also be provided:
+
+- WORKERS_CONFIG_FILE_PATH: The path to the config file to use (e.g. ./workers.dev.json)
+- WORKERS_TOKEN: The token to use for authentication
+- WORKERS_ENVIRONMENT: The environment to use
+- WORKERS_WORKER_ID: The worker ID to use
+- WORKERS_BASE_URL: The base API URL to use
+`.trim(),
 	},
 	routes: {
 		auth: authCommands,

package/src/cli/utils/{openNotionUrl.ts → openUrl.ts}

@@ -3,20 +3,12 @@ import { existsSync } from "node:fs";
 
 import type { Environment } from "../config.js";
 
-export async function openNotionUrl(
-	env: Environment,
-	url: string,
-): Promise<void> {
+export async function openBrowserUrl(url: string): Promise<void> {
 	const platform = process.platform;
 
 	try {
 		if (platform === "darwin") {
-			const appName = preferredNotionApp(env);
-			if (appName) {
-				exec(`open -a "${appName}" "${url}"`);
-			} else {
-				exec(`open "${url}"`);
-			}
+			exec(`open "${url}"`);
 		} else if (platform === "win32") {
 			exec(`start "" "${url}"`);
 		} else {
@@ -27,6 +19,27 @@ export async function openNotionUrl(
 	}
 }
 
+export async function openNotionUrl(
+	env: Environment,
+	url: string,
+): Promise<void> {
+	const platform = process.platform;
+
+	if (platform === "darwin") {
+		const appName = preferredNotionApp(env);
+		if (appName) {
+			try {
+				exec(`open -a "${appName}" "${url}"`);
+				return;
+			} catch {
+				// Fall back to the default browser below.
+			}
+		}
+	}
+
+	await openBrowserUrl(url);
+}
+
 function preferredNotionApp(env: Environment): string | null {
 	if (env === "prod" && existsSync("/Applications/Notion.app")) {
 		return "Notion";