@rnsk/toolkits 0.0.9 → 0.0.11

package/dist/toolkits/notebook-lm/tools/delete-audio-overview.js

@@ -0,0 +1,46 @@
+// @ts-nocheck
+import { tool } from 'ai';
+import { z } from 'zod';
+import { buildNotebookName, getEndpoint, parseResponseError } from './utils.js';
+export const deleteAudioOverview = tool({
+    description: 'Permanently delete an audio overview from a NotebookLM Enterprise notebook. If still generating, this permanently cancels generation. Cannot be undone.',
+    inputSchema: z.object({
+        notebookLmToken: z.string().describe('NotebookLM OAuth access token.'),
+        notebookId: z.string().min(1).describe('Notebook UUID or full resource name containing the audio overview.'),
+        audioOverviewId: z.string().min(1).describe('Audio overview UUID to delete. If generation is in progress, deletion cancels it. Use default to delete the single overview per notebook.'),
+        location: z.string().optional().describe('Location override, defaults to global.'),
+        endpointLocation: z.string().optional().describe('Endpoint multi-region, defaults to global.'),
+        projectNumber: z.string().optional().describe('Project number, defaults to -.'),
+    }),
+    execute: async ({ notebookLmToken, notebookId, audioOverviewId, location, endpointLocation, projectNumber }) => {
+        if (!notebookLmToken)
+            return { error: 'NotebookLM token is required. Connect NotebookLM first.' };
+        try {
+            const endpoint = getEndpoint(endpointLocation || location);
+            const notebookName = buildNotebookName(notebookId, projectNumber, location);
+            const id = audioOverviewId === 'default' || audioOverviewId.includes('/') ? audioOverviewId : 'default';
+            const url = `${endpoint}/${notebookName}/audioOverviews/${id}`;
+            const response = await fetch(url, {
+                method: 'DELETE',
+                headers: { Authorization: `Bearer ${notebookLmToken}` },
+            });
+            if (!response.ok) {
+                const err = await parseResponseError(response);
+                return { error: 'Failed to delete audio overview', details: err.details };
+            }
+            const text = await response.text();
+            let data = {};
+            try {
+                data = text ? JSON.parse(text) : {};
+            }
+            catch {
+                data = text;
+            }
+            return { deletedAudioOverviewId: audioOverviewId, raw: data };
+        }
+        catch (error) {
+            return { error: 'Error deleting audio overview', message: error instanceof Error ? error.message : 'Unknown error' };
+        }
+    },
+});
+//# sourceMappingURL=delete-audio-overview.js.map

package/dist/toolkits/notebook-lm/tools/delete-notebooks.d.ts

@@ -0,0 +1,32 @@
+export declare const deleteNotebooks: import("ai").Tool<{
+    notebookLmToken: string;
+    notebookIds: string[];
+    location?: string | undefined;
+    endpointLocation?: string | undefined;
+    projectNumber?: string | undefined;
+}, {
+    error: string;
+    details?: undefined;
+    deletedNotebookIds?: undefined;
+    raw?: undefined;
+    message?: undefined;
+} | {
+    error: string;
+    details: unknown;
+    deletedNotebookIds?: undefined;
+    raw?: undefined;
+    message?: undefined;
+} | {
+    deletedNotebookIds: string[];
+    raw: unknown;
+    error?: undefined;
+    details?: undefined;
+    message?: undefined;
+} | {
+    error: string;
+    message: string;
+    details?: undefined;
+    deletedNotebookIds?: undefined;
+    raw?: undefined;
+}>;
+//# sourceMappingURL=delete-notebooks.d.ts.map

package/dist/toolkits/notebook-lm/tools/delete-notebooks.js

@@ -0,0 +1,46 @@
+// @ts-nocheck
+import { tool } from 'ai';
+import { z } from 'zod';
+import { buildNotebookName, buildParent, getEndpoint, parseResponseError } from './utils.js';
+export const deleteNotebooks = tool({
+    description: 'Permanently delete one or more NotebookLM Enterprise notebooks by notebook ID. Handles Google single-notebook batchDelete limit by normalizing to full resource names.',
+    inputSchema: z.object({
+        notebookLmToken: z.string().describe('NotebookLM OAuth access token.'),
+        notebookIds: z.array(z.string().min(1)).min(1).max(100).describe('One to 100 notebook UUIDs or full resource names to permanently delete.'),
+        location: z.string().optional().describe('Location override, defaults to global. Used when notebookIds are UUIDs.'),
+        endpointLocation: z.string().optional().describe('Endpoint multi-region, defaults to global.'),
+        projectNumber: z.string().optional().describe('Project number, defaults to -.'),
+    }),
+    execute: async ({ notebookLmToken, notebookIds, location, endpointLocation, projectNumber }) => {
+        if (!notebookLmToken)
+            return { error: 'NotebookLM token is required. Connect NotebookLM first.' };
+        try {
+            const endpoint = getEndpoint(endpointLocation || location);
+            const parent = buildParent(projectNumber, location);
+            const names = notebookIds.map((id) => buildNotebookName(id, projectNumber, location));
+            const url = `${endpoint}/${parent}/notebooks:batchDelete`;
+            const response = await fetch(url, {
+                method: 'POST',
+                headers: { Authorization: `Bearer ${notebookLmToken}`, 'Content-Type': 'application/json' },
+                body: JSON.stringify({ names }),
+            });
+            if (!response.ok) {
+                const err = await parseResponseError(response);
+                return { error: 'Failed to delete notebooks', details: err.details };
+            }
+            const text = await response.text();
+            let data = {};
+            try {
+                data = text ? JSON.parse(text) : {};
+            }
+            catch {
+                data = text;
+            }
+            return { deletedNotebookIds: notebookIds, raw: data };
+        }
+        catch (error) {
+            return { error: 'Error deleting notebooks', message: error instanceof Error ? error.message : 'Unknown error' };
+        }
+    },
+});
+//# sourceMappingURL=delete-notebooks.js.map

package/dist/toolkits/notebook-lm/tools/delete-sources.d.ts

@@ -0,0 +1,33 @@
+export declare const deleteSources: import("ai").Tool<{
+    notebookLmToken: string;
+    notebookId: string;
+    sourceIds: string[];
+    location?: string | undefined;
+    endpointLocation?: string | undefined;
+    projectNumber?: string | undefined;
+}, {
+    error: string;
+    details?: undefined;
+    deletedSourceIds?: undefined;
+    raw?: undefined;
+    message?: undefined;
+} | {
+    error: string;
+    details: unknown;
+    deletedSourceIds?: undefined;
+    raw?: undefined;
+    message?: undefined;
+} | {
+    deletedSourceIds: string[];
+    raw: unknown;
+    error?: undefined;
+    details?: undefined;
+    message?: undefined;
+} | {
+    error: string;
+    message: string;
+    details?: undefined;
+    deletedSourceIds?: undefined;
+    raw?: undefined;
+}>;
+//# sourceMappingURL=delete-sources.d.ts.map

package/dist/toolkits/notebook-lm/tools/delete-sources.js

@@ -0,0 +1,47 @@
+// @ts-nocheck
+import { tool } from 'ai';
+import { z } from 'zod';
+import { buildNotebookName, buildSourceName, getEndpoint, parseResponseError } from './utils.js';
+export const deleteSources = tool({
+    description: 'Permanently remove one or more sources from a NotebookLM Enterprise notebook.',
+    inputSchema: z.object({
+        notebookLmToken: z.string().describe('NotebookLM OAuth access token.'),
+        notebookId: z.string().min(1).describe('Notebook UUID or full resource name containing the sources.'),
+        sourceIds: z.array(z.string().min(1)).min(1).describe('Source UUIDs or full resource names to permanently remove.'),
+        location: z.string().optional().describe('Location override, defaults to global.'),
+        endpointLocation: z.string().optional().describe('Endpoint multi-region, defaults to global.'),
+        projectNumber: z.string().optional().describe('Project number, defaults to -.'),
+    }),
+    execute: async ({ notebookLmToken, notebookId, sourceIds, location, endpointLocation, projectNumber }) => {
+        if (!notebookLmToken)
+            return { error: 'NotebookLM token is required. Connect NotebookLM first.' };
+        try {
+            const endpoint = getEndpoint(endpointLocation || location);
+            const notebookName = buildNotebookName(notebookId, projectNumber, location);
+            const names = sourceIds.map((sid) => buildSourceName(notebookId, sid, projectNumber, location));
+            const url = `${endpoint}/${notebookName}/sources:batchDelete`;
+            const response = await fetch(url, {
+                method: 'POST',
+                headers: { Authorization: `Bearer ${notebookLmToken}`, 'Content-Type': 'application/json' },
+                body: JSON.stringify({ names }),
+            });
+            if (!response.ok) {
+                const err = await parseResponseError(response);
+                return { error: 'Failed to delete sources', details: err.details };
+            }
+            const text = await response.text();
+            let data = {};
+            try {
+                data = text ? JSON.parse(text) : {};
+            }
+            catch {
+                data = text;
+            }
+            return { deletedSourceIds: sourceIds, raw: data };
+        }
+        catch (error) {
+            return { error: 'Error deleting sources', message: error instanceof Error ? error.message : 'Unknown error' };
+        }
+    },
+});
+//# sourceMappingURL=delete-sources.js.map

package/dist/toolkits/notebook-lm/tools/get-notebook.d.ts

@@ -0,0 +1,52 @@
+export declare const getNotebook: import("ai").Tool<{
+    notebookLmToken: string;
+    notebookId: string;
+    location?: string | undefined;
+    endpointLocation?: string | undefined;
+    projectNumber?: string | undefined;
+}, {
+    error: string;
+    details?: undefined;
+    notebookId?: undefined;
+    name?: undefined;
+    title?: undefined;
+    emoji?: undefined;
+    sources?: undefined;
+    metadata?: undefined;
+    raw?: undefined;
+    message?: undefined;
+} | {
+    error: string;
+    details: unknown;
+    notebookId?: undefined;
+    name?: undefined;
+    title?: undefined;
+    emoji?: undefined;
+    sources?: undefined;
+    metadata?: undefined;
+    raw?: undefined;
+    message?: undefined;
+} | {
+    notebookId: any;
+    name: any;
+    title: any;
+    emoji: any;
+    sources: any;
+    metadata: any;
+    raw: any;
+    error?: undefined;
+    details?: undefined;
+    message?: undefined;
+} | {
+    error: string;
+    message: string;
+    details?: undefined;
+    notebookId?: undefined;
+    name?: undefined;
+    title?: undefined;
+    emoji?: undefined;
+    sources?: undefined;
+    metadata?: undefined;
+    raw?: undefined;
+}>;
+//# sourceMappingURL=get-notebook.d.ts.map

package/dist/toolkits/notebook-lm/tools/get-notebook.js

@@ -0,0 +1,45 @@
+// @ts-nocheck
+import { tool } from 'ai';
+import { z } from 'zod';
+import { buildNotebookName, getEndpoint, parseResponseError } from './utils.js';
+export const getNotebook = tool({
+    description: 'Retrieve a NotebookLM Enterprise notebook and its current source metadata by notebook ID.',
+    inputSchema: z.object({
+        notebookLmToken: z.string().describe('NotebookLM OAuth access token.'),
+        notebookId: z.string().min(1).describe('Notebook UUID or full resource name projects/PROJECT/locations/LOCATION/notebooks/NOTEBOOK_ID.'),
+        location: z.string().optional().describe('Location override, defaults to global. Ignored if notebookId is full resource name.'),
+        endpointLocation: z.string().optional().describe('Endpoint multi-region us/eu/global, defaults to global.'),
+        projectNumber: z.string().optional().describe('Project number override, defaults to -. Ignored if notebookId is full name.'),
+    }),
+    execute: async ({ notebookLmToken, notebookId, location, endpointLocation, projectNumber }) => {
+        if (!notebookLmToken)
+            return { error: 'NotebookLM token is required. Connect NotebookLM first.' };
+        try {
+            const endpoint = getEndpoint(endpointLocation || location);
+            const name = buildNotebookName(notebookId, projectNumber, location);
+            const url = `${endpoint}/${name}`;
+            const response = await fetch(url, {
+                method: 'GET',
+                headers: { Authorization: `Bearer ${notebookLmToken}`, 'Content-Type': 'application/json' },
+            });
+            if (!response.ok) {
+                const err = await parseResponseError(response);
+                return { error: 'Failed to get notebook', details: err.details };
+            }
+            const data = await response.json();
+            return {
+                notebookId: data.notebookId || data.name?.split('/').pop() || notebookId,
+                name: data.name,
+                title: data.title,
+                emoji: data.emoji,
+                sources: data.sources,
+                metadata: data.metadata,
+                raw: data,
+            };
+        }
+        catch (error) {
+            return { error: 'Error getting notebook', message: error instanceof Error ? error.message : 'Unknown error' };
+        }
+    },
+});
+//# sourceMappingURL=get-notebook.js.map

package/dist/toolkits/notebook-lm/tools/get-source.d.ts

@@ -0,0 +1,53 @@
+export declare const getSource: import("ai").Tool<{
+    notebookLmToken: string;
+    notebookId: string;
+    sourceId: string;
+    location?: string | undefined;
+    endpointLocation?: string | undefined;
+    projectNumber?: string | undefined;
+}, {
+    error: string;
+    details?: undefined;
+    sourceId?: undefined;
+    name?: undefined;
+    title?: undefined;
+    metadata?: undefined;
+    ingestionStatus?: undefined;
+    failureReason?: undefined;
+    raw?: undefined;
+    message?: undefined;
+} | {
+    error: string;
+    details: unknown;
+    sourceId?: undefined;
+    name?: undefined;
+    title?: undefined;
+    metadata?: undefined;
+    ingestionStatus?: undefined;
+    failureReason?: undefined;
+    raw?: undefined;
+    message?: undefined;
+} | {
+    sourceId: any;
+    name: any;
+    title: any;
+    metadata: any;
+    ingestionStatus: any;
+    failureReason: any;
+    raw: any;
+    error?: undefined;
+    details?: undefined;
+    message?: undefined;
+} | {
+    error: string;
+    message: string;
+    details?: undefined;
+    sourceId?: undefined;
+    name?: undefined;
+    title?: undefined;
+    metadata?: undefined;
+    ingestionStatus?: undefined;
+    failureReason?: undefined;
+    raw?: undefined;
+}>;
+//# sourceMappingURL=get-source.d.ts.map

package/dist/toolkits/notebook-lm/tools/get-source.js

@@ -0,0 +1,47 @@
+// @ts-nocheck
+import { tool } from 'ai';
+import { z } from 'zod';
+import { buildSourceName, getEndpoint, parseResponseError } from './utils.js';
+export const getSource = tool({
+    description: 'Retrieve a notebook source ingestion status, metadata, and failure reason.',
+    inputSchema: z.object({
+        notebookLmToken: z.string().describe('NotebookLM OAuth access token.'),
+        notebookId: z.string().min(1).describe('Notebook UUID or full resource name containing the source.'),
+        sourceId: z.string().min(1).describe('Source UUID or full resource name returned by add text sources or get notebook.'),
+        location: z.string().optional().describe('Location override, defaults to global.'),
+        endpointLocation: z.string().optional().describe('Endpoint multi-region, defaults to global.'),
+        projectNumber: z.string().optional().describe('Project number, defaults to -.'),
+    }),
+    execute: async ({ notebookLmToken, notebookId, sourceId, location, endpointLocation, projectNumber }) => {
+        if (!notebookLmToken)
+            return { error: 'NotebookLM token is required. Connect NotebookLM first.' };
+        try {
+            const endpoint = getEndpoint(endpointLocation || location);
+            const name = buildSourceName(notebookId, sourceId, projectNumber, location);
+            const url = `${endpoint}/${name}`;
+            const response = await fetch(url, {
+                method: 'GET',
+                headers: { Authorization: `Bearer ${notebookLmToken}`, 'Content-Type': 'application/json' },
+            });
+            if (!response.ok) {
+                const err = await parseResponseError(response);
+                return { error: 'Failed to get source', details: err.details };
+            }
+            const data = await response.json();
+            const src = data.sources?.[0] || data;
+            return {
+                sourceId: src.sourceId?.id || src.sourceId || sourceId,
+                name: src.name,
+                title: src.title,
+                metadata: src.metadata,
+                ingestionStatus: src.settings?.status || src.ingestionStatus,
+                failureReason: src.failureReason,
+                raw: data,
+            };
+        }
+        catch (error) {
+            return { error: 'Error getting source', message: error instanceof Error ? error.message : 'Unknown error' };
+        }
+    },
+});
+//# sourceMappingURL=get-source.js.map