@rnsk/toolkits 0.0.9 → 0.0.11

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

@@ -0,0 +1,516 @@
+import { addTextSources } from './add-text-sources.js';
+import { createAudioOverview } from './create-audio-overview.js';
+import { createNotebook } from './create-notebook.js';
+import { deleteAudioOverview } from './delete-audio-overview.js';
+import { deleteNotebooks } from './delete-notebooks.js';
+import { deleteSources } from './delete-sources.js';
+import { getNotebook } from './get-notebook.js';
+import { getSource } from './get-source.js';
+import { listRecentNotebooks } from './list-recent-notebooks.js';
+import { shareNotebook } from './share-notebook.js';
+import { uploadSourceFile } from './upload-source-file.js';
+export { addTextSources, createAudioOverview, createNotebook, deleteAudioOverview, deleteNotebooks, deleteSources, getNotebook, getSource, listRecentNotebooks, shareNotebook, uploadSourceFile, };
+export declare const notebookLmTools: ({
+    name: string;
+    description: string;
+    tool: import("ai").Tool<{
+        title: string;
+        notebookLmToken: string;
+        location?: string | undefined;
+        endpointLocation?: string | undefined;
+        projectNumber?: string | undefined;
+    }, {
+        error: string;
+        details?: undefined;
+        notebookId?: undefined;
+        name?: undefined;
+        title?: undefined;
+        emoji?: undefined;
+        metadata?: undefined;
+        sources?: undefined;
+        raw?: undefined;
+        message?: undefined;
+    } | {
+        error: string;
+        details: unknown;
+        notebookId?: undefined;
+        name?: undefined;
+        title?: undefined;
+        emoji?: undefined;
+        metadata?: undefined;
+        sources?: undefined;
+        raw?: undefined;
+        message?: undefined;
+    } | {
+        notebookId: any;
+        name: any;
+        title: any;
+        emoji: any;
+        metadata: any;
+        sources: any;
+        raw: any;
+        error?: undefined;
+        details?: undefined;
+        message?: undefined;
+    } | {
+        error: string;
+        message: string;
+        details?: undefined;
+        notebookId?: undefined;
+        name?: undefined;
+        title?: undefined;
+        emoji?: undefined;
+        metadata?: undefined;
+        sources?: undefined;
+        raw?: undefined;
+    }>;
+    requiredAuth: "notebookLmToken";
+    scope: "write";
+} | {
+    name: string;
+    description: string;
+    tool: 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;
+    }>;
+    requiredAuth: "notebookLmToken";
+    scope: "read";
+} | {
+    name: string;
+    description: string;
+    tool: import("ai").Tool<{
+        notebookLmToken: string;
+        location?: string | undefined;
+        pageSize?: number | undefined;
+        endpointLocation?: string | undefined;
+        projectNumber?: string | undefined;
+    }, {
+        error: string;
+        details?: undefined;
+        notebooks?: undefined;
+        raw?: undefined;
+        message?: undefined;
+    } | {
+        error: string;
+        details: unknown;
+        notebooks?: undefined;
+        raw?: undefined;
+        message?: undefined;
+    } | {
+        notebooks: any;
+        raw: any;
+        error?: undefined;
+        details?: undefined;
+        message?: undefined;
+    } | {
+        error: string;
+        message: string;
+        details?: undefined;
+        notebooks?: undefined;
+        raw?: undefined;
+    }>;
+    requiredAuth: "notebookLmToken";
+    scope: "read";
+} | {
+    name: string;
+    description: string;
+    tool: 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;
+    }>;
+    requiredAuth: "notebookLmToken";
+    scope: "delete";
+} | {
+    name: string;
+    description: string;
+    tool: import("ai").Tool<{
+        notebookLmToken: string;
+        notebookId: string;
+        shares: {
+            email: string;
+            role: "owner" | "writer" | "reader" | "not_shared";
+        }[];
+        location?: string | undefined;
+        endpointLocation?: string | undefined;
+        projectNumber?: string | undefined;
+        notifyViaEmail?: boolean | undefined;
+    }, {
+        error: string;
+        details?: undefined;
+        notebookId?: undefined;
+        affectedAccounts?: undefined;
+        notifyViaEmail?: undefined;
+        raw?: undefined;
+        message?: undefined;
+    } | {
+        error: string;
+        details: unknown;
+        notebookId?: undefined;
+        affectedAccounts?: undefined;
+        notifyViaEmail?: undefined;
+        raw?: undefined;
+        message?: undefined;
+    } | {
+        notebookId: string;
+        affectedAccounts: {
+            email: string;
+            role: "owner" | "writer" | "reader" | "not_shared";
+        }[];
+        notifyViaEmail: boolean;
+        raw: unknown;
+        error?: undefined;
+        details?: undefined;
+        message?: undefined;
+    } | {
+        error: string;
+        message: string;
+        details?: undefined;
+        notebookId?: undefined;
+        affectedAccounts?: undefined;
+        notifyViaEmail?: undefined;
+        raw?: undefined;
+    }>;
+    requiredAuth: "notebookLmToken";
+    scope: "write";
+} | {
+    name: string;
+    description: string;
+    tool: import("ai").Tool<{
+        sources: {
+            content: string;
+            sourceName: string;
+        }[];
+        notebookLmToken: string;
+        notebookId: string;
+        location?: string | undefined;
+        endpointLocation?: string | undefined;
+        projectNumber?: string | undefined;
+    }, {
+        error: string;
+        details?: undefined;
+        sources?: undefined;
+        raw?: undefined;
+        message?: undefined;
+    } | {
+        error: string;
+        details: unknown;
+        sources?: undefined;
+        raw?: undefined;
+        message?: undefined;
+    } | {
+        sources: any;
+        raw: any;
+        error?: undefined;
+        details?: undefined;
+        message?: undefined;
+    } | {
+        error: string;
+        message: string;
+        details?: undefined;
+        sources?: undefined;
+        raw?: undefined;
+    }>;
+    requiredAuth: "notebookLmToken";
+    scope: "write";
+} | {
+    name: string;
+    description: string;
+    tool: import("ai").Tool<{
+        fileName: string;
+        notebookLmToken: string;
+        notebookId: string;
+        location?: string | undefined;
+        file?: {
+            name: string;
+            mimetype: string;
+            s3key: string;
+        } | undefined;
+        mimeType?: string | undefined;
+        fileContent?: string | undefined;
+        endpointLocation?: string | undefined;
+        projectNumber?: string | undefined;
+    }, {
+        error: string;
+        details?: undefined;
+        sourceId?: undefined;
+        raw?: undefined;
+        message?: undefined;
+    } | {
+        error: string;
+        details: unknown;
+        sourceId?: undefined;
+        raw?: undefined;
+        message?: undefined;
+    } | {
+        sourceId: any;
+        raw: any;
+        error?: undefined;
+        details?: undefined;
+        message?: undefined;
+    } | {
+        error: string;
+        message: string;
+        details?: undefined;
+        sourceId?: undefined;
+        raw?: undefined;
+    }>;
+    requiredAuth: "notebookLmToken";
+    scope: "write";
+} | {
+    name: string;
+    description: string;
+    tool: 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;
+    }>;
+    requiredAuth: "notebookLmToken";
+    scope: "read";
+} | {
+    name: string;
+    description: string;
+    tool: 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;
+    }>;
+    requiredAuth: "notebookLmToken";
+    scope: "delete";
+} | {
+    name: string;
+    description: string;
+    tool: import("ai").Tool<{
+        notebookLmToken: string;
+        notebookId: string;
+        sourceIds: string[];
+        location?: string | undefined;
+        languageCode?: string | undefined;
+        endpointLocation?: string | undefined;
+        projectNumber?: string | undefined;
+        episodeFocus?: string | undefined;
+    }, {
+        error: string;
+        details?: undefined;
+        audioOverviewId?: undefined;
+        name?: undefined;
+        status?: undefined;
+        generationOptions?: undefined;
+        raw?: undefined;
+        message?: undefined;
+    } | {
+        error: string;
+        details: unknown;
+        audioOverviewId?: undefined;
+        name?: undefined;
+        status?: undefined;
+        generationOptions?: undefined;
+        raw?: undefined;
+        message?: undefined;
+    } | {
+        audioOverviewId: any;
+        name: any;
+        status: any;
+        generationOptions: any;
+        raw: any;
+        error?: undefined;
+        details?: undefined;
+        message?: undefined;
+    } | {
+        error: string;
+        message: string;
+        details?: undefined;
+        audioOverviewId?: undefined;
+        name?: undefined;
+        status?: undefined;
+        generationOptions?: undefined;
+        raw?: undefined;
+    }>;
+    requiredAuth: "notebookLmToken";
+    scope: "write";
+} | {
+    name: string;
+    description: string;
+    tool: import("ai").Tool<{
+        notebookLmToken: string;
+        notebookId: string;
+        audioOverviewId: string;
+        location?: string | undefined;
+        endpointLocation?: string | undefined;
+        projectNumber?: string | undefined;
+    }, {
+        error: string;
+        details?: undefined;
+        deletedAudioOverviewId?: undefined;
+        raw?: undefined;
+        message?: undefined;
+    } | {
+        error: string;
+        details: unknown;
+        deletedAudioOverviewId?: undefined;
+        raw?: undefined;
+        message?: undefined;
+    } | {
+        deletedAudioOverviewId: string;
+        raw: unknown;
+        error?: undefined;
+        details?: undefined;
+        message?: undefined;
+    } | {
+        error: string;
+        message: string;
+        details?: undefined;
+        deletedAudioOverviewId?: undefined;
+        raw?: undefined;
+    }>;
+    requiredAuth: "notebookLmToken";
+    scope: "delete";
+})[];
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1,93 @@
+// @ts-nocheck
+import { addTextSources } from './add-text-sources.js';
+import { createAudioOverview } from './create-audio-overview.js';
+import { createNotebook } from './create-notebook.js';
+import { deleteAudioOverview } from './delete-audio-overview.js';
+import { deleteNotebooks } from './delete-notebooks.js';
+import { deleteSources } from './delete-sources.js';
+import { getNotebook } from './get-notebook.js';
+import { getSource } from './get-source.js';
+import { listRecentNotebooks } from './list-recent-notebooks.js';
+import { shareNotebook } from './share-notebook.js';
+import { uploadSourceFile } from './upload-source-file.js';
+export { addTextSources, createAudioOverview, createNotebook, deleteAudioOverview, deleteNotebooks, deleteSources, getNotebook, getSource, listRecentNotebooks, shareNotebook, uploadSourceFile, };
+export const notebookLmTools = [
+    {
+        name: 'notebookLmCreateNotebook',
+        description: 'Create a NotebookLM Enterprise notebook in a licensed Google Cloud project and location.',
+        tool: createNotebook,
+        requiredAuth: 'notebookLmToken',
+        scope: 'write',
+    },
+    {
+        name: 'notebookLmGetNotebook',
+        description: 'Retrieve a NotebookLM Enterprise notebook and its current source metadata.',
+        tool: getNotebook,
+        requiredAuth: 'notebookLmToken',
+        scope: 'read',
+    },
+    {
+        name: 'notebookLmListRecentNotebooks',
+        description: 'List up to 500 NotebookLM Enterprise notebooks ordered by when the connected user last viewed them.',
+        tool: listRecentNotebooks,
+        requiredAuth: 'notebookLmToken',
+        scope: 'read',
+    },
+    {
+        name: 'notebookLmDeleteNotebooks',
+        description: 'Permanently delete one or more NotebookLM Enterprise notebooks by notebook ID.',
+        tool: deleteNotebooks,
+        requiredAuth: 'notebookLmToken',
+        scope: 'delete',
+    },
+    {
+        name: 'notebookLmShareNotebook',
+        description: 'Grant, change, or remove account access to a NotebookLM Enterprise notebook.',
+        tool: shareNotebook,
+        requiredAuth: 'notebookLmToken',
+        scope: 'write',
+    },
+    {
+        name: 'notebookLmAddTextSources',
+        description: 'Add one or more named raw-text sources to a NotebookLM Enterprise notebook.',
+        tool: addTextSources,
+        requiredAuth: 'notebookLmToken',
+        scope: 'write',
+    },
+    {
+        name: 'notebookLmUploadSourceFile',
+        description: 'Upload a plain-text file as a source in a NotebookLM Enterprise notebook.',
+        tool: uploadSourceFile,
+        requiredAuth: 'notebookLmToken',
+        scope: 'write',
+    },
+    {
+        name: 'notebookLmGetSource',
+        description: 'Retrieve a notebook source ingestion status, metadata, and failure reason.',
+        tool: getSource,
+        requiredAuth: 'notebookLmToken',
+        scope: 'read',
+    },
+    {
+        name: 'notebookLmDeleteSources',
+        description: 'Permanently remove one or more sources from a NotebookLM Enterprise notebook.',
+        tool: deleteSources,
+        requiredAuth: 'notebookLmToken',
+        scope: 'delete',
+    },
+    {
+        name: 'notebookLmCreateAudioOverview',
+        description: 'Start asynchronous generation of a NotebookLM Enterprise audio overview from selected notebook sources.',
+        tool: createAudioOverview,
+        requiredAuth: 'notebookLmToken',
+        scope: 'write',
+    },
+    {
+        name: 'notebookLmDeleteAudioOverview',
+        description: 'Permanently delete an audio overview from a NotebookLM Enterprise notebook. If still generating, this permanently cancels generation.',
+        tool: deleteAudioOverview,
+        requiredAuth: 'notebookLmToken',
+        scope: 'delete',
+    },
+];
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1,32 @@
+export declare const listRecentNotebooks: import("ai").Tool<{
+    notebookLmToken: string;
+    location?: string | undefined;
+    pageSize?: number | undefined;
+    endpointLocation?: string | undefined;
+    projectNumber?: string | undefined;
+}, {
+    error: string;
+    details?: undefined;
+    notebooks?: undefined;
+    raw?: undefined;
+    message?: undefined;
+} | {
+    error: string;
+    details: unknown;
+    notebooks?: undefined;
+    raw?: undefined;
+    message?: undefined;
+} | {
+    notebooks: any;
+    raw: any;
+    error?: undefined;
+    details?: undefined;
+    message?: undefined;
+} | {
+    error: string;
+    message: string;
+    details?: undefined;
+    notebooks?: undefined;
+    raw?: undefined;
+}>;
+//# sourceMappingURL=list-recent-notebooks.d.ts.map

package/dist/toolkits/notebook-lm/tools/list-recent-notebooks.js

@@ -0,0 +1,41 @@
+// @ts-nocheck
+import { tool } from 'ai';
+import { z } from 'zod';
+import { buildParent, getEndpoint, parseResponseError } from './utils.js';
+export const listRecentNotebooks = tool({
+    description: 'List up to 500 NotebookLM Enterprise notebooks ordered by when the connected user last viewed them. Google currently omits continuation tokens, so accounts with more than 500 notebooks may not expose older results.',
+    inputSchema: z.object({
+        notebookLmToken: z.string().describe('NotebookLM OAuth access token.'),
+        location: z.string().optional().describe('Location, defaults to global.'),
+        endpointLocation: z.string().optional().describe('Endpoint multi-region us/eu/global, defaults to global.'),
+        projectNumber: z.string().optional().describe('Project number, defaults to -.'),
+        pageSize: z.number().optional().describe('Optional page size for pagination, when supported.'),
+    }),
+    execute: async ({ notebookLmToken, location, endpointLocation, projectNumber, pageSize }) => {
+        if (!notebookLmToken)
+            return { error: 'NotebookLM token is required. Connect NotebookLM first.' };
+        try {
+            const endpoint = getEndpoint(endpointLocation || location);
+            const parent = buildParent(projectNumber, location);
+            const params = new URLSearchParams();
+            if (pageSize)
+                params.set('pageSize', String(pageSize));
+            const query = params.toString() ? `?${params.toString()}` : '';
+            const url = `${endpoint}/${parent}/notebooks:listRecentlyViewed${query}`;
+            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 list recent notebooks', details: err.details };
+            }
+            const data = await response.json();
+            return { notebooks: data.notebooks || [], raw: data };
+        }
+        catch (error) {
+            return { error: 'Error listing notebooks', message: error instanceof Error ? error.message : 'Unknown error' };
+        }
+    },
+});
+//# sourceMappingURL=list-recent-notebooks.js.map