chore: import upstream snapshot with attribution

python/tests/resource/gmail/__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/gmail/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.gmail.config import GmailConfig
+from mirage.resource.secrets import reveal_secret
+
+
+def test_config_creation():
+    config = GmailConfig(
+        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/gmail/test_prompt.py

@@ -0,0 +1,58 @@
+# ========= 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.gmail.prompt import PROMPT, WRITE_PROMPT
+
+
+def test_prompt_includes_path_anatomy_and_processed_shape():
+    rendered = PROMPT.format(prefix="/gmail")
+    assert "<label>" in rendered
+    assert "INBOX" in rendered
+    assert "after:/before:" in rendered
+    assert "mirage-processed" in rendered
+    assert ".body_text" in rendered
+    assert "gws-gmail-read" in rendered
+    assert "gws-gmail-triage" in rendered
+
+
+def test_prompt_documents_file_per_message_layout():
+    rendered = PROMPT.format(prefix="/gmail")
+    assert "<subject>__<message-id>.gmail.json" in rendered
+    assert "<subject>__<message-id>/" in rendered
+    assert "attachments dir" in rendered
+    assert ".attachments[]" in rendered
+
+
+def test_prompt_mentions_grep_skips_binary_attachments():
+    rendered = PROMPT.format(prefix="/gmail")
+    assert "grep" in rendered
+    assert "binary" in rendered.lower()
+
+
+def test_write_prompt_examples_match_actual_signatures():
+    assert "gws-gmail-send" in WRITE_PROMPT
+    assert "--to" in WRITE_PROMPT
+    assert "--subject" in WRITE_PROMPT
+    assert "--body" in WRITE_PROMPT
+    assert "gws-gmail-reply" in WRITE_PROMPT
+    assert "gws-gmail-reply-all" in WRITE_PROMPT
+    assert "gws-gmail-forward" in WRITE_PROMPT
+    assert "--message-id" in WRITE_PROMPT
+
+
+def test_write_prompt_documents_rm_and_newline_gotcha():
+    assert "rm " in WRITE_PROMPT
+    assert ".gmail.json" in WRITE_PROMPT
+    assert "Trash" in WRITE_PROMPT
+    assert "$'" in WRITE_PROMPT

python/tests/resource/gmail/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.gmail.config import GmailConfig
+from mirage.resource.gmail.gmail import GmailResource
+from mirage.types import ResourceName
+
+
+@pytest.fixture
+def config():
+    return GmailConfig(
+        client_id="test-id",
+        client_secret="test-secret",
+        refresh_token="test-refresh",
+    )
+
+
+def test_resource_init(config):
+    resource = GmailResource(config=config)
+    assert resource.name == ResourceName.GMAIL
+    assert resource.caches_reads is True
+
+
+def test_resource_accessor(config):
+    resource = GmailResource(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 = GmailResource(config=config)
+    cmds = resource.commands()
+    assert len(cmds) > 15
+
+
+@pytest.mark.asyncio
+async def test_resource_fingerprint_not_found(config):
+    resource = GmailResource(config=config)
+    fp = await resource.fingerprint("/gmail/nonexistent")
+    assert fp is None