granola-toolkit 0.13.0 → 0.14.0

package/README.md

@@ -81,6 +81,8 @@ Inspect individual meetings:
 granola meeting list --limit 10
 granola meeting list --search planning
 granola meeting view 1234abcd
+granola meeting notes 1234abcd
+granola meeting transcript 1234abcd --format json
 granola meeting export 1234abcd --format yaml
 ```
 
@@ -143,7 +145,7 @@ The flow is:
 2. fetch documents from Granola's API
 3. optionally load the local cache for transcript data
 4. resolve a meeting by full id or unique id prefix
-5. render either a list, a human-readable meeting view, or a machine-readable export bundle
+5. render either a list, a combined meeting view, focused notes/transcript output, or a machine-readable export bundle
 
 The human-readable `view` command shows:
 
@@ -151,6 +153,11 @@ The human-readable `view` command shows:
 - the selected notes content
 - transcript lines when the local cache is available
 
+The focused meeting subcommands are:
+
+- `meeting notes` for just the selected note output
+- `meeting transcript` for just the selected transcript output
+
 The machine-readable `export` command includes:
 
 - a meeting summary

package/dist/cli.js

@@ -327,14 +327,22 @@ var StoredSessionTokenProvider = class {
 	}
 	async invalidate() {
 		const session = await this.loadSession().catch(() => void 0);
-		if (session?.refreshToken && session.clientId) {
+		if (session?.refreshToken && session.clientId) try {
 			const refreshedSession = await refreshGranolaSession(session, this.options.fetchImpl);
 			this.#session = refreshedSession;
 			await this.store.writeSession(refreshedSession);
 			return;
+		} catch {
+			if (!this.options.source) {
+				this.#session = void 0;
+				await this.store.clearSession();
+				throw new Error("failed to refresh stored Granola session");
+			}
 		}
 		if (this.options.source) {
-			this.#session = await this.options.source.loadSession();
+			const sourcedSession = await this.options.source.loadSession();
+			this.#session = sourcedSession;
+			await this.store.writeSession(sourcedSession);
 			return;
 		}
 		this.#session = void 0;
@@ -1361,6 +1369,7 @@ function buildMeetingTranscript(document, cacheData) {
 		loaded: false,
 		segmentCount: 0,
 		transcript: null,
+		transcriptRecord: null,
 		transcriptText: null
 	};
 	const rawSegments = cacheData.transcripts[document.id] ?? [];
@@ -1369,6 +1378,7 @@ function buildMeetingTranscript(document, cacheData) {
 		loaded: true,
 		segmentCount: 0,
 		transcript: null,
+		transcriptRecord: null,
 		transcriptText: null
 	};
 	const transcript = buildTranscriptExport(cacheDocumentForMeeting(document, cacheData), normalisedSegments, rawSegments);
@@ -1376,6 +1386,7 @@ function buildMeetingTranscript(document, cacheData) {
 		loaded: true,
 		segmentCount: transcript.segments.length,
 		transcript: serialiseTranscript(transcript),
+		transcriptRecord: transcript,
 		transcriptText: renderTranscriptExport(transcript, "text")
 	};
 }
@@ -1504,6 +1515,14 @@ function renderMeetingExport(record, format = "json") {
 		case "yaml": return toYaml(record);
 	}
 }
+function renderMeetingNotes(document, format = "markdown") {
+	return renderNoteExport(buildNoteExport(document), format);
+}
+function renderMeetingTranscript(document, cacheData, format = "text") {
+	const transcript = buildMeetingTranscript(document, cacheData).transcriptRecord;
+	if (!transcript) return "";
+	return renderTranscriptExport(transcript, format);
+}
 //#endregion
 //#region src/commands/shared.ts
 function debug(enabled, ...values) {
@@ -1515,16 +1534,18 @@ function meetingHelp() {
 	return `Granola meeting
 
 Usage:
-  granola meeting <list|view|export> [options]
+  granola meeting <list|view|export|notes|transcript> [options]
 
 Subcommands:
   list                List meetings from the Granola API
   view <id>           Show a single meeting with notes and transcript text
   export <id>         Export a single meeting as JSON or YAML
+  notes <id>          Show a single meeting's notes
+  transcript <id>     Show a single meeting's transcript
 
 Options:
   --cache <path>      Path to Granola cache JSON for transcript data
-  --format <value>    list/view: text, json, yaml; export: json, yaml
+  --format <value>    list/view: text, json, yaml; export: json, yaml; notes: markdown, json, yaml, raw; transcript: text, json, yaml, raw
   --limit <n>         Number of meetings for list (default: 20)
   --search <query>    Filter list by title, id, or tag
   --timeout <value>   Request timeout, e.g. 2m, 30s, 120000 (default: 2m)
@@ -1560,6 +1581,26 @@ function resolveExportFormat(value) {
 		default: throw new Error("invalid meeting export format: expected json or yaml");
 	}
 }
+function resolveNotesFormat(value) {
+	switch (value) {
+		case void 0: return "markdown";
+		case "json":
+		case "markdown":
+		case "raw":
+		case "yaml": return value;
+		default: throw new Error("invalid meeting notes format: expected markdown, json, yaml, or raw");
+	}
+}
+function resolveTranscriptFormat$1(value) {
+	switch (value) {
+		case void 0: return "text";
+		case "json":
+		case "raw":
+		case "text":
+		case "yaml": return value;
+		default: throw new Error("invalid meeting transcript format: expected text, json, yaml, or raw");
+	}
+}
 function parseLimit(value) {
 	if (value === void 0) return 20;
 	if (typeof value !== "string" || !/^\d+$/.test(value)) throw new Error("invalid meeting limit: expected a positive integer");
@@ -1589,18 +1630,25 @@ const meetingCommand = {
 			case "export":
 				if (!id) throw new Error("meeting export requires an id");
 				return await exportMeeting(id, commandFlags, globalFlags);
+			case "notes":
+				if (!id) throw new Error("meeting notes requires an id");
+				return await notes(id, commandFlags, globalFlags);
+			case "transcript":
+				if (!id) throw new Error("meeting transcript requires an id");
+				return await transcript(id, commandFlags, globalFlags);
 			case void 0:
 				console.log(meetingHelp());
 				return 1;
-			default: throw new Error("invalid meeting command: expected list, view, or export");
+			default: throw new Error("invalid meeting command: expected list, view, export, notes, or transcript");
 		}
 	}
 };
-async function loadMeetingData(commandFlags, globalFlags) {
+async function loadMeetingData(commandFlags, globalFlags, options = {}) {
 	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);
@@ -1613,6 +1661,15 @@ async function loadMeetingData(commandFlags, globalFlags) {
 		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);
@@ -1629,20 +1686,32 @@ async function list(commandFlags, globalFlags) {
 }
 async function view(id, commandFlags, globalFlags) {
 	const format = resolveViewFormat(commandFlags.format);
-	const { cacheData, config, granolaClient } = await loadMeetingData(commandFlags, globalFlags);
-	console.log("Fetching meeting from Granola API...");
-	const meeting = buildMeetingRecord(resolveMeeting(await granolaClient.listDocuments({ timeoutMs: config.notes.timeoutMs }), id), cacheData);
+	const { cacheData, document } = await loadResolvedMeeting(id, commandFlags, globalFlags);
+	const meeting = buildMeetingRecord(document, cacheData);
 	console.log(renderMeetingView(meeting, format).trimEnd());
 	return 0;
 }
 async function exportMeeting(id, commandFlags, globalFlags) {
 	const format = resolveExportFormat(commandFlags.format);
-	const { cacheData, config, granolaClient } = await loadMeetingData(commandFlags, globalFlags);
-	console.log("Fetching meeting from Granola API...");
-	const meeting = buildMeetingRecord(resolveMeeting(await granolaClient.listDocuments({ timeoutMs: config.notes.timeoutMs }), id), cacheData);
+	const { cacheData, document } = await loadResolvedMeeting(id, commandFlags, globalFlags);
+	const meeting = buildMeetingRecord(document, cacheData);
 	console.log(renderMeetingExport(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());
+	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}`);
+	console.log(output.trimEnd());
+	return 0;
+}
 //#endregion
 //#region src/commands/notes.ts
 function notesHelp() {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "granola-toolkit",
-  "version": "0.13.0",
+  "version": "0.14.0",
   "description": "CLI toolkit for exporting and working with Granola notes and transcripts",
   "keywords": [
     "cli",