Google Drive Integration & External Storage

Cloud Documents Meet Frontier Intelligence

Most enterprise and creative work lives inside Google Drive: dynamic project briefs, research spreadsheets, pitch decks, and collaborative team docs. Bringing that context to an AI assistant traditionally meant downloading files, converting them manually, and re-uploading them—fragmenting your workflow and duplicating storage.

ARMES introduces a first-class Google Drive Integration that seamlessly bridges your Google cloud documents with our agent roster, while strictly preserving your security boundaries.

With Google Drive connected, your agents can:

• Search & Read: Locate relevant documents and read converted Markdown or spreadsheet data on demand.
• Draft & Create: Author new Google Docs formatted with clean headings, bolding, code blocks, and tables.
• Safely Update: Propose revisions with interactive Action Confirmation Cards so no existing document is overwritten without your explicit consent.

---

The Privacy Boundary Invariant

ARMES is founded on strict privacy principles: Zero Data Retention (ZDR) at the inference layer and an isolated, encrypted Vault for your notes and chats. When connecting Google Drive, it is essential to understand the data boundary:

Core Security Guarantees:

1. Zero Model Credentials: AI models never see or hold your Google OAuth tokens. All requests route through the ARMES secure broker.
2. Encrypted at Rest: OAuth 2.0 access and refresh tokens are encrypted at rest using AES-256-GCM.
3. Prompt Injection Quarantine: Any text read from Google Drive is automatically wrapped in <external_data> quarantine tags before passing to the model, protecting agents from prompt-injection vulnerabilities.
4. Context Window Ceiling: File reads are capped at a safe ~30,000 token ceiling (~120,000 characters) to prevent oversized files from flooding your conversation context.
5. Instant Revocation: Disconnecting Google Drive immediately revokes your grant with Google and purges all cached metadata. Your original files in Google Drive remain untouched.

---

Connecting Google Drive

You can connect your Google account in three places:

1. Settings Page: Navigate to /settings → Integrations tab.
2. Command Center: Open the Settings tab in the Command center panel → Integrations.
3. Directly in Explorer: Click "Connect Account" in the Google Drive section of the Command right panel or Context sidebar.

During the Google OAuth 2.0 consent flow, ARMES requests standard Drive permissions to browse, read, and write files you authorize. Once connected, your account email and connection status appear in the Integrations hub.

---

Browsing Google Drive in ARMES

Google Drive is built natively into both workspace interfaces:

1. Command Center (Right Panel)

The Command right panel features a collapsible Google Drive explorer directly alongside your ARMES Notes. Use the scope selector to toggle between:

• My Drive: Your personal folders and files.
• Shared: Documents and folders shared with you by teammates.
• Starred: Pinned, high-frequency documents.

2. Context Page (Folders Sidebar)

On the Context page (/context), the Google Drive explorer sits in the sidebar above the Archive section, enabling seamless browsing between local notes and cloud documents.

Breadcrumb Navigation & Search

Search for any document across your Drive in real-time, or double-click folders to drill down through your folder hierarchy with full breadcrumb navigation.

---

Referencing Documents in Chat

ARMES enforces a Three-Tier Knowledge Reference System so you and your agents always know the exact origin and scope of referenced material:

Effortless References: ARMES automatically manages the underlying agent routing behind the scenes while displaying clean, interactive pills in your chat composer.

4 Ways to Attach Google Drive Files to Chat:

1. One-Click Attach to Chat: In the Google Drive Explorer, click the Attach to Chat button on any file row to instantly pin it to your active conversation.
2. Cross-Panel Drag-and-Drop: Drag any Google Doc or Sheet from the Command right panel or Context sidebar directly into the chat transcript or composer. It automatically snaps in as a cyan cloud pill.
3. Chat Input Picker (+ menu): Click the attachment plus icon in the chat composer and select "Google Drive" to browse and attach files without opening sidebars.
4. Slash Command (/drive): Type /drive in any chat composer to instantly launch the Google Drive file picker modal.

---

In-App Viewing, Editing & Quick View

You don't need to leave ARMES or open browser tabs to inspect and edit your Google cloud documents:

1. Command Center In-Tab Document Viewer & Quick Edit

In the Command Center (/command), clicking any document in the right panel opens it directly as an interactive Google Drive Tab:

• Clean Markdown View: Read Google Docs and Sheets converted into clean, readable Markdown with syntax highlighting for code blocks and formatted tables.
• Token Estimation: View live token consumption metrics (e.g. ~1,420 tokens) to understand how much context the file uses before sending it to an AI model.
• In-App Quick Edit: Switch to Quick Edit mode to make text adjustments directly in ARMES, then click "Save to Google Doc" to update the live document on Google Cloud.
• Save as Note / Vault: Instantly clone the document into your private ARMES Notes or Persistent Vault with one click.
• Open in Google Docs: Jump directly to docs.google.com whenever you need rich collaborative features like commenting or live multi-user editing.

2. Context Page Slide-Over Quick View

On the Context page (/context), clicking any file row opens the slide-over Quick View Reader dialog, providing instant inspection without navigating away from your note tree.

3. In-Chat Mention Quick View

Clicking on any Google Drive mention pill in a conversation transcript provides a "Quick View" option, allowing you to review the referenced file contents on demand.

---

The Vault ⇄ Google Drive Bridge

ARMES provides bi-directional bridges between your private vault and Google Drive:

1. Export Note to Google Doc

Have an ARMES note you want to share with clients or colleagues in Google Drive?

• Open the note export dialog (Export Note).
• Choose Google Doc as the export format.
• ARMES formats the markdown into native Google Doc styling (headings, tables, bolding, bulleted lists) and creates the file in your Google Drive, returning a direct link.

2. Import Google Drive File to Note

Need to bring an external document into your personal ARMES notes?

• In the Google Drive Explorer, click the note icon on any document row.
• The document is converted to Markdown and saved as an editable ARMES note in your active folder.

3. Import Google Drive File to Vault Library

Want a Google Drive PDF or report indexed for permanent agent search?

• Click "Import to Vault" in the explorer.
• The document is copied into your persistent file library, run through the document extraction pipeline, summarized, and indexed for semantic search across all conversations.

---

Action Proposal Gateway (Human-in-the-Loop)

A core tenet of ARMES is agency with safety. When an AI agent assists you with your Google Drive, it should never have the power to silently overwrite or destroy existing work.

To solve this, ARMES implements the Action Proposal Gateway for human in the loop approval.

The Action Confirmation Card:

When an agent attempts a destructive overwrite, it halts and informs you. In the chat transcript, an interactive Action Confirmation Card appears:

• External Storage Indicator: Displays the target document name and a Google Cloud badge.
• Diff & Changes Preview: Toggle an expandable preview showing exactly what text will be added, replaced, or removed.
• Live Countdown Timer: Displays remaining expiration time (e.g., 14h 23m remaining). Stale proposals expire safely after 24 hours via an automated hourly background cron.
• One-Click Approval: Clicking Approve & Overwrite executes the change immediately.

---

Integration Activity & Audit Log

In alignment with our Glass Box principle, ARMES gives you complete transparency into every interaction between AI agents and your external accounts:

Navigate to Settings (/settings?section=integrations) or the Command Center Settings Tab:

• View your connected Google account and active protection mode.
• Access the Integration Activity & Audit Log.
• Inspect a chronological record of every file read, document search, doc creation, and document update:
  • Caller: Identifies whether an action was taken by an AI Agent or You (ARMES).
  • Target: The exact document name and file ID.
  • Token Consumption: The precise token weight processed.
  • Timestamps: Exact time of access.