fix(google-sheets): upgrade to SDK 2.0.0, fix Lambda crash on error paths (#289)

* fix(google-sheets): upgrade to SDK 2.0.0, fix Lambda crash on error paths, add unit tests

Converts all error paths from ActionResult(data={error, result: False}) to
ActionError(message=...) to fix output schema validation crashes in SDK 2.0.0.
Removes error/result fields from all output schemas. Adds 51 pytest unit tests.

* fix(google-sheets): fix auth to use .get(), add integration test, update .env.example

- Fix build_credentials to use context.auth.get("credentials", {}).get("access_token", "")
- Add test_google_sheets_integration.py with GOOGLE_SHEETS_ACCESS_TOKEN skip guard
- Add GOOGLE_SHEETS_ACCESS_TOKEN and GOOGLE_SHEETS_TEST_SPREADSHEET_ID to .env.example
- Apply ruff format to all google-sheets files

* fix(google-sheets): fix optional param access and ruff formatting

* fix(google-sheets): add full integration tests for all 10 actions

* chore(google-sheets): remove legacy test file replaced by test_google_sheets_integration.py

* fix(google-sheets): use 'is not None' for pageSize/pageToken truthy check

A pageSize of 0 (or pageToken of empty string) was previously dropped by
the truthy check. Use 'is not None' so explicit falsy values still flow
through to the Drive API request.

* refactor(google-sheets): drop importlib boilerplate from unit tests

- conftest.py now adds the integration root to sys.path (was a no-op
  inserting tests/ which exposed nothing useful).
- Each unit test file replaces the spec_from_file_location dance with a
  plain 'from google_sheets import google_sheets'.
- @patch targets switch from per-file unique mod names back to
  'google_sheets.build'.
- Delete stale tests/context.py (pre-SDK-2.0 testbed shim, no longer
  imported anywhere).

* fix(google-sheets): assert ResultType.ACTION in destructive integration tests

'result.result is not None' is always true (it's ActionResultData on
success or ActionErrorData on failure), so the destructive tests for
sheets_format_range, sheets_freeze, and sheets_batch_update would pass
even when the action returned an ActionError. Assert on result.type
instead so the tests fail when the action errors.

* chore(google-sheets): remove dead get_first_spreadsheet_id helper

The helper was never called — every test inlined the
sheets_list_spreadsheets call directly. It also used the deprecated
asyncio.get_event_loop().run_until_complete() pattern, which would
clash with pytest-asyncio's loop if it ever were invoked.

* refactor(google-sheets): drop importlib boilerplate from integration tests

Mirrors the unit test refactor in 3a33344 — replace the
spec_from_file_location dance with 'from google_sheets import google_sheets'
and remove the now-redundant inline ResultType import in
TestDuplicateSpreadsheet.

* fix(google-sheets): escape single quotes in owner email q-string

The 'owner' input is interpolated unescaped into the Drive q-string,
which would break (and could in principle inject into) the query for
emails containing apostrophes. Mirror the existing escape applied to
'name_contains'.

* chore(google-sheets): remove unreachable validation in sheets_batch_update

The handler's 'requests must be a list of dicts' check is unreachable:
the SDK validates the input schema before the handler runs and returns
a VALIDATION_ERROR for non-list / non-dict-item inputs. The two existing
unit tests confirm this — both still pass and assert
ResultType.VALIDATION_ERROR coming from the SDK layer.

* test(google-sheets): cover pageSize/pageToken, build_credentials, rich format style

- TestListSpreadsheets: assert pageSize and pageToken reach
  drive.files().list(**params) when supplied. Closes the 1% coverage
  gap and locks in the 'is not None' fix from 5e9f80a.
- TestBuildCredentials: direct tests for the empty-string fallback
  paths added to build_credentials so a regression to bracket
  indexing on missing 'credentials' or 'access_token' is caught.
- TestFormatRange: richer style payload (background + textFormat +
  alignment) flows through to userEnteredFormat unchanged, and the
  request range merges sheetId with the gridRange.

---------

Co-authored-by: Shubhank <72601061+Sagsgit@users.noreply.github.com>
Co-authored-by: Kai Koenig <kai@ventego-creative.co.nz>

Author: Shubhank-Jonnada

.env.example

@@ -64,6 +64,10 @@
 # -- Coda --
 # CODA_API_KEY=
 
+# -- Google Sheets --
+# GOOGLE_SHEETS_ACCESS_TOKEN=
+# GOOGLE_SHEETS_TEST_SPREADSHEET_ID=
+
 # -- Gong --
 # GONG_ACCESS_TOKEN=
 # GONG_API_BASE_URL=

google-sheets/config.json

@@ -1,7 +1,7 @@
 {
   "name": "Google Sheets",
   "display_name": "Google Sheets",
-  "version": "0.1.1",
+  "version": "2.0.0",
   "entry_point": "google_sheets.py",
   "description": "Read and write Google Sheets with safe, deterministic operations and basic formatting.",
   "auth": {
@@ -36,11 +36,9 @@
         "type": "object",
         "properties": {
           "files": { "type": "array", "items": { "type": "object" } },
-          "nextPageToken": { "type": "string" },
-          "result": { "type": "boolean" },
-          "error": { "type": "string" }
+          "nextPageToken": { "type": "string" }
         },
-        "required": ["files", "result"]
+        "required": ["files"]
       }
     },
     "sheets_get_spreadsheet": {
@@ -60,11 +58,9 @@
       "output_schema": {
         "type": "object",
         "properties": {
-          "spreadsheet": { "type": "object" },
-          "result": { "type": "boolean" },
-          "error": { "type": "string" }
+          "spreadsheet": { "type": "object" }
         },
-        "required": ["spreadsheet", "result"]
+        "required": ["spreadsheet"]
       }
     },
     "sheets_list_sheets": {
@@ -80,11 +76,9 @@
       "output_schema": {
         "type": "object",
         "properties": {
-          "sheets": { "type": "array", "items": { "type": "object" } },
-          "result": { "type": "boolean" },
-          "error": { "type": "string" }
+          "sheets": { "type": "array", "items": { "type": "object" } }
         },
-        "required": ["sheets", "result"]
+        "required": ["sheets"]
       }
     },
     "sheets_read_range": {
@@ -119,11 +113,9 @@
               "type": "array",
               "items": { "type": ["string", "number", "boolean", "null"] }
             }
-          },
-          "result": { "type": "boolean" },
-          "error": { "type": "string" }
+          }
         },
-        "required": ["range", "values", "result"]
+        "required": ["range", "values"]
       }
     },
     "sheets_write_range": {
@@ -153,11 +145,8 @@
           "updatedRows": { "type": "integer" },
           "updatedColumns": { "type": "integer" },
           "updatedCells": { "type": "integer" },
-          "dryRun": { "type": "boolean" },
-          "result": { "type": "boolean" },
-          "error": { "type": "string" }
-        },
-        "required": ["result"]
+          "dryRun": { "type": "boolean" }
+        }
       }
     },
     "sheets_append_rows": {
@@ -185,11 +174,8 @@
       "output_schema": {
         "type": "object",
         "properties": {
-          "updates": { "type": "object" },
-          "result": { "type": "boolean" },
-          "error": { "type": "string" }
-        },
-        "required": ["result"]
+          "updates": { "type": "object" }
+        }
       }
     },
     "sheets_format_range": {
@@ -220,11 +206,8 @@
       "output_schema": {
         "type": "object",
         "properties": {
-          "replies": { "type": "array", "items": { "type": "object" } },
-          "result": { "type": "boolean" },
-          "error": { "type": "string" }
-        },
-        "required": ["result"]
+          "replies": { "type": "array", "items": { "type": "object" } }
+        }
       }
     },
     "sheets_freeze": {
@@ -243,11 +226,8 @@
       "output_schema": {
         "type": "object",
         "properties": {
-          "replies": { "type": "array", "items": { "type": "object" } },
-          "result": { "type": "boolean" },
-          "error": { "type": "string" }
-        },
-        "required": ["result"]
+          "replies": { "type": "array", "items": { "type": "object" } }
+        }
       }
     },
     "sheets_batch_update": {
@@ -266,11 +246,8 @@
         "type": "object",
         "properties": {
           "replies": { "type": "array", "items": { "type": "object" } },
-          "dryRun": { "type": "boolean" },
-          "result": { "type": "boolean" },
-          "error": { "type": "string" }
-        },
-        "required": ["result"]
+          "dryRun": { "type": "boolean" }
+        }
       }
     },
     "sheets_duplicate_spreadsheet": {
@@ -306,11 +283,9 @@
               "parents": { "type": "array", "items": { "type": "string" } },
               "webViewLink": { "type": "string" }
             }
-          },
-          "result": { "type": "boolean" },
-          "error": { "type": "string" }
+          }
         },
-        "required": ["file_metadata", "result"]
+        "required": ["file_metadata"]
       }
     }
   }