granola-toolkit 0.14.0 → 0.16.0

package/README.md

@@ -1,6 +1,6 @@
 # granola-toolkit
 
-General toolkit to do more with Granola notes and transcripts.
+Toolkit for working with Granola meetings, notes, and transcripts.
 
 ## Install
 
@@ -15,6 +15,7 @@ Without a global install:
 
 ```bash
 npx granola-toolkit --help
+npx granola-toolkit meeting --help
 ```
 
 For local development:
@@ -27,7 +28,7 @@ vp install
 
 ## Run
 
-Installed CLI:
+Installed command:
 
 ```bash
 granola --help
@@ -37,6 +38,8 @@ granola notes --help
 granola transcripts --help
 ```
 
+The published package exposes both `granola` and `granola-toolkit` as executable names.
+
 Local build:
 
 ```bash

package/dist/cli.js

@@ -689,96 +689,34 @@ var AuthenticatedHttpClient = class {
 };
 //#endregion
 //#region src/client/default.ts
-async function createDefaultGranolaApiClient(config, logger = console) {
+async function inspectDefaultGranolaAuth(config) {
+	const storedSession = await createDefaultSessionStore().readSession();
+	const hasStoredSession = Boolean(storedSession?.accessToken.trim());
+	return {
+		mode: hasStoredSession ? "stored-session" : "supabase-file",
+		storedSessionAvailable: hasStoredSession,
+		supabasePath: config.supabase || void 0
+	};
+}
+async function createDefaultGranolaRuntime(config, logger = console) {
 	const sessionStore = createDefaultSessionStore();
-	const storedSession = await sessionStore.readSession();
-	if (!storedSession && !config.supabase) throw new Error(`supabase.json not found. Pass --supabase or create .granola.toml. Expected locations include: ${granolaSupabaseCandidates().join(", ")}`);
-	if (!storedSession && config.supabase && !existsSync(config.supabase)) throw new Error(`supabase.json not found: ${config.supabase}`);
-	return new GranolaApiClient(new AuthenticatedHttpClient({
-		logger,
-		tokenProvider: storedSession ? new StoredSessionTokenProvider(sessionStore, { source: config.supabase && existsSync(config.supabase) ? new SupabaseFileSessionSource(config.supabase) : void 0 }) : new CachedTokenProvider(new SupabaseFileTokenSource(config.supabase), new NoopTokenStore())
-	}));
+	const auth = await inspectDefaultGranolaAuth(config);
+	const hasStoredSession = auth.storedSessionAvailable;
+	if (!hasStoredSession && !config.supabase) throw new Error(`supabase.json not found. Pass --supabase or create .granola.toml. Expected locations include: ${granolaSupabaseCandidates().join(", ")}`);
+	if (!hasStoredSession && config.supabase && !existsSync(config.supabase)) throw new Error(`supabase.json not found: ${config.supabase}`);
+	return {
+		auth,
+		client: new GranolaApiClient(new AuthenticatedHttpClient({
+			logger,
+			tokenProvider: hasStoredSession ? new StoredSessionTokenProvider(sessionStore, { source: config.supabase && existsSync(config.supabase) ? new SupabaseFileSessionSource(config.supabase) : void 0 }) : new CachedTokenProvider(new SupabaseFileTokenSource(config.supabase), new NoopTokenStore())
+		}))
+	};
 }
 async function loadOptionalGranolaCache(cacheFile) {
 	if (!cacheFile || !existsSync(cacheFile)) return;
 	return parseCacheContents(await readFile(cacheFile, "utf8"));
 }
 //#endregion
-//#region src/config.ts
-function pickString(value) {
-	return typeof value === "string" && value.trim() ? value.trim() : void 0;
-}
-function pickBoolean(value) {
-	return typeof value === "boolean" ? value : void 0;
-}
-function parseTomlScalar(rawValue) {
-	const value = rawValue.trim();
-	if (value.startsWith("\"") && value.endsWith("\"") || value.startsWith("'") && value.endsWith("'")) {
-		if (value.startsWith("\"")) try {
-			return JSON.parse(value);
-		} catch {
-			return value.slice(1, -1);
-		}
-		return value.slice(1, -1);
-	}
-	if (/^(true|false)$/i.test(value)) return value.toLowerCase() === "true";
-	if (/^-?\d+(?:\.\d+)?$/.test(value)) return Number(value);
-	return value;
-}
-function parseSimpleToml(contents) {
-	const values = {};
-	for (const rawLine of contents.split(/\r?\n/)) {
-		const line = rawLine.trim();
-		if (!line || line.startsWith("#")) continue;
-		const match = /^([A-Za-z0-9_-]+)\s*=\s*(.+)$/.exec(line);
-		if (!match) continue;
-		const [, key = "", rawValue = ""] = match;
-		values[key] = parseTomlScalar(rawValue);
-	}
-	return values;
-}
-async function loadTomlConfig(configPath) {
-	if (configPath) {
-		if (!existsSync(configPath)) throw new Error(`config file not found: ${configPath}`);
-		return {
-			path: configPath,
-			values: parseSimpleToml(await readUtf8(configPath))
-		};
-	}
-	const candidates = [join(process.cwd(), ".granola.toml"), join(homedir(), ".granola.toml")];
-	for (const candidate of candidates) if (existsSync(candidate)) return {
-		path: candidate,
-		values: parseSimpleToml(await readUtf8(candidate))
-	};
-	return { values: {} };
-}
-function envFlag(value) {
-	if (value == null) return;
-	if (/^(1|true|yes|on)$/i.test(value)) return true;
-	if (/^(0|false|no|off)$/i.test(value)) return false;
-}
-async function loadConfig(options) {
-	const env = options.env ?? process.env;
-	const config = await loadTomlConfig(pickString(options.globalFlags.config));
-	const configValues = config.values;
-	const defaultSupabase = firstExistingPath(granolaSupabaseCandidates());
-	const defaultCache = firstExistingPath(granolaCacheCandidates());
-	const timeoutValue = pickString(options.subcommandFlags.timeout) ?? pickString(env.TIMEOUT) ?? pickString(configValues.timeout) ?? "2m";
-	return {
-		configFileUsed: config.path,
-		debug: pickBoolean(options.globalFlags.debug) ?? envFlag(env.DEBUG_MODE) ?? pickBoolean(configValues.debug) ?? false,
-		notes: {
-			output: pickString(options.subcommandFlags.output) ?? pickString(env.OUTPUT) ?? pickString(configValues.output) ?? "./notes",
-			timeoutMs: parseDuration(timeoutValue)
-		},
-		supabase: pickString(options.globalFlags.supabase) ?? pickString(env.SUPABASE_FILE) ?? pickString(configValues.supabase) ?? defaultSupabase,
-		transcripts: {
-			cacheFile: pickString(options.subcommandFlags.cache) ?? pickString(env.CACHE_FILE) ?? pickString(configValues["cache-file"]) ?? pickString(configValues.cacheFile) ?? defaultCache ?? "",
-			output: pickString(options.subcommandFlags.output) ?? pickString(env.TRANSCRIPT_OUTPUT) ?? pickString(configValues["transcript-output"]) ?? pickString(configValues.transcriptOutput) ?? "./transcripts"
-		}
-	};
-}
-//#endregion
 //#region src/export-state.ts
 const EXPORT_STATE_VERSION = 1;
 function exportStatePath(outputDir, kind) {
@@ -1524,6 +1462,285 @@ function renderMeetingTranscript(document, cacheData, format = "text") {
 	return renderTranscriptExport(transcript, format);
 }
 //#endregion
+//#region src/app/core.ts
+function transcriptCount(cacheData) {
+	return Object.values(cacheData.transcripts).filter((segments) => segments.length > 0).length;
+}
+function cloneExportState(state) {
+	return state ? { ...state } : void 0;
+}
+function cloneState(state) {
+	return {
+		auth: { ...state.auth },
+		cache: { ...state.cache },
+		config: {
+			...state.config,
+			notes: { ...state.config.notes },
+			transcripts: { ...state.config.transcripts }
+		},
+		documents: { ...state.documents },
+		exports: {
+			notes: cloneExportState(state.exports.notes),
+			transcripts: cloneExportState(state.exports.transcripts)
+		},
+		ui: { ...state.ui }
+	};
+}
+function defaultState(config, auth, surface) {
+	return {
+		auth: { ...auth },
+		cache: {
+			configured: Boolean(config.transcripts.cacheFile),
+			documentCount: 0,
+			filePath: config.transcripts.cacheFile || void 0,
+			loaded: false,
+			transcriptCount: 0
+		},
+		config: {
+			...config,
+			notes: { ...config.notes },
+			transcripts: { ...config.transcripts }
+		},
+		documents: {
+			count: 0,
+			loaded: false
+		},
+		exports: {},
+		ui: {
+			surface,
+			view: "idle"
+		}
+	};
+}
+var GranolaApp = class {
+	#cacheData;
+	#cacheResolved = false;
+	#granolaClient;
+	#documents;
+	#state;
+	constructor(config, deps, options = {}) {
+		this.config = config;
+		this.deps = deps;
+		this.#state = defaultState(config, deps.auth, options.surface ?? "cli");
+	}
+	getState() {
+		return cloneState(this.#state);
+	}
+	setUiState(patch) {
+		this.#state.ui = {
+			...this.#state.ui,
+			...patch
+		};
+		return this.getState();
+	}
+	nowIso() {
+		return (this.deps.now ?? (() => /* @__PURE__ */ new Date()))().toISOString();
+	}
+	async getGranolaClient() {
+		if (this.#granolaClient) return this.#granolaClient;
+		if (this.deps.granolaClient) {
+			this.#granolaClient = this.deps.granolaClient;
+			return this.#granolaClient;
+		}
+		if (!this.deps.createGranolaClient) throw new Error("Granola API client is not configured");
+		const runtime = await this.deps.createGranolaClient();
+		this.#granolaClient = runtime.client;
+		this.#state.auth = { ...runtime.auth };
+		return this.#granolaClient;
+	}
+	missingCacheError() {
+		return /* @__PURE__ */ new Error(`Granola cache file not found. Pass --cache or create .granola.toml. Expected locations include: ${granolaCacheCandidates().join(", ")}`);
+	}
+	async listDocuments() {
+		if (this.#documents) return this.#documents;
+		const documents = await (await this.getGranolaClient()).listDocuments({ timeoutMs: this.config.notes.timeoutMs });
+		this.#documents = documents;
+		this.#state.documents = {
+			count: documents.length,
+			loaded: true,
+			loadedAt: this.nowIso()
+		};
+		return documents;
+	}
+	async loadCache(options = {}) {
+		if (this.#cacheResolved) {
+			if (options.required && !this.#cacheData) throw this.missingCacheError();
+			return this.#cacheData;
+		}
+		const cacheFile = this.config.transcripts.cacheFile || void 0;
+		if (!cacheFile) {
+			this.#cacheResolved = true;
+			if (options.required) throw this.missingCacheError();
+			return;
+		}
+		if (!existsSync(cacheFile)) throw new Error(`Granola cache file not found: ${cacheFile}`);
+		const cacheData = await this.deps.cacheLoader(cacheFile);
+		this.#cacheResolved = true;
+		this.#cacheData = cacheData;
+		this.#state.cache = {
+			configured: true,
+			documentCount: cacheData ? Object.keys(cacheData.documents).length : 0,
+			filePath: cacheFile,
+			loaded: Boolean(cacheData),
+			loadedAt: cacheData ? this.nowIso() : void 0,
+			transcriptCount: cacheData ? transcriptCount(cacheData) : 0
+		};
+		if (options.required && !cacheData) throw this.missingCacheError();
+		return cacheData;
+	}
+	async listMeetings(options = {}) {
+		const meetings = listMeetings(await this.listDocuments(), {
+			cacheData: await this.loadCache(),
+			limit: options.limit,
+			search: options.search
+		});
+		this.setUiState({
+			meetingSearch: options.search,
+			selectedMeetingId: void 0,
+			view: "meeting-list"
+		});
+		return meetings;
+	}
+	async getMeeting(id, options = {}) {
+		const documents = await this.listDocuments();
+		const cacheData = await this.loadCache({ required: options.requireCache });
+		const document = resolveMeeting(documents, id);
+		const meeting = buildMeetingRecord(document, cacheData);
+		this.setUiState({
+			selectedMeetingId: document.id,
+			view: "meeting-detail"
+		});
+		return {
+			cacheData,
+			document,
+			meeting
+		};
+	}
+	async exportNotes(format = "markdown") {
+		const documents = await this.listDocuments();
+		const written = await writeNotes(documents, this.config.notes.output, format);
+		this.#state.exports.notes = {
+			format,
+			itemCount: documents.length,
+			outputDir: this.config.notes.output,
+			ranAt: this.nowIso(),
+			written
+		};
+		this.setUiState({ view: "notes-export" });
+		return {
+			documentCount: documents.length,
+			documents,
+			format,
+			outputDir: this.config.notes.output,
+			written
+		};
+	}
+	async exportTranscripts(format = "text") {
+		const cacheData = await this.loadCache({ required: true });
+		if (!cacheData) throw this.missingCacheError();
+		const written = await writeTranscripts(cacheData, this.config.transcripts.output, format);
+		const count = transcriptCount(cacheData);
+		this.#state.exports.transcripts = {
+			format,
+			itemCount: count,
+			outputDir: this.config.transcripts.output,
+			ranAt: this.nowIso(),
+			written
+		};
+		this.setUiState({ view: "transcripts-export" });
+		return {
+			cacheData,
+			format,
+			outputDir: this.config.transcripts.output,
+			transcriptCount: count,
+			written
+		};
+	}
+};
+async function createGranolaApp(config, options = {}) {
+	return new GranolaApp(config, {
+		auth: await inspectDefaultGranolaAuth(config),
+		cacheLoader: loadOptionalGranolaCache,
+		createGranolaClient: async () => await createDefaultGranolaRuntime(config, options.logger),
+		now: options.now
+	}, { surface: options.surface });
+}
+//#endregion
+//#region src/config.ts
+function pickString(value) {
+	return typeof value === "string" && value.trim() ? value.trim() : void 0;
+}
+function pickBoolean(value) {
+	return typeof value === "boolean" ? value : void 0;
+}
+function parseTomlScalar(rawValue) {
+	const value = rawValue.trim();
+	if (value.startsWith("\"") && value.endsWith("\"") || value.startsWith("'") && value.endsWith("'")) {
+		if (value.startsWith("\"")) try {
+			return JSON.parse(value);
+		} catch {
+			return value.slice(1, -1);
+		}
+		return value.slice(1, -1);
+	}
+	if (/^(true|false)$/i.test(value)) return value.toLowerCase() === "true";
+	if (/^-?\d+(?:\.\d+)?$/.test(value)) return Number(value);
+	return value;
+}
+function parseSimpleToml(contents) {
+	const values = {};
+	for (const rawLine of contents.split(/\r?\n/)) {
+		const line = rawLine.trim();
+		if (!line || line.startsWith("#")) continue;
+		const match = /^([A-Za-z0-9_-]+)\s*=\s*(.+)$/.exec(line);
+		if (!match) continue;
+		const [, key = "", rawValue = ""] = match;
+		values[key] = parseTomlScalar(rawValue);
+	}
+	return values;
+}
+async function loadTomlConfig(configPath) {
+	if (configPath) {
+		if (!existsSync(configPath)) throw new Error(`config file not found: ${configPath}`);
+		return {
+			path: configPath,
+			values: parseSimpleToml(await readUtf8(configPath))
+		};
+	}
+	const candidates = [join(process.cwd(), ".granola.toml"), join(homedir(), ".granola.toml")];
+	for (const candidate of candidates) if (existsSync(candidate)) return {
+		path: candidate,
+		values: parseSimpleToml(await readUtf8(candidate))
+	};
+	return { values: {} };
+}
+function envFlag(value) {
+	if (value == null) return;
+	if (/^(1|true|yes|on)$/i.test(value)) return true;
+	if (/^(0|false|no|off)$/i.test(value)) return false;
+}
+async function loadConfig(options) {
+	const env = options.env ?? process.env;
+	const config = await loadTomlConfig(pickString(options.globalFlags.config));
+	const configValues = config.values;
+	const defaultSupabase = firstExistingPath(granolaSupabaseCandidates());
+	const defaultCache = firstExistingPath(granolaCacheCandidates());
+	const timeoutValue = pickString(options.subcommandFlags.timeout) ?? pickString(env.TIMEOUT) ?? pickString(configValues.timeout) ?? "2m";
+	return {
+		configFileUsed: config.path,
+		debug: pickBoolean(options.globalFlags.debug) ?? envFlag(env.DEBUG_MODE) ?? pickBoolean(configValues.debug) ?? false,
+		notes: {
+			output: pickString(options.subcommandFlags.output) ?? pickString(env.OUTPUT) ?? pickString(configValues.output) ?? "./notes",
+			timeoutMs: parseDuration(timeoutValue)
+		},
+		supabase: pickString(options.globalFlags.supabase) ?? pickString(env.SUPABASE_FILE) ?? pickString(configValues.supabase) ?? defaultSupabase,
+		transcripts: {
+			cacheFile: pickString(options.subcommandFlags.cache) ?? pickString(env.CACHE_FILE) ?? pickString(configValues["cache-file"]) ?? pickString(configValues.cacheFile) ?? defaultCache ?? "",
+			output: pickString(options.subcommandFlags.output) ?? pickString(env.TRANSCRIPT_OUTPUT) ?? pickString(configValues["transcript-output"]) ?? pickString(configValues.transcriptOutput) ?? "./transcripts"
+		}
+	};
+}
+//#endregion
 //#region src/commands/shared.ts
 function debug(enabled, ...values) {
 	if (enabled) console.error("[debug]", ...values);
@@ -1643,41 +1860,22 @@ const meetingCommand = {
 		}
 	}
 };
-async function loadMeetingData(commandFlags, globalFlags, options = {}) {
+async function list(commandFlags, globalFlags) {
+	const format = resolveListFormat(commandFlags.format);
+	const limit = parseLimit(commandFlags.limit);
+	const search = typeof commandFlags.search === "string" ? commandFlags.search : void 0;
 	const config = await loadConfig({
 		globalFlags,
 		subcommandFlags: commandFlags
 	});
-	if (options.requireCache && !config.transcripts.cacheFile) throw new Error(`Granola cache file not found. Pass --cache or create .granola.toml. Expected locations include: ${granolaCacheCandidates().join(", ")}`);
-	if (config.transcripts.cacheFile && !existsSync(config.transcripts.cacheFile)) throw new Error(`Granola cache file not found: ${config.transcripts.cacheFile}`);
 	debug(config.debug, "using config", config.configFileUsed ?? "(none)");
 	debug(config.debug, "supabase", config.supabase);
 	debug(config.debug, "cacheFile", config.transcripts.cacheFile || "(none)");
 	debug(config.debug, "timeoutMs", config.notes.timeoutMs);
-	const granolaClient = await createDefaultGranolaApiClient(config);
-	return {
-		cacheData: await loadOptionalGranolaCache(config.transcripts.cacheFile),
-		config,
-		granolaClient
-	};
-}
-async function loadResolvedMeeting(id, commandFlags, globalFlags, options = {}) {
-	const { cacheData, config, granolaClient } = await loadMeetingData(commandFlags, globalFlags, options);
-	console.log("Fetching meeting from Granola API...");
-	return {
-		cacheData,
-		config,
-		document: resolveMeeting(await granolaClient.listDocuments({ timeoutMs: config.notes.timeoutMs }), id)
-	};
-}
-async function list(commandFlags, globalFlags) {
-	const format = resolveListFormat(commandFlags.format);
-	const limit = parseLimit(commandFlags.limit);
-	const search = typeof commandFlags.search === "string" ? commandFlags.search : void 0;
-	const { cacheData, config, granolaClient } = await loadMeetingData(commandFlags, globalFlags);
+	const app = await createGranolaApp(config);
+	debug(config.debug, "authMode", app.getState().auth.mode);
 	console.log("Fetching meetings from Granola API...");
-	const meetings = listMeetings(await granolaClient.listDocuments({ timeoutMs: config.notes.timeoutMs }), {
-		cacheData,
+	const meetings = await app.listMeetings({
 		limit,
 		search
 	});
@@ -1686,29 +1884,71 @@ async function list(commandFlags, globalFlags) {
 }
 async function view(id, commandFlags, globalFlags) {
 	const format = resolveViewFormat(commandFlags.format);
-	const { cacheData, document } = await loadResolvedMeeting(id, commandFlags, globalFlags);
-	const meeting = buildMeetingRecord(document, cacheData);
-	console.log(renderMeetingView(meeting, format).trimEnd());
+	const config = await loadConfig({
+		globalFlags,
+		subcommandFlags: commandFlags
+	});
+	debug(config.debug, "using config", config.configFileUsed ?? "(none)");
+	debug(config.debug, "supabase", config.supabase);
+	debug(config.debug, "cacheFile", config.transcripts.cacheFile || "(none)");
+	debug(config.debug, "timeoutMs", config.notes.timeoutMs);
+	const app = await createGranolaApp(config);
+	debug(config.debug, "authMode", app.getState().auth.mode);
+	console.log("Fetching meeting from Granola API...");
+	const result = await app.getMeeting(id);
+	console.log(renderMeetingView(result.meeting, format).trimEnd());
 	return 0;
 }
 async function exportMeeting(id, commandFlags, globalFlags) {
 	const format = resolveExportFormat(commandFlags.format);
-	const { cacheData, document } = await loadResolvedMeeting(id, commandFlags, globalFlags);
-	const meeting = buildMeetingRecord(document, cacheData);
-	console.log(renderMeetingExport(meeting, format).trimEnd());
+	const config = await loadConfig({
+		globalFlags,
+		subcommandFlags: commandFlags
+	});
+	debug(config.debug, "using config", config.configFileUsed ?? "(none)");
+	debug(config.debug, "supabase", config.supabase);
+	debug(config.debug, "cacheFile", config.transcripts.cacheFile || "(none)");
+	debug(config.debug, "timeoutMs", config.notes.timeoutMs);
+	const app = await createGranolaApp(config);
+	debug(config.debug, "authMode", app.getState().auth.mode);
+	console.log("Fetching meeting from Granola API...");
+	const result = await app.getMeeting(id);
+	console.log(renderMeetingExport(result.meeting, format).trimEnd());
 	return 0;
 }
 async function notes(id, commandFlags, globalFlags) {
 	const format = resolveNotesFormat(commandFlags.format);
-	const { document } = await loadResolvedMeeting(id, commandFlags, globalFlags);
-	console.log(renderMeetingNotes(document, format).trimEnd());
+	const config = await loadConfig({
+		globalFlags,
+		subcommandFlags: commandFlags
+	});
+	debug(config.debug, "using config", config.configFileUsed ?? "(none)");
+	debug(config.debug, "supabase", config.supabase);
+	debug(config.debug, "cacheFile", config.transcripts.cacheFile || "(none)");
+	debug(config.debug, "timeoutMs", config.notes.timeoutMs);
+	const app = await createGranolaApp(config);
+	debug(config.debug, "authMode", app.getState().auth.mode);
+	console.log("Fetching meeting from Granola API...");
+	const result = await app.getMeeting(id);
+	console.log(renderMeetingNotes(result.document, format).trimEnd());
 	return 0;
 }
 async function transcript(id, commandFlags, globalFlags) {
 	const format = resolveTranscriptFormat$1(commandFlags.format);
-	const { cacheData, document } = await loadResolvedMeeting(id, commandFlags, globalFlags, { requireCache: true });
-	const output = renderMeetingTranscript(document, cacheData, format);
-	if (!output.trim()) throw new Error(`no transcript found for meeting: ${document.id}`);
+	const config = await loadConfig({
+		globalFlags,
+		subcommandFlags: commandFlags
+	});
+	debug(config.debug, "using config", config.configFileUsed ?? "(none)");
+	debug(config.debug, "supabase", config.supabase);
+	debug(config.debug, "cacheFile", config.transcripts.cacheFile || "(none)");
+	debug(config.debug, "timeoutMs", config.notes.timeoutMs);
+	const app = await createGranolaApp(config);
+	debug(config.debug, "authMode", app.getState().auth.mode);
+	console.log("Fetching meeting from Granola API...");
+	const result = await app.getMeeting(id, { requireCache: true });
+	const output = renderMeetingTranscript(result.document, result.cacheData, format);
+	if (!output.trim()) throw new Error(`no transcript found for meeting: ${result.document.id}`);
 	console.log(output.trimEnd());
 	return 0;
 }
@@ -1751,13 +1991,11 @@ const notesCommand = {
 		debug(config.debug, "output", config.notes.output);
 		const format = resolveNoteFormat(commandFlags.format);
 		debug(config.debug, "format", format);
-		const granolaClient = await createDefaultGranolaApiClient(config);
-		console.log("Fetching documents from Granola API...");
-		const documents = await granolaClient.listDocuments({ timeoutMs: config.notes.timeoutMs });
-		console.log(`Exporting ${documents.length} notes to ${config.notes.output}...`);
-		const written = await writeNotes(documents, config.notes.output, format);
-		console.log("✓ Export completed successfully");
-		debug(config.debug, "notes written", written);
+		const app = await createGranolaApp(config);
+		debug(config.debug, "authMode", app.getState().auth.mode);
+		const result = await app.exportNotes(format);
+		console.log(`✓ Exported ${result.documentCount} notes to ${result.outputDir}`);
+		debug(config.debug, "notes written", result.written);
 		return 0;
 	}
 };
@@ -1803,20 +2041,16 @@ const transcriptsCommand = {
 			globalFlags,
 			subcommandFlags: commandFlags
 		});
-		if (!config.transcripts.cacheFile) throw new Error(`Granola cache file not found. Pass --cache or create .granola.toml. Expected locations include: ${granolaCacheCandidates().join(", ")}`);
-		if (!existsSync(config.transcripts.cacheFile)) throw new Error(`Granola cache file not found: ${config.transcripts.cacheFile}`);
 		debug(config.debug, "using config", config.configFileUsed ?? "(none)");
 		debug(config.debug, "cacheFile", config.transcripts.cacheFile);
 		debug(config.debug, "output", config.transcripts.output);
 		const format = resolveTranscriptFormat(commandFlags.format);
 		debug(config.debug, "format", format);
-		console.log("Reading Granola cache file...");
-		const cacheData = parseCacheContents(await readFile(config.transcripts.cacheFile, "utf8"));
-		const transcriptCount = Object.values(cacheData.transcripts).filter((segments) => segments.length > 0).length;
-		console.log(`Exporting ${transcriptCount} transcripts to ${config.transcripts.output}...`);
-		const written = await writeTranscripts(cacheData, config.transcripts.output, format);
-		console.log("✓ Export completed successfully");
-		debug(config.debug, "transcripts written", written);
+		const app = await createGranolaApp(config);
+		debug(config.debug, "authMode", app.getState().auth.mode);
+		const result = await app.exportTranscripts(format);
+		console.log(`✓ Exported ${result.transcriptCount} transcripts to ${result.outputDir}`);
+		debug(config.debug, "transcripts written", result.written);
 		return 0;
 	}
 };
@@ -1908,9 +2142,9 @@ function splitCommand(argv) {
 }
 function rootHelp() {
 	const commandWidth = Math.max(...commands.map((command) => command.name.length));
-	return `Granola CLI
+	return `Granola Toolkit
 
-Export your Granola notes and transcripts.
+Work with Granola meetings, notes, and transcripts.
 
 Usage:
   granola <command> [options]

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "granola-toolkit",
-  "version": "0.14.0",
-  "description": "CLI toolkit for exporting and working with Granola notes and transcripts",
+  "version": "0.16.0",
+  "description": "Toolkit for exporting and working with Granola meetings, notes, and transcripts",
   "keywords": [
     "cli",
     "granola",
@@ -18,7 +18,8 @@
     "url": "git+https://github.com/kkarimi/granola-toolkit.git"
   },
   "bin": {
-    "granola": "dist/cli.js"
+    "granola": "dist/cli.js",
+    "granola-toolkit": "dist/cli.js"
   },
   "files": [
     "README.md",