@rnsk/toolkits 0.0.2 → 0.0.3

package/dist/toolkits/google-sheets/tools/index.d.ts

@@ -1,11 +1,209 @@
-import { listSpreadsheets } from './list-spreadsheets';
-import { getSpreadsheet } from './get-spreadsheet';
-import { getValues } from './get-values';
-export { listSpreadsheets, getSpreadsheet, getValues };
-export declare const googleSheetsTools: {
+import { listSpreadsheets } from './list-spreadsheets.js';
+import { getSpreadsheet } from './get-spreadsheet.js';
+import { getValues } from './get-values.js';
+import { appendValues } from './append-values.js';
+import { updateValues } from './update-values.js';
+import { clearValues } from './clear-values.js';
+import { createSpreadsheet } from './create-spreadsheet.js';
+export { listSpreadsheets, getSpreadsheet, getValues, appendValues, updateValues, clearValues, createSpreadsheet, };
+export declare const googleSheetsTools: ({
     name: string;
     description: string;
-    tool: any;
+    tool: import("ai").Tool<{
+        googleSheetsToken: string;
+        pageSize: number;
+        q?: string | undefined;
+    }, {
+        error: string;
+        details: any;
+        spreadsheets?: undefined;
+        message?: undefined;
+    } | {
+        spreadsheets: any;
+        error?: undefined;
+        details?: undefined;
+        message?: undefined;
+    } | {
+        error: string;
+        message: string;
+        details?: undefined;
+        spreadsheets?: undefined;
+    }>;
     requiredAuth: "googleSheetsToken";
-}[];
+    scope: "read";
+} | {
+    name: string;
+    description: string;
+    tool: import("ai").Tool<{
+        googleSheetsToken: string;
+        spreadsheetId: string;
+    }, any>;
+    requiredAuth: "googleSheetsToken";
+    scope: "read";
+} | {
+    name: string;
+    description: string;
+    tool: import("ai").Tool<{
+        range: string;
+        googleSheetsToken: string;
+        spreadsheetId: string;
+    }, any>;
+    requiredAuth: "googleSheetsToken";
+    scope: "read";
+} | {
+    name: string;
+    description: string;
+    tool: import("ai").Tool<{
+        values: (string | number | boolean | null)[][];
+        range: string;
+        googleSheetsToken: string;
+        spreadsheetId: string;
+        valueInputOption: "RAW" | "USER_ENTERED";
+    }, {
+        error: string;
+        details: any;
+        success?: undefined;
+        spreadsheetId?: undefined;
+        tableRange?: undefined;
+        updatedRange?: undefined;
+        updatedRows?: undefined;
+        updatedColumns?: undefined;
+        updatedCells?: undefined;
+        message?: undefined;
+    } | {
+        success: boolean;
+        spreadsheetId: any;
+        tableRange: any;
+        updatedRange: any;
+        updatedRows: any;
+        updatedColumns: any;
+        updatedCells: any;
+        error?: undefined;
+        details?: undefined;
+        message?: undefined;
+    } | {
+        error: string;
+        message: string;
+        details?: undefined;
+        success?: undefined;
+        spreadsheetId?: undefined;
+        tableRange?: undefined;
+        updatedRange?: undefined;
+        updatedRows?: undefined;
+        updatedColumns?: undefined;
+        updatedCells?: undefined;
+    }>;
+    requiredAuth: "googleSheetsToken";
+    scope: "write";
+} | {
+    name: string;
+    description: string;
+    tool: import("ai").Tool<{
+        values: (string | number | boolean | null)[][];
+        range: string;
+        googleSheetsToken: string;
+        spreadsheetId: string;
+        valueInputOption: "RAW" | "USER_ENTERED";
+    }, {
+        error: string;
+        details: any;
+        success?: undefined;
+        spreadsheetId?: undefined;
+        updatedRange?: undefined;
+        updatedRows?: undefined;
+        updatedColumns?: undefined;
+        updatedCells?: undefined;
+        message?: undefined;
+    } | {
+        success: boolean;
+        spreadsheetId: any;
+        updatedRange: any;
+        updatedRows: any;
+        updatedColumns: any;
+        updatedCells: any;
+        error?: undefined;
+        details?: undefined;
+        message?: undefined;
+    } | {
+        error: string;
+        message: string;
+        details?: undefined;
+        success?: undefined;
+        spreadsheetId?: undefined;
+        updatedRange?: undefined;
+        updatedRows?: undefined;
+        updatedColumns?: undefined;
+        updatedCells?: undefined;
+    }>;
+    requiredAuth: "googleSheetsToken";
+    scope: "write";
+} | {
+    name: string;
+    description: string;
+    tool: import("ai").Tool<{
+        range: string;
+        googleSheetsToken: string;
+        spreadsheetId: string;
+    }, {
+        error: string;
+        details: any;
+        success?: undefined;
+        spreadsheetId?: undefined;
+        clearedRange?: undefined;
+        message?: undefined;
+    } | {
+        success: boolean;
+        spreadsheetId: any;
+        clearedRange: any;
+        error?: undefined;
+        details?: undefined;
+        message?: undefined;
+    } | {
+        error: string;
+        message: string;
+        details?: undefined;
+        success?: undefined;
+        spreadsheetId?: undefined;
+        clearedRange?: undefined;
+    }>;
+    requiredAuth: "googleSheetsToken";
+    scope: "delete";
+} | {
+    name: string;
+    description: string;
+    tool: import("ai").Tool<{
+        title: string;
+        googleSheetsToken: string;
+        sheetTitles?: string[] | undefined;
+    }, {
+        error: string;
+        details: any;
+        success?: undefined;
+        spreadsheetId?: undefined;
+        spreadsheetUrl?: undefined;
+        title?: undefined;
+        sheets?: undefined;
+        message?: undefined;
+    } | {
+        success: boolean;
+        spreadsheetId: any;
+        spreadsheetUrl: any;
+        title: any;
+        sheets: any;
+        error?: undefined;
+        details?: undefined;
+        message?: undefined;
+    } | {
+        error: string;
+        message: string;
+        details?: undefined;
+        success?: undefined;
+        spreadsheetId?: undefined;
+        spreadsheetUrl?: undefined;
+        title?: undefined;
+        sheets?: undefined;
+    }>;
+    requiredAuth: "googleSheetsToken";
+    scope: "write";
+})[];
 //# sourceMappingURL=index.d.ts.map

package/dist/toolkits/google-sheets/tools/index.js

@@ -1,26 +1,61 @@
 // @ts-nocheck
-import { listSpreadsheets } from './list-spreadsheets';
-import { getSpreadsheet } from './get-spreadsheet';
-import { getValues } from './get-values';
-export { listSpreadsheets, getSpreadsheet, getValues };
+import { listSpreadsheets } from './list-spreadsheets.js';
+import { getSpreadsheet } from './get-spreadsheet.js';
+import { getValues } from './get-values.js';
+import { appendValues } from './append-values.js';
+import { updateValues } from './update-values.js';
+import { clearValues } from './clear-values.js';
+import { createSpreadsheet } from './create-spreadsheet.js';
+export { listSpreadsheets, getSpreadsheet, getValues, appendValues, updateValues, clearValues, createSpreadsheet, };
 export const googleSheetsTools = [
     {
         name: 'googleSheetsListSpreadsheets',
         description: 'List or search for Google Sheets spreadsheets in the user\'s Drive.',
         tool: listSpreadsheets,
         requiredAuth: 'googleSheetsToken',
+        scope: 'read',
     },
     {
         name: 'googleSheetsGetSpreadsheet',
         description: 'Get details and metadata of a specific Google Sheets spreadsheet by ID.',
         tool: getSpreadsheet,
         requiredAuth: 'googleSheetsToken',
+        scope: 'read',
     },
     {
         name: 'googleSheetsGetValues',
         description: 'Get values from a specific range in a Google Sheets spreadsheet.',
         tool: getValues,
         requiredAuth: 'googleSheetsToken',
+        scope: 'read',
+    },
+    {
+        name: 'googleSheetsAppendValues',
+        description: 'Append rows of values to a Google Sheets spreadsheet range (e.g., adding new rows at the bottom of a table).',
+        tool: appendValues,
+        requiredAuth: 'googleSheetsToken',
+        scope: 'write',
+    },
+    {
+        name: 'googleSheetsUpdateValues',
+        description: 'Update or overwrite values in a specific range of a Google Sheets spreadsheet.',
+        tool: updateValues,
+        requiredAuth: 'googleSheetsToken',
+        scope: 'write',
+    },
+    {
+        name: 'googleSheetsClearValues',
+        description: 'Clear values from a specific range in a Google Sheets spreadsheet, leaving cell formatting intact.',
+        tool: clearValues,
+        requiredAuth: 'googleSheetsToken',
+        scope: 'delete',
+    },
+    {
+        name: 'googleSheetsCreateSpreadsheet',
+        description: 'Create a new Google Sheets spreadsheet with a specified title and optional sheet tabs.',
+        tool: createSpreadsheet,
+        requiredAuth: 'googleSheetsToken',
+        scope: 'write',
     },
 ];
 //# sourceMappingURL=index.js.map

package/dist/toolkits/google-sheets/tools/update-values.d.ts

@@ -0,0 +1,38 @@
+export declare const updateValues: import("ai").Tool<{
+    values: (string | number | boolean | null)[][];
+    range: string;
+    googleSheetsToken: string;
+    spreadsheetId: string;
+    valueInputOption: "RAW" | "USER_ENTERED";
+}, {
+    error: string;
+    details: any;
+    success?: undefined;
+    spreadsheetId?: undefined;
+    updatedRange?: undefined;
+    updatedRows?: undefined;
+    updatedColumns?: undefined;
+    updatedCells?: undefined;
+    message?: undefined;
+} | {
+    success: boolean;
+    spreadsheetId: any;
+    updatedRange: any;
+    updatedRows: any;
+    updatedColumns: any;
+    updatedCells: any;
+    error?: undefined;
+    details?: undefined;
+    message?: undefined;
+} | {
+    error: string;
+    message: string;
+    details?: undefined;
+    success?: undefined;
+    spreadsheetId?: undefined;
+    updatedRange?: undefined;
+    updatedRows?: undefined;
+    updatedColumns?: undefined;
+    updatedCells?: undefined;
+}>;
+//# sourceMappingURL=update-values.d.ts.map

package/dist/toolkits/google-sheets/tools/update-values.js

@@ -0,0 +1,50 @@
+// @ts-nocheck
+import { tool } from 'ai';
+import { z } from 'zod';
+export const updateValues = tool({
+    description: 'Update or overwrite values in a specific range of a Google Sheets spreadsheet.',
+    inputSchema: z.object({
+        googleSheetsToken: z.string().describe('The Google Sheets access token'),
+        spreadsheetId: z.string().describe('The ID of the spreadsheet'),
+        range: z.string().describe('The A1 notation of the range to update (e.g., "Sheet1!A1:B2")'),
+        values: z.array(z.array(z.union([z.string(), z.number(), z.boolean(), z.null()]))).describe('A 2D array of values to write (e.g., [["Name", "Score"], ["Alice", 95]])'),
+        valueInputOption: z.enum(['RAW', 'USER_ENTERED']).optional().default('USER_ENTERED').describe('How the input data should be interpreted. USER_ENTERED parses values like user typing into UI.'),
+    }),
+    execute: async ({ googleSheetsToken, spreadsheetId, range, values, valueInputOption = 'USER_ENTERED' }) => {
+        try {
+            const url = `https://sheets.googleapis.com/v4/spreadsheets/${spreadsheetId}/values/${encodeURIComponent(range)}?valueInputOption=${valueInputOption}`;
+            const response = await fetch(url, {
+                method: 'PUT',
+                headers: {
+                    Authorization: `Bearer ${googleSheetsToken}`,
+                    'Content-Type': 'application/json',
+                },
+                body: JSON.stringify({
+                    range,
+                    majorDimension: 'ROWS',
+                    values,
+                }),
+            });
+            if (!response.ok) {
+                const error = await response.json();
+                return { error: 'Failed to update values', details: error };
+            }
+            const data = await response.json();
+            return {
+                success: true,
+                spreadsheetId: data.spreadsheetId,
+                updatedRange: data.updatedRange,
+                updatedRows: data.updatedRows,
+                updatedColumns: data.updatedColumns,
+                updatedCells: data.updatedCells,
+            };
+        }
+        catch (error) {
+            return {
+                error: 'Error updating values',
+                message: error instanceof Error ? error.message : 'Unknown error',
+            };
+        }
+    },
+});
+//# sourceMappingURL=update-values.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rnsk/toolkits",
-  "version": "0.0.2",
+  "version": "0.0.3",
   "description": "Runstack toolkit registry — manifest-driven tool definitions for AI agents",
   "type": "module",
   "main": "./dist/index.js",
@@ -13,13 +13,10 @@
     "./core": {
       "types": "./dist/core/index.d.ts",
       "import": "./dist/core/index.js"
-    },
-    "./runtime": {
-      "types": "./dist/runtime/index.d.ts",
-      "import": "./dist/runtime/index.js"
     }
   },
   "files": [
+    "README.md",
     "dist/**/*.js",
     "dist/**/*.d.ts"
   ],