@project-ajax/sdk 0.0.35 → 0.0.37

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AAC9D,OAAO,EAAE,IAAI,EAAE,MAAM,wBAAwB,CAAC;AAC9C,OAAO,EAAE,IAAI,EAAE,MAAM,wBAAwB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AAC9D,OAAO,EAAE,IAAI,EAAE,MAAM,wBAAwB,CAAC;AAC9C,OAAO,EAAE,IAAI,EAAE,MAAM,wBAAwB,CAAC;AAC9C,YAAY,EAAE,IAAI,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -1,7 +1,10 @@
+import { emojiIcon, notionIcon } from "./builder.js";
 import { slashCommand } from "./capabilities/slashCommand.js";
 import { sync } from "./capabilities/sync.js";
 import { tool } from "./capabilities/tool.js";
 export {
+  emojiIcon,
+  notionIcon,
   slashCommand,
   sync,
   tool

package/dist/schema.d.ts

@@ -1,4 +1,4 @@
-import type { DateFormat, NumberFormat, SelectOption, StatusGroup } from "./types.js";
+import type { DateFormat, Icon, NumberFormat, SelectOption, StatusGroup } from "./types.js";
 /**
  * Supported property types for sync schemas.
  */
@@ -44,6 +44,12 @@ export type PropertyConfiguration = {
 };
 export type Schema<PK extends string> = {
     dataSourceTitle: string;
+    /**
+     * Optional icon to use as the icon for the database page.
+     * If not provided, defaults to 📋.
+     * Use the `icon()` builder to create an icon value.
+     */
+    databaseIcon?: Icon;
     properties: PropertySchema<PK>;
 };
 /**

package/dist/schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,UAAU,EACV,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,MAAM,YAAY,CAAC;AAEpB;;GAEG;AACH,MAAM,MAAM,YAAY,GACrB,OAAO,GACP,WAAW,GACX,KAAK,GACL,OAAO,GACP,cAAc,GACd,UAAU,GACV,MAAM,GACN,QAAQ,GACR,MAAM,GACN,QAAQ,GACR,cAAc,GACd,QAAQ,CAAC;AAEZ;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAChC,IAAI,EAAE,YAAY,CAAC;CACnB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAC9B;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,GACjB;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAChB;IAAE,IAAI,EAAE,KAAK,CAAA;CAAE,GACf;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,GACjB;IAAE,IAAI,EAAE,cAAc,CAAA;CAAE,GACxB;IAAE,IAAI,EAAE,UAAU,CAAA;CAAE,GACpB;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAChB;IACA,IAAI,EAAE,QAAQ,CAAC;IACf,MAAM,CAAC,EAAE,YAAY,CAAC;CACrB,GACD;IACA,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,UAAU,CAAC;CACxB,GACD;IACA,IAAI,EAAE,QAAQ,CAAC;IACf,OAAO,EAAE,YAAY,EAAE,CAAC;CACvB,GACD;IACA,IAAI,EAAE,cAAc,CAAC;IACrB,OAAO,EAAE,YAAY,EAAE,CAAC;CACvB,GACD;IACA,IAAI,EAAE,QAAQ,CAAC;IACf,MAAM,EAAE,WAAW,EAAE,CAAC;CACrB,CAAC;AAEL,MAAM,MAAM,MAAM,CAAC,EAAE,SAAS,MAAM,IAAI;IACvC,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,cAAc,CAAC,EAAE,CAAC,CAAC;CAC/B,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,cAAc,CAAC,EAAE,SAAS,MAAM,IAAI;KAC9C,UAAU,IAAI,EAAE,GAAG,qBAAqB;CACzC,GAAG;IACH,CAAC,YAAY,EAAE,MAAM,GAAG,qBAAqB,CAAC;CAC9C,CAAC;AAEF;;GAEG;AACH,wBAAgB,KAAK,IAAI,qBAAqB,CAE7C;AAED;;GAEG;AACH,wBAAgB,QAAQ,IAAI,qBAAqB,CAEhD;AAED;;GAEG;AACH,wBAAgB,GAAG,IAAI,qBAAqB,CAE3C;AAED;;GAEG;AACH,wBAAgB,KAAK,IAAI,qBAAqB,CAE7C;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,qBAAqB,CAEnD;AAED;;GAEG;AACH,wBAAgB,QAAQ,IAAI,qBAAqB,CAEhD;AAED;;GAEG;AACH,wBAAgB,IAAI,IAAI,qBAAqB,CAE5C;AAED;;GAEG;AACH,wBAAgB,MAAM,CAAC,MAAM,CAAC,EAAE,YAAY,GAAG,qBAAqB,CAEnE;AAED;;GAEG;AACH,wBAAgB,IAAI,CAAC,WAAW,CAAC,EAAE,UAAU,GAAG,qBAAqB,CAEpE;AAED;;GAEG;AACH,wBAAgB,MAAM,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,qBAAqB,CAErE;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,qBAAqB,CAE1E;AAED;;GAEG;AACH,wBAAgB,MAAM,CAAC,MAAM,EAAE;IAC9B,MAAM,EAAE,WAAW,EAAE,CAAC;CACtB,GAAG,qBAAqB,CAExB"}
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,UAAU,EACV,IAAI,EACJ,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,MAAM,YAAY,CAAC;AAEpB;;GAEG;AACH,MAAM,MAAM,YAAY,GACrB,OAAO,GACP,WAAW,GACX,KAAK,GACL,OAAO,GACP,cAAc,GACd,UAAU,GACV,MAAM,GACN,QAAQ,GACR,MAAM,GACN,QAAQ,GACR,cAAc,GACd,QAAQ,CAAC;AAEZ;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAChC,IAAI,EAAE,YAAY,CAAC;CACnB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAC9B;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,GACjB;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAChB;IAAE,IAAI,EAAE,KAAK,CAAA;CAAE,GACf;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,GACjB;IAAE,IAAI,EAAE,cAAc,CAAA;CAAE,GACxB;IAAE,IAAI,EAAE,UAAU,CAAA;CAAE,GACpB;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAChB;IACA,IAAI,EAAE,QAAQ,CAAC;IACf,MAAM,CAAC,EAAE,YAAY,CAAC;CACrB,GACD;IACA,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,UAAU,CAAC;CACxB,GACD;IACA,IAAI,EAAE,QAAQ,CAAC;IACf,OAAO,EAAE,YAAY,EAAE,CAAC;CACvB,GACD;IACA,IAAI,EAAE,cAAc,CAAC;IACrB,OAAO,EAAE,YAAY,EAAE,CAAC;CACvB,GACD;IACA,IAAI,EAAE,QAAQ,CAAC;IACf,MAAM,EAAE,WAAW,EAAE,CAAC;CACrB,CAAC;AAEL,MAAM,MAAM,MAAM,CAAC,EAAE,SAAS,MAAM,IAAI;IACvC,eAAe,EAAE,MAAM,CAAC;IACxB;;;;OAIG;IACH,YAAY,CAAC,EAAE,IAAI,CAAC;IACpB,UAAU,EAAE,cAAc,CAAC,EAAE,CAAC,CAAC;CAC/B,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,cAAc,CAAC,EAAE,SAAS,MAAM,IAAI;KAC9C,UAAU,IAAI,EAAE,GAAG,qBAAqB;CACzC,GAAG;IACH,CAAC,YAAY,EAAE,MAAM,GAAG,qBAAqB,CAAC;CAC9C,CAAC;AAEF;;GAEG;AACH,wBAAgB,KAAK,IAAI,qBAAqB,CAE7C;AAED;;GAEG;AACH,wBAAgB,QAAQ,IAAI,qBAAqB,CAEhD;AAED;;GAEG;AACH,wBAAgB,GAAG,IAAI,qBAAqB,CAE3C;AAED;;GAEG;AACH,wBAAgB,KAAK,IAAI,qBAAqB,CAE7C;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,qBAAqB,CAEnD;AAED;;GAEG;AACH,wBAAgB,QAAQ,IAAI,qBAAqB,CAEhD;AAED;;GAEG;AACH,wBAAgB,IAAI,IAAI,qBAAqB,CAE5C;AAED;;GAEG;AACH,wBAAgB,MAAM,CAAC,MAAM,CAAC,EAAE,YAAY,GAAG,qBAAqB,CAEnE;AAED;;GAEG;AACH,wBAAgB,IAAI,CAAC,WAAW,CAAC,EAAE,UAAU,GAAG,qBAAqB,CAEpE;AAED;;GAEG;AACH,wBAAgB,MAAM,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,qBAAqB,CAErE;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,qBAAqB,CAE1E;AAED;;GAEG;AACH,wBAAgB,MAAM,CAAC,MAAM,EAAE;IAC9B,MAAM,EAAE,WAAW,EAAE,CAAC;CACtB,GAAG,qBAAqB,CAExB"}

package/dist/types.d.ts

@@ -76,5 +76,35 @@ export type NumberFormat = "number" | "number_with_commas" | "percent" | "dollar
  * Date format types
  */
 export type DateFormat = "relative" | "MM/DD/YYYY" | "DD/MM/YYYY" | "YYYY/MM/DD" | "ll" | "MMM d";
-export {};
+import type { NoticonName } from "./icon-names.js";
+/**
+ * Icon representing an emoji
+ */
+export interface EmojiIcon {
+    type: "emoji";
+    value: string;
+}
+/**
+ * Valid colors for Notion icons
+ */
+export type NoticonColor = "gray" | "lightgray" | "brown" | "yellow" | "orange" | "green" | "blue" | "purple" | "pink" | "red";
+/**
+ * Icon representing a Notion built-in icon
+ */
+export interface NoticonIcon {
+    type: "notion";
+    /**
+     * The name of the Notion icon (e.g., "checkmark", "pizza", "rocket")
+     */
+    icon: NoticonName;
+    /**
+     * The color variant of the icon
+     */
+    color: NoticonColor;
+}
+/**
+ * All possible icon types
+ */
+export type Icon = EmojiIcon | NoticonIcon;
+export type { NoticonName } from "./icon-names.js";
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,KAAK,SAAS,GAAG,CAAC,MAAM,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;AAExC;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC;AAEzC;;GAEG;AACH,MAAM,MAAM,WAAW,GACpB,SAAS,GACT,MAAM,GACN,OAAO,GACP,QAAQ,GACR,QAAQ,GACR,OAAO,GACP,MAAM,GACN,QAAQ,GACR,MAAM,GACN,KAAK,CAAC;AAET;;GAEG;AACH,MAAM,WAAW,YAAY;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,WAAW,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,aAAa,GAAG,UAAU,CAAC;AAEnE;;GAEG;AACH,MAAM,WAAW,WAAW;IAC3B,IAAI,EAAE,eAAe,CAAC;IACtB,OAAO,EAAE,YAAY,EAAE,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC9B,IAAI,EAAE,UAAU,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACzB,IAAI,EAAE,WAAW,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC7B,IAAI,EAAE,eAAe,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,UAAU,GAAG,cAAc,GAAG,SAAS,GAAG,aAAa,CAAC;AAEhF;;GAEG;AACH,MAAM,MAAM,YAAY,GACrB,QAAQ,GACR,oBAAoB,GACpB,SAAS,GACT,QAAQ,GACR,MAAM,GACN,OAAO,GACP,KAAK,GACL,OAAO,GACP,KAAK,GACL,MAAM,CAAC;AAEV;;GAEG;AACH,MAAM,MAAM,UAAU,GACnB,UAAU,GACV,YAAY,GACZ,YAAY,GACZ,YAAY,GACZ,IAAI,GACJ,OAAO,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,KAAK,SAAS,GAAG,CAAC,MAAM,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;AAExC;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC;AAEzC;;GAEG;AACH,MAAM,MAAM,WAAW,GACpB,SAAS,GACT,MAAM,GACN,OAAO,GACP,QAAQ,GACR,QAAQ,GACR,OAAO,GACP,MAAM,GACN,QAAQ,GACR,MAAM,GACN,KAAK,CAAC;AAET;;GAEG;AACH,MAAM,WAAW,YAAY;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,WAAW,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,aAAa,GAAG,UAAU,CAAC;AAEnE;;GAEG;AACH,MAAM,WAAW,WAAW;IAC3B,IAAI,EAAE,eAAe,CAAC;IACtB,OAAO,EAAE,YAAY,EAAE,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC9B,IAAI,EAAE,UAAU,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACzB,IAAI,EAAE,WAAW,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC7B,IAAI,EAAE,eAAe,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,UAAU,GAAG,cAAc,GAAG,SAAS,GAAG,aAAa,CAAC;AAEhF;;GAEG;AACH,MAAM,MAAM,YAAY,GACrB,QAAQ,GACR,oBAAoB,GACpB,SAAS,GACT,QAAQ,GACR,MAAM,GACN,OAAO,GACP,KAAK,GACL,OAAO,GACP,KAAK,GACL,MAAM,CAAC;AAEV;;GAEG;AACH,MAAM,MAAM,UAAU,GACnB,UAAU,GACV,YAAY,GACZ,YAAY,GACZ,YAAY,GACZ,IAAI,GACJ,OAAO,CAAC;AAEX,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAEnD;;GAEG;AACH,MAAM,WAAW,SAAS;IACzB,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,MAAM,MAAM,YAAY,GACrB,MAAM,GACN,WAAW,GACX,OAAO,GACP,QAAQ,GACR,QAAQ,GACR,OAAO,GACP,MAAM,GACN,QAAQ,GACR,MAAM,GACN,KAAK,CAAC;AAET;;GAEG;AACH,MAAM,WAAW,WAAW;IAC3B,IAAI,EAAE,QAAQ,CAAC;IACf;;OAEG;IACH,IAAI,EAAE,WAAW,CAAC;IAClB;;OAEG;IACH,KAAK,EAAE,YAAY,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,MAAM,IAAI,GAAG,SAAS,GAAG,WAAW,CAAC;AAE3C,YAAY,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@project-ajax/sdk",
-	"version": "0.0.35",
+	"version": "0.0.37",
 	"description": "An SDK for building workers for the Project Ajax platform",
 	"license": "UNLICENSED",
 	"type": "module",

package/src/builder.ts

@@ -1,4 +1,5 @@
-import type { DateValue, TextValue } from "./types.js";
+import type { NoticonName } from "./icon-names.js";
+import type { DateValue, Icon, NoticonColor, TextValue } from "./types.js";
 
 /**
  * Creates a rich text value.
@@ -213,3 +214,30 @@ function formatTime(date: Date): string {
 	const minutes = String(date.getMinutes()).padStart(2, "0");
 	return `${hours}:${minutes}`;
 }
+
+/**
+ * Creates an emoji icon.
+ * @param emoji - An emoji string (e.g., "🎯", "✨", "🚀")
+ */
+export function emojiIcon(emoji: string): Icon {
+	return {
+		type: "emoji",
+		value: emoji,
+	};
+}
+
+/**
+ * Creates a Notion icon with a specific color.
+ * @param icon - The name of the Notion icon (e.g., "checkmark", "pizza", "rocket")
+ * @param color - The color variant (defaults to "gray")
+ */
+export function notionIcon(
+	icon: NoticonName,
+	color: NoticonColor = "gray",
+): Icon {
+	return {
+		type: "notion",
+		icon,
+		color,
+	};
+}

package/src/capabilities/sync.ts

@@ -1,6 +1,6 @@
 import { ExecutionError } from "../error.js";
 import type { PropertySchema, Schema } from "../schema.js";
-import type { TextValue } from "../types.js";
+import type { Icon, TextValue } from "../types.js";
 
 /**
  * An object representing a third-party record to be synced.
@@ -8,6 +8,11 @@ import type { TextValue } from "../types.js";
 export type SyncedObject<PK extends string, S extends PropertySchema<PK>> = {
 	key: string;
 	properties: { [Property in keyof S]: TextValue };
+	/**
+	 * Optional icon to use as the icon for this row's page.
+	 * Use the `icon()` builder to create an icon value.
+	 */
+	icon?: Icon;
 };
 
 /**

package/src/cli/api/client.ts

@@ -330,7 +330,10 @@ export class ApiClient {
 	/**
 	 * List all secrets for a worker (keys only, not values)
 	 */
-	async listSecrets(workerId: string): Promise<
+	async listSecrets(
+		workerId: string,
+		options?: { secretKinds?: Array<"keyValue" | "oauth"> },
+	): Promise<
 		Result<
 			{
 				secrets: Array<{
@@ -338,6 +341,7 @@ export class ApiClient {
 					workerId: string;
 					key: string;
 					createdAt: string;
+					kind: "keyValue" | "oauth";
 				}>;
 			},
 			ApiError
@@ -347,6 +351,61 @@ export class ApiClient {
 			method: "POST",
 			body: {
 				workerId,
+				secretKinds: options?.secretKinds,
+			},
+		});
+	}
+
+	async listOauthProviders(): Promise<
+		Result<
+			{
+				providers: Array<{
+					key: string;
+					displayName: string;
+				}>;
+			},
+			ApiError
+		>
+	> {
+		return this.fetch("/workersListOauthProviders", {
+			method: "POST",
+			body: {},
+		});
+	}
+
+	/**
+	 * Start the OAuth flow for a provider
+	 */
+	async startOauth(args: { workerId: string; provider: string }): Promise<
+		Result<
+			{
+				authorizationUrl: string;
+				state: string;
+			},
+			ApiError
+		>
+	> {
+		return this.fetch("/workersStartOauth", {
+			method: "POST",
+			body: {
+				workerId: args.workerId,
+				provider: args.provider,
+			},
+		});
+	}
+
+	/**
+	 * Remove an OAuth connection for a worker
+	 */
+	async deleteOauthConnection(args: {
+		workerId: string;
+		provider: string;
+	}): Promise<Result<Record<string, never>, ApiError>> {
+		return this.fetch("/workersDeleteOauthConnection", {
+			method: "POST",
+			body: {
+				workerId: args.workerId,
+				provider: args.provider,
 			},
 		});
 	}

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

@@ -1,49 +1,13 @@
-import { exec } from "node:child_process";
-import { existsSync } from "node:fs";
 import { baseUrl } from "../api/client.js";
 import type { Environment } from "../config.js";
 import { buildHandler, type HandlerContext } from "../handler.js";
+import { openNotionUrl } from "../utils/openNotionUrl.js";
 
 interface LoginFlags {
 	env?: Environment;
 	"base-url"?: string;
 }
 
-/**
- * Open a URL in the user's default browser or Notion app (if app available)
- */
-async function openUrl(env: Environment, url: string): Promise<void> {
-	const platform = process.platform;
-
-	try {
-		if (platform === "darwin") {
-			// Check if we should try to open Notion app on macOS
-			let notionAppName: string | null = null;
-
-			if (env === "prod" && existsSync("/Applications/Notion.app")) {
-				notionAppName = "Notion";
-			} else if (env === "dev" && existsSync("/Applications/Notion Dev.app")) {
-				notionAppName = "Notion Dev";
-			}
-
-			if (notionAppName) {
-				// Open the app first, then the URL (which will open in the app)
-				exec(`open -a "${notionAppName}" "${url}"`);
-			} else {
-				// Fall back to opening in default browser
-				exec(`open "${url}"`);
-			}
-		} else if (platform === "win32") {
-			exec(`start "" "${url}"`);
-		} else {
-			// Linux and other Unix-like systems
-			exec(`xdg-open "${url}"`);
-		}
-	} catch (error) {
-		throw new Error(`Failed to open browser: ${error}`);
-	}
-}
-
 export const login = buildHandler(async function (
 	this: HandlerContext,
 	flags: LoginFlags,
@@ -67,7 +31,7 @@ export const login = buildHandler(async function (
 		this.writer.writeErr("\tnpx workers auth login <token>");
 
 		try {
-			await openUrl(environment, url);
+			await openNotionUrl(environment, url);
 		} catch (_error) {
 			this.writer.writeErr(
 				`Failed to open browser automatically. Please visit:\n  ${url}`,

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

@@ -0,0 +1,149 @@
+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";
+
+export const listProviders = buildAuthedHandler(async function (
+	flags: FormatFlags,
+) {
+	this.process.stderr.write("Fetching providers...");
+	const providersResult = await this.apiClient.listOauthProviders();
+
+	if (Result.isFail(providersResult)) {
+		this.process.stderr.write("ERROR\n\n");
+		reportApiError(this, providersResult.error, "list providers");
+	} else {
+		this.process.stderr.write("OK\n\n");
+		const providers = providersResult.value.providers;
+		if (providers.length === 0) {
+			this.writer.writeErr("No OAuth providers are currently available.");
+			return;
+		}
+
+		this.writer.writeTableOut({
+			headers: ["Provider", "Description"],
+			rows: providers.map((provider) => [provider.key, provider.displayName]),
+			plain: flags.plain,
+		});
+	}
+});
+
+export const addConnection = buildAuthedHandler(async function (
+	_flags: GlobalFlags,
+	provider: string,
+) {
+	const workerId = requireWorkerId(this);
+
+	this.process.stderr.write(
+		`Starting OAuth flow with provider "${provider}"...`,
+	);
+	const startResult = await this.apiClient.startOauth({ workerId, provider });
+
+	if (Result.isFail(startResult)) {
+		this.process.stderr.write("ERROR\n\n");
+		reportApiError(this, startResult.error, "start OAuth flow");
+		return;
+	}
+
+	this.process.stderr.write("OK\n\n");
+
+	const { authorizationUrl } = startResult.value;
+
+	this.writer.writeErr("Opening your browser to continue the OAuth flow...");
+	try {
+		await openNotionUrl(this.config.environment ?? "prod", authorizationUrl);
+	} catch (error) {
+		this.writer.writeErr(
+			`Unable to open the browser automatically (${String(
+				error,
+			)}). Please open the link below manually.`,
+		);
+	}
+
+	this.writer.writeErr("");
+	this.writer.writeErr("If the browser did not open, visit:");
+	this.writer.writeErr(`  ${authorizationUrl}`);
+	this.writer.writeErr("");
+	this.writer.writeErr(
+		"After completing the flow in your browser, return to the CLI.",
+	);
+});
+
+export const listConnections = buildAuthedHandler(async function (
+	flags: FormatFlags,
+) {
+	const workerId = requireWorkerId(this);
+
+	this.process.stderr.write("Fetching OAuth connections...");
+	const secretsResult = await this.apiClient.listSecrets(workerId, {
+		secretKinds: ["oauth"],
+	});
+
+	if (Result.isFail(secretsResult)) {
+		this.process.stderr.write("ERROR\n\n");
+		reportApiError(this, secretsResult.error, "list OAuth connections");
+		return;
+	}
+
+	this.process.stderr.write("OK\n\n");
+
+	const secrets = secretsResult.value.secrets;
+
+	if (secrets.length === 0) {
+		this.writer.writeErr("No OAuth connections found for this worker.");
+		return;
+	}
+
+	this.writer.writeTableOut({
+		headers: ["Env Var", "Created At"],
+		rows: secrets.map((secret) => [
+			`process.env.${secret.key}`,
+			secret.createdAt,
+		]),
+		plain: flags.plain,
+	});
+});
+
+export const removeConnection = buildAuthedHandler(async function (
+	_flags: GlobalFlags,
+	provider: string,
+) {
+	const workerId = requireWorkerId(this);
+
+	this.process.stderr.write(
+		`Removing OAuth connection for provider "${provider}"...`,
+	);
+	const result = await this.apiClient.deleteOauthConnection({
+		workerId,
+		provider,
+	});
+
+	if (Result.isFail(result)) {
+		this.process.stderr.write("ERROR\n\n");
+		reportApiError(this, result.error, "remove connection");
+		return;
+	}
+
+	this.process.stderr.write("OK\n");
+});
+
+function requireWorkerId(context: AuthedContext): string {
+	const workerId = context.config.workerId;
+	if (!workerId) {
+		throw new Error(
+			"No worker configured. Run 'workers deploy' first to create a worker.",
+		);
+	}
+	return workerId;
+}
+
+function reportApiError(
+	context: AuthedContext,
+	error: ApiError,
+	action: string,
+): never {
+	context.writer.writeErr(`✗ Failed to ${action}`);
+	context.writer.writeErr(`✗ ${error.message}`);
+	throw new Error(error.message);
+}

package/src/cli/commands/connect.ts

@@ -0,0 +1,80 @@
+import { buildCommand, buildRouteMap } from "@stricli/core";
+
+import { formatFlags, globalFlags } from "../flags.js";
+
+export const connectCommands = buildRouteMap({
+	docs: {
+		brief: "Manage OAuth connections for your worker",
+	},
+	routes: {
+		providers: buildCommand({
+			docs: {
+				brief: "List available OAuth providers",
+			},
+			parameters: {
+				flags: {
+					...globalFlags,
+					...formatFlags,
+				},
+			},
+			loader: () => import("./connect.impl.js").then((m) => m.listProviders),
+		}),
+
+		add: buildCommand({
+			docs: {
+				brief: "Start an OAuth flow for a provider",
+			},
+			parameters: {
+				positional: {
+					kind: "tuple",
+					parameters: [
+						{
+							brief: "Provider name (see `providers` command)",
+							parse: String,
+							placeholder: "provider",
+						},
+					],
+				},
+				flags: {
+					...globalFlags,
+				},
+			},
+			loader: () => import("./connect.impl.js").then((m) => m.addConnection),
+		}),
+
+		list: buildCommand({
+			docs: {
+				brief: "List active OAuth connections",
+			},
+			parameters: {
+				flags: {
+					...globalFlags,
+					...formatFlags,
+				},
+			},
+			loader: () => import("./connect.impl.js").then((m) => m.listConnections),
+		}),
+
+		rm: buildCommand({
+			docs: {
+				brief: "Remove an OAuth connection",
+			},
+			parameters: {
+				positional: {
+					kind: "tuple",
+					parameters: [
+						{
+							brief: "Provider name to remove",
+							parse: String,
+							placeholder: "provider",
+						},
+					],
+				},
+				flags: {
+					...globalFlags,
+				},
+			},
+			loader: () => import("./connect.impl.js").then((m) => m.removeConnection),
+		}),
+	},
+});

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

@@ -52,12 +52,18 @@ export const listSecrets = buildAuthedHandler(async function (
 		const data = Result.unwrap(result);
 		if (data.secrets.length === 0) {
 			this.writer.writeErr("No secrets for this worker.");
+			this.writer.writeErr(
+				"To list OAuth connect secrets, use `npx workers connect list`",
+			);
 		} else {
 			this.writer.writeTableOut({
 				headers: ["Key", "Created At"],
 				rows: data.secrets.map((secret) => [secret.key, secret.createdAt]),
 				plain: flags.plain,
 			});
+			this.writer.writeErr(
+				"To list OAuth connect secrets, use `npx workers connect list`",
+			);
 		}
 	} else {
 		this.process.stderr.write("ERROR\n\n");

package/src/cli/routes.ts

@@ -3,6 +3,7 @@ import packageJson from "../../package.json" with { type: "json" };
 import { authCommands } from "./commands/auth.js";
 import { bundleCommands } from "./commands/bundle.js";
 import { capabilitiesCommands } from "./commands/capabilities.js";
+import { connectCommands } from "./commands/connect.js";
 import deploy from "./commands/deploy.js";
 import exec from "./commands/exec.js";
 import { runsCommands } from "./commands/runs.js";
@@ -18,6 +19,7 @@ const routes = buildRouteMap({
 		capabilities: capabilitiesCommands,
 		deploy: deploy,
 		exec: exec,
+		connect: connectCommands,
 		runs: runsCommands,
 		secrets: secretsCommands,
 		bundle: bundleCommands,

package/src/cli/utils/openNotionUrl.ts

@@ -0,0 +1,40 @@
+import { exec } from "node:child_process";
+import { existsSync } from "node:fs";
+
+import type { Environment } from "../config.js";
+
+export async function openNotionUrl(
+	env: Environment,
+	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}"`);
+			}
+		} else if (platform === "win32") {
+			exec(`start "" "${url}"`);
+		} else {
+			exec(`xdg-open "${url}"`);
+		}
+	} catch (error) {
+		throw new Error(`Failed to open browser: ${error}`);
+	}
+}
+
+function preferredNotionApp(env: Environment): string | null {
+	if (env === "prod" && existsSync("/Applications/Notion.app")) {
+		return "Notion";
+	}
+
+	if (env === "dev" && existsSync("/Applications/Notion Dev.app")) {
+		return "Notion Dev";
+	}
+
+	return null;
+}