chore: import upstream snapshot with attribution

python/tests/resource/gdocs/__init__.py

@@ -0,0 +1,13 @@
+# ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+# ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========

python/tests/resource/gdocs/test_config.py

@@ -0,0 +1,27 @@
+# ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+# ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========
+
+from mirage.resource.gdocs.config import GDocsConfig
+from mirage.resource.secrets import reveal_secret
+
+
+def test_config_creation():
+    config = GDocsConfig(
+        client_id="xxx.apps.googleusercontent.com",
+        client_secret="GOCSPx-xxx",
+        refresh_token="1//0abc",
+    )
+    assert config.client_id == "xxx.apps.googleusercontent.com"
+    assert reveal_secret(config.client_secret) == "GOCSPx-xxx"
+    assert reveal_secret(config.refresh_token) == "1//0abc"

python/tests/resource/gdocs/test_doc_entry.py

@@ -0,0 +1,83 @@
+# ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+# ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========
+
+from mirage.resource.gdocs.doc_entry import (DocEntry, make_filename,
+                                             sanitize_title)
+
+TITLE_MAX = 100
+
+
+def test_doc_entry_creation():
+    entry = DocEntry(
+        id="abc123",
+        name="My Doc",
+        modified_time="2026-04-01T12:00:00.000Z",
+        created_time="2026-03-01T12:00:00.000Z",
+        owner="user@gmail.com",
+        owned_by_me=True,
+        can_edit=True,
+        filename="My_Doc__abc123.gdoc.json",
+    )
+    assert entry.id == "abc123"
+    assert entry.name == "My Doc"
+    assert entry.owned_by_me is True
+    assert entry.can_edit is True
+    assert entry.filename == "My_Doc__abc123.gdoc.json"
+
+
+def test_sanitize_title_basic():
+    assert sanitize_title("Hello World") == "Hello_World"
+
+
+def test_sanitize_title_special_chars():
+    assert sanitize_title("My/Doc: A\\Test") == "My_Doc_A_Test"
+
+
+def test_sanitize_title_truncation():
+    long_title = "A" * 150
+    result = sanitize_title(long_title)
+    assert len(result) <= TITLE_MAX
+    assert result.endswith("...")
+
+
+def test_sanitize_title_consecutive_underscores():
+    assert sanitize_title("Hello   //  World") == "Hello_World"
+
+
+def test_sanitize_title_empty():
+    assert sanitize_title("") == "Untitled"
+
+
+def test_make_filename_without_date():
+    assert make_filename("My Doc", "abc123") == "My_Doc__abc123.gdoc.json"
+
+
+def test_make_filename_with_date():
+    result = make_filename("My Doc", "abc123", "2026-04-01T12:00:00.000Z")
+    assert result == "2026-04-01_My_Doc__abc123.gdoc.json"
+
+
+def test_make_filename_long_title():
+    long_title = "A" * 150
+    filename = make_filename(long_title, "abc123", "2026-04-01T00:00:00.000Z")
+    assert filename.endswith("__abc123.gdoc.json")
+    assert filename.startswith("2026-04-01_")
+
+
+def test_make_filename_duplicate_titles_different_dates():
+    f1 = make_filename("My Doc", "abc123", "2026-04-01T00:00:00.000Z")
+    f2 = make_filename("My Doc", "def456", "2026-03-15T00:00:00.000Z")
+    assert f1 != f2
+    assert f1 == "2026-04-01_My_Doc__abc123.gdoc.json"
+    assert f2 == "2026-03-15_My_Doc__def456.gdoc.json"

python/tests/resource/gdocs/test_prompt.py

@@ -0,0 +1,42 @@
+# ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+# ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========
+
+from mirage.resource.gdocs.prompt import PROMPT, WRITE_PROMPT
+
+
+def test_prompt_includes_buckets_and_structure():
+    rendered = PROMPT.format(prefix="/gdocs")
+    assert "owned/" in rendered
+    assert "shared/" in rendered
+    assert "shared with you by others" in rendered
+    assert "still in owned/" in rendered
+    assert "gdoc.json structure" in rendered
+    assert ".body.content[].paragraph.elements[].textRun.content" in rendered
+
+
+def test_write_prompt_examples_match_actual_signatures():
+    assert "gws-docs-write" in WRITE_PROMPT
+    assert "--document" in WRITE_PROMPT
+    assert "--text" in WRITE_PROMPT
+    assert "gws-docs-documents-create" in WRITE_PROMPT
+    assert "--json" in WRITE_PROMPT
+    assert '{"title":' in WRITE_PROMPT
+    assert "gws-docs-documents-batchUpdate" in WRITE_PROMPT
+    assert "documentId" in WRITE_PROMPT
+
+
+def test_write_prompt_documents_rm_and_newline_gotcha():
+    assert "rm " in WRITE_PROMPT
+    assert ".gdoc.json" in WRITE_PROMPT
+    assert "$'" in WRITE_PROMPT

python/tests/resource/gdocs/test_provider.py

@@ -0,0 +1,54 @@
+# ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+# ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========
+
+import pytest
+
+from mirage.resource.gdocs.config import GDocsConfig
+from mirage.resource.gdocs.gdocs import GDocsResource
+from mirage.types import ResourceName
+
+
+@pytest.fixture
+def config():
+    return GDocsConfig(
+        client_id="test-id",
+        client_secret="test-secret",
+        refresh_token="test-refresh",
+    )
+
+
+def test_resource_init(config):
+    resource = GDocsResource(config=config)
+    assert resource.name == ResourceName.GDOCS
+    assert resource.caches_reads is True
+
+
+def test_resource_accessor(config):
+    resource = GDocsResource(config=config)
+    assert resource.accessor is not None
+    assert resource.accessor.config is config
+    assert resource.accessor.token_manager is not None
+
+
+def test_resource_commands_registered(config):
+    resource = GDocsResource(config=config)
+    cmds = resource.commands()
+    assert len(cmds) > 15
+
+
+@pytest.mark.asyncio
+async def test_resource_fingerprint_not_found(config):
+    resource = GDocsResource(config=config)
+    fp = await resource.fingerprint("owned/Nonexistent__xyz.gdoc.json")
+    assert fp is None