Add Supabase provider support and CLI smoke testing

Author: marcusschiesser

.changeset/add-supabase-provider.md

@@ -0,0 +1,6 @@
+---
+"@agentpond/supabase": minor
+"agentpond": minor
+---
+
+Add automatic Supabase project setup and private Storage-backed trace export.

.github/workflows/ci.yml

@@ -44,6 +44,14 @@ jobs:
       - name: Run build
         run: pnpm build
 
+      - name: Setup Deno
+        uses: denoland/setup-deno@22d081ff2d3a40755e97629de92e3bcbfa7cf2ed # v2.0.5
+        with:
+          deno-version: 2.7.14
+
+      - name: Run Supabase Deno smoke test
+        run: pnpm --filter @agentpond/supabase test:deno
+
       - name: Run tests
         run: pnpm test
 

README.md

@@ -14,7 +14,7 @@
   <a href="https://www.npmjs.com/package/agentpond"><img src="https://img.shields.io/node/v/agentpond.svg" alt="Node.js version"></a>
 </p>
 
-AgentPond is a lightweight trace backend and CLI for AI applications. It keeps raw traces in object storage you control and syncs them into a local DuckDB cache for fast analysis by developers and coding agents. Use it with Firebase Storage, Amazon S3, Google Cloud Storage, Vercel Blob, or custom infrastructure. Firebase and Vercel include automated setup; other deployments use the manual setup path.
+AgentPond is a lightweight trace backend and CLI for AI applications. It keeps raw traces in object storage you control and syncs them into a local DuckDB cache for fast analysis by developers and coding agents. Use it with Firebase Storage, Supabase Storage, Amazon S3, Google Cloud Storage, Vercel Blob, or custom infrastructure. Firebase, Supabase, and Vercel include automated setup; other deployments use the manual setup path.
 
 ## How it works
 
@@ -26,12 +26,13 @@ Object storage is the durable source of truth. The local DuckDB database is a re
 
 Start with the [Manual deployment setup](./docs/getting-started/manual-setup.md) to choose a write path, configure object storage, instrument the application, and sync its traces into AgentPond.
 
-For Firebase and Vercel, AgentPond also provides automated quick starts:
+For Firebase, Supabase, and Vercel, AgentPond also provides automated quick starts:
 
 - [Firebase quick start](./docs/getting-started/firebase.md)
+- [Supabase quick start](./docs/getting-started/supabase.md)
 - [Vercel quick start](./docs/getting-started/vercel.md)
 
-Both require Node.js 22 or newer. From the Firebase or Vercel project, run:
+All require Node.js 22 or newer for the CLI. From the provider project, run:
 
 ```sh
 npx agentpond init
@@ -65,7 +66,7 @@ npx agentpond sql "select id, name, session_id, total_cost from traces order by
 
 ## Features
 
-- Direct OpenTelemetry export to Firebase Storage, S3, GCS, and Vercel Blob
+- Direct OpenTelemetry export to Firebase Storage, Supabase Storage, S3, GCS, and Vercel Blob
 - Langfuse-compatible and OTLP HTTP ingestion adapters
 - Incremental object-store synchronization
 - Local DuckDB projections for traces, observations, sessions, and scores
@@ -80,6 +81,7 @@ AgentPond does not provide a web UI, hosted trace storage, prompt management, da
 ## Documentation
 
 - [Firebase setup](./docs/getting-started/firebase.md)
+- [Supabase setup](./docs/getting-started/supabase.md)
 - [Vercel setup](./docs/getting-started/vercel.md)
 - [Manual deployment setup](./docs/getting-started/manual-setup.md)
 - [CLI reference](./docs/cli.md)

apps/cli/package.json

@@ -31,6 +31,7 @@
 		"@agentpond/fastify-ingest": "workspace:*",
 		"@agentpond/firebase": "workspace:*",
 		"@agentpond/google": "workspace:*",
+		"@agentpond/supabase": "workspace:*",
 		"@agentpond/vercel": "workspace:*",
 		"@duckdb/node-api": "^1.5.4-r.1",
 		"@inquirer/prompts": "8.5.2",

apps/cli/src/command-support.ts

@@ -14,6 +14,7 @@ import { environmentContextForCommand } from "./environment-context.js";
 export type GlobalOptions = {
 	env?: string;
 	json?: boolean;
+	platform?: string;
 };
 
 export type CommandContext = {
@@ -24,18 +25,28 @@ export type CommandContext = {
 export function addGlobalOptions(command: Command): Command {
 	return command
 		.option("--env <name>", "use an environment for this command")
+		.option(
+			"--platform <platform>",
+			"select a provider for this command: firebase, supabase, or vercel",
+		)
 		.option("--json", "print machine-readable JSON output");
 }
 
 export function commandContext(options: GlobalOptions): CommandContext {
-	const context = environmentContextForCommand({ envName: options.env });
+	const context = environmentContextForCommand({
+		envName: options.env,
+		platform: options.platform,
+	});
 	const json = Boolean(options.json);
 	logImplicitEnvironment(options, context.config, json);
 	return { context, json };
 }
 
 export function configForCommand(options: GlobalOptions): AgentPondConfig {
-	return environmentContextForCommand({ envName: options.env }).config;
+	return environmentContextForCommand({
+		envName: options.env,
+		platform: options.platform,
+	}).config;
 }
 
 export function cacheForRead(config: AgentPondConfig): AgentPondCache {

apps/cli/src/commands/dev.ts

@@ -9,11 +9,11 @@ import { buildServer } from "@agentpond/fastify-ingest";
 import type { Command } from "commander";
 import type { FastifyInstance, FastifyLoggerOptions } from "fastify";
 import { CliError, parsePort } from "../cli-support.js";
-import { addGlobalOptions } from "../command-support.js";
+import { addGlobalOptions, type GlobalOptions } from "../command-support.js";
 import { devSdkEnvironment } from "../dev-env.js";
 import { manualEnvironmentContextForCommand } from "../environment-context.js";
 
-type DevOptions = {
+type DevOptions = GlobalOptions & {
 	host?: string;
 	port?: string;
 };
@@ -23,15 +23,22 @@ export function registerDevCommand(program: Command): void {
 		.description("start a local Langfuse SDK-compatible ingestion server")
 		.option("--host <host>", "host to bind", "127.0.0.1")
 		.option("--port <port>", "port to bind", "4318")
-		.action(async (options: DevOptions) => {
-			await startDevServer(options);
+		.action(async (options: DevOptions, command: Command) => {
+			const globalOptions = command.optsWithGlobals<GlobalOptions>();
+			await startDevServer({
+				...options,
+				platform: globalOptions.platform,
+			});
 		});
 }
 
 export async function startDevServer(options: DevOptions): Promise<void> {
 	const host = options.host ?? "127.0.0.1";
 	const startPort = parsePort(options.port ?? "4318");
-	const context = manualEnvironmentContextForCommand("dev", { envName: "dev" });
+	const context = manualEnvironmentContextForCommand("dev", {
+		envName: "dev",
+		platform: options.platform,
+	});
 	const cwd = context.rootDir;
 	const environment = initAgentPondEnvironment("dev", { cwd });
 	selectAgentPondEnvironment(environment.name, { cwd });

apps/cli/src/commands/env.ts

@@ -58,6 +58,7 @@ export function registerEnvCommand(
 			const globalOptions = command.optsWithGlobals<GlobalOptions>();
 			const environment = environmentContextForCommand({
 				envName: globalOptions.env,
+				platform: globalOptions.platform,
 			}).config.environment;
 			if (!environment) throw new CliError("Missing environment configuration");
 			if (globalOptions.json) {
@@ -70,9 +71,11 @@ export function registerEnvCommand(
 		.description("print shell exports for a manual environment")
 		.option("--langfuse", "print only Langfuse-compatible SDK exports")
 		.option("--otel", "print only OpenTelemetry SDK exports")
-		.action((name: string, commandOptions: EnvOptions) => {
+		.action((name: string, commandOptions: EnvOptions, command: Command) => {
+			const globalOptions = command.optsWithGlobals<GlobalOptions>();
 			const context = manualEnvironmentContextForCommand("get", {
 				envName: name,
+				platform: globalOptions.platform,
 			});
 			printEnvironmentExports(name, commandOptions, context.rootDir);
 		});
@@ -83,6 +86,7 @@ export function registerEnvCommand(
 			const globalOptions = command.optsWithGlobals<GlobalOptions>();
 			const context = manualEnvironmentContextForCommand("list", {
 				envName: globalOptions.env,
+				platform: globalOptions.platform,
 			});
 			const cwd = context.rootDir;
 			const selected = context.config.environment?.name ?? "dev";
@@ -99,8 +103,10 @@ export function registerEnvCommand(
 		.option("--store <store>", "object store: s3, gcs, or local")
 		.action(
 			async (name: string, commandOptions: EnvOptions, command: Command) => {
+				const globalOptions = command.optsWithGlobals<GlobalOptions>();
 				const context = manualEnvironmentContextForCommand("init", {
 					envName: name,
+					platform: globalOptions.platform,
 				});
 				const store =
 					storeFromValue(commandOptions.store) ??
@@ -116,7 +122,7 @@ export function registerEnvCommand(
 						dbPath: environment.dbPath,
 						store,
 					},
-					Boolean(command.optsWithGlobals<GlobalOptions>().json),
+					Boolean(globalOptions.json),
 				);
 			},
 		);
@@ -129,20 +135,23 @@ export function registerEnvCommand(
 				_commandOptions: EnvOptions,
 				command: Command,
 			) => {
-				const selected = await selectEnvironmentForCommand(name, promptSelect);
-				return print(
-					{ selected },
-					Boolean(command.optsWithGlobals<GlobalOptions>().json),
+				const globalOptions = command.optsWithGlobals<GlobalOptions>();
+				const selected = await selectEnvironmentForCommand(
+					name,
+					promptSelect,
+					globalOptions,
 				);
+				return print({ selected }, Boolean(globalOptions.json));
 			},
 		);
 }
 
 async function selectEnvironmentForCommand(
 	name: string | undefined,
 	promptSelect: SelectEnvironmentPrompt,
+	options: GlobalOptions,
 ): Promise<string> {
-	const providerContext = providerForCommand();
+	const providerContext = providerForCommand({ platform: options.platform });
 	if (providerContext) {
 		if (!name) throw new CliError("Missing environment name");
 		try {
@@ -154,7 +163,10 @@ async function selectEnvironmentForCommand(
 		}
 	}
 
-	const context = environmentContextForCommand({ envName: name });
+	const context = environmentContextForCommand({
+		envName: name,
+		platform: options.platform,
+	});
 	const selectedName =
 		name ?? (await promptForEnvironmentName(promptSelect, context.rootDir));
 	return selectAgentPondEnvironment(selectedName, {

apps/cli/src/commands/init.ts

@@ -6,8 +6,6 @@ import type { Command } from "commander";
 import { CliError } from "../cli-support.js";
 import type { GlobalOptions } from "../command-support.js";
 import {
-	AVAILABLE_PLATFORMS,
-	initPlatformFromValue,
 	type ProviderProjectContext,
 	providerForCommand,
 } from "../providers.js";
@@ -42,10 +40,6 @@ export function agentPondInitHeader(context: {
 	].join("\n");
 }
 
-type InitCommandOptions = {
-	platform?: string;
-};
-
 export type SkillsInstallRequest = {
 	cwd: string;
 	source: string;
@@ -71,22 +65,20 @@ export function registerInitCommand(
 	program
 		.command("init")
 		.description("set up AgentPond for the current project")
-		.option(
-			"--platform <platform>",
-			`setup platform: ${AVAILABLE_PLATFORMS.join(" or ")}`,
-		)
-		.action(async (commandOptions: InitCommandOptions, command: Command) => {
+		.action(async (_commandOptions: GlobalOptions, command: Command) => {
 			const globalOptions = command.optsWithGlobals<GlobalOptions>();
 			if (globalOptions.json) {
 				throw new CliError("--json is not supported by npx agentpond init");
 			}
 
-			const platform = initPlatformFromValue(commandOptions.platform);
 			let setup:
 				| { context: ProviderProjectContext; projectLabel: string }
 				| undefined;
 			try {
-				const context = providerForCommand({ platform });
+				const context = providerForCommand({
+					allowUnlinked: true,
+					platform: globalOptions.platform,
+				});
 				setup = context
 					? { context, projectLabel: context.project.projectLabel }
 					: undefined;
@@ -98,7 +90,7 @@ export function registerInitCommand(
 			if (!setup) {
 				throw new CliError(
 					[
-						"Automatic AgentPond setup supports Firebase and Vercel projects.",
+						"Automatic AgentPond setup supports Firebase, Supabase, and Vercel projects.",
 						"",
 						"For AWS, Google Cloud, and other deployment setups, see:",
 						MANUAL_SETUP_URL,

apps/cli/src/environment-context.ts

@@ -12,6 +12,7 @@ import { providerForCommand } from "./providers.js";
 export type EnvironmentContextOptions = {
 	cwd?: string;
 	envName?: string;
+	platform?: string;
 };
 
 export function environmentContextForCommand(
@@ -30,7 +31,10 @@ export function manualEnvironmentContextForCommand(
 	action: "dev" | "get" | "init" | "list",
 	options: EnvironmentContextOptions = {},
 ): AgentPondEnvironmentContext {
-	const providerContext = providerForCommand({ cwd: options.cwd });
+	const providerContext = providerForCommand({
+		cwd: options.cwd,
+		platform: options.platform,
+	});
 	if (providerContext) {
 		const alternative =
 			action === "dev"

apps/cli/src/providers.ts

@@ -3,14 +3,16 @@ import type {
 	AgentPondProviderProject,
 } from "@agentpond/core";
 import { firebaseProvider } from "@agentpond/firebase";
+import { supabaseProvider } from "@agentpond/supabase";
 import { vercelProvider } from "@agentpond/vercel";
 import { CliError } from "./cli-support.js";
 
-export const AVAILABLE_PLATFORMS = ["firebase", "vercel"] as const;
+export const AVAILABLE_PLATFORMS = ["firebase", "supabase", "vercel"] as const;
 export type InitPlatform = (typeof AVAILABLE_PLATFORMS)[number];
 
 const PROVIDERS_BY_PLATFORM = {
 	firebase: firebaseProvider,
+	supabase: supabaseProvider,
 	vercel: vercelProvider,
 } satisfies Record<InitPlatform, AgentPondProvider>;
 
@@ -35,13 +37,14 @@ export function initPlatformFromValue(
 }
 
 export function providerForCommand(
-	options: { cwd?: string; platform?: InitPlatform } = {},
+	options: { allowUnlinked?: boolean; cwd?: string; platform?: string } = {},
 ): ProviderProjectContext | undefined {
-	if (options.platform) {
-		const provider = PROVIDERS_BY_PLATFORM[options.platform];
+	const platform = initPlatformFromValue(options.platform);
+	if (platform) {
+		const provider = PROVIDERS_BY_PLATFORM[platform];
 		const project = provider.openProject({
 			cwd: options.cwd,
-			allowUnlinked: true,
+			allowUnlinked: options.allowUnlinked,
 		});
 		if (!project) {
 			throw new CliError(
@@ -57,7 +60,7 @@ export function providerForCommand(
 	});
 	if (projects.length > 1) {
 		throw new CliError(
-			`Multiple AgentPond platforms were detected: ${projects.map(({ provider }) => provider.displayName).join(", ")}. Remove the unrelated project marker or select one with npx agentpond init --platform <platform>.`,
+			`Multiple AgentPond platforms were detected: ${projects.map(({ provider }) => provider.displayName).join(", ")}. Pass --platform <platform> to select one for this command.`,
 		);
 	}
 	return projects[0];