veryfront 0.0.49 → 0.0.50

package/dist/integrations/docs-google/connector.json

@@ -0,0 +1,101 @@
+{
+  "name": "docs-google",
+  "displayName": "Google Docs",
+  "icon": "docs-google.svg",
+  "description": "Read, create, and manage Google Docs documents",
+  "auth": {
+    "type": "oauth2",
+    "provider": "google",
+    "authorizationUrl": "https://accounts.google.com/o/oauth2/v2/auth",
+    "tokenUrl": "https://oauth2.googleapis.com/token",
+    "scopes": [
+      "https://www.googleapis.com/auth/documents.readonly",
+      "https://www.googleapis.com/auth/documents",
+      "https://www.googleapis.com/auth/drive.readonly"
+    ],
+    "callbackPath": "/api/auth/docs-google/callback",
+    "requiredApis": [
+      {
+        "name": "Google Docs API",
+        "enableUrl": "https://console.cloud.google.com/apis/library/docs.googleapis.com"
+      },
+      {
+        "name": "Google Drive API",
+        "enableUrl": "https://console.cloud.google.com/apis/library/drive.googleapis.com"
+      }
+    ]
+  },
+  "envVars": [
+    {
+      "name": "GOOGLE_CLIENT_ID",
+      "description": "Google OAuth Client ID",
+      "required": true,
+      "sensitive": false,
+      "docsUrl": "https://console.cloud.google.com/apis/credentials"
+    },
+    {
+      "name": "GOOGLE_CLIENT_SECRET",
+      "description": "Google OAuth Client Secret",
+      "required": true,
+      "sensitive": true,
+      "docsUrl": "https://console.cloud.google.com/apis/credentials"
+    }
+  ],
+  "tools": [
+    {
+      "id": "list-documents",
+      "name": "List Documents",
+      "description": "List recent Google Docs documents from Drive",
+      "requiresWrite": false
+    },
+    {
+      "id": "get-document",
+      "name": "Get Document",
+      "description": "Get document content and metadata",
+      "requiresWrite": false
+    },
+    {
+      "id": "create-document",
+      "name": "Create Document",
+      "description": "Create a new document with optional initial content",
+      "requiresWrite": true
+    },
+    {
+      "id": "update-document",
+      "name": "Update Document",
+      "description": "Update document content using batch requests",
+      "requiresWrite": true
+    },
+    {
+      "id": "search-documents",
+      "name": "Search Documents",
+      "description": "Search for documents by query string",
+      "requiresWrite": false
+    }
+  ],
+  "prompts": [
+    {
+      "id": "summarize-doc",
+      "title": "Summarize a document",
+      "prompt": "Read a Google Docs document and provide a concise summary of its contents, key points, and main themes.",
+      "category": "productivity",
+      "icon": "file-text"
+    },
+    {
+      "id": "create-report",
+      "title": "Create a report document",
+      "prompt": "Create a new Google Docs document with a well-formatted report including headings, bullet points, and structured content.",
+      "category": "productivity",
+      "icon": "plus"
+    },
+    {
+      "id": "edit-document",
+      "title": "Edit a document",
+      "prompt": "Update an existing Google Docs document with new content, formatting changes, or corrections.",
+      "category": "productivity",
+      "icon": "edit"
+    }
+  ],
+  "suggestedWith": ["gmail", "calendar", "drive", "sheets"],
+  "setupGuide": "# Google Docs Integration Setup\n\n## Prerequisites\n- A Google Cloud Platform account\n- A Google Cloud project\n\n## Step 1: Create OAuth 2.0 Credentials\n\n1. Go to the [Google Cloud Console](https://console.cloud.google.com/)\n2. Select or create a project\n3. Navigate to **APIs & Services** > **Credentials**\n4. Click **Create Credentials** > **OAuth client ID**\n5. Select **Web application** as the application type\n6. Add your authorized redirect URIs:\n   - For development: `http://localhost:3000/api/auth/docs-google/callback`\n   - For production: `https://yourdomain.com/api/auth/docs-google/callback`\n7. Click **Create** and copy your Client ID and Client Secret\n\n## Step 2: Enable Required APIs\n\nEnable the following APIs in your Google Cloud project:\n\n1. [Google Docs API](https://console.cloud.google.com/apis/library/docs.googleapis.com)\n2. [Google Drive API](https://console.cloud.google.com/apis/library/drive.googleapis.com)\n\n## Step 3: Configure Environment Variables\n\nAdd the following to your `.env` file:\n\n```bash\nGOOGLE_CLIENT_ID=your_client_id_here\nGOOGLE_CLIENT_SECRET=your_client_secret_here\n```\n\n## Step 4: Test the Integration\n\n1. Start your development server\n2. Navigate to `/api/auth/docs-google` to initiate OAuth flow\n3. Grant permissions when prompted\n4. You should be redirected back to your application\n\n## OAuth Scopes\n\nThis integration requests the following scopes:\n\n- `https://www.googleapis.com/auth/documents.readonly` - Read access to Google Docs\n- `https://www.googleapis.com/auth/documents` - Full access to create and edit Google Docs\n- `https://www.googleapis.com/auth/drive.readonly` - Read access to list documents from Drive\n\n## Security Notes\n\n- Keep your Client Secret secure and never commit it to version control\n- Use environment variables for all sensitive credentials\n- Consider implementing proper user session management in production\n- The default implementation uses an in-memory token store - replace with a persistent store for production use\n\n## Available AI Tools\n\nOnce configured, you can use these AI tools:\n\n- **list-documents** - List recent Google Docs from your Drive\n- **get-document** - Retrieve document content and structure\n- **create-document** - Create new documents with formatted content\n- **update-document** - Modify existing documents with batch updates\n- **search-documents** - Search for documents by name or content\n\n## Need Help?\n\nRefer to the [Google Docs API documentation](https://developers.google.com/docs/api) for detailed information about API capabilities and limits."
+}

package/dist/integrations/docs-google/files/_env.example

@@ -0,0 +1,8 @@
+# Google Docs Integration
+# Create OAuth credentials at https://console.cloud.google.com/apis/credentials
+# Make sure to enable:
+# - Google Docs API: https://console.cloud.google.com/apis/library/docs.googleapis.com
+# - Google Drive API: https://console.cloud.google.com/apis/library/drive.googleapis.com
+
+GOOGLE_CLIENT_ID=your_client_id_here
+GOOGLE_CLIENT_SECRET=your_client_secret_here

package/dist/integrations/docs-google/files/ai/tools/create-document.ts

@@ -0,0 +1,46 @@
+import { tool } from "veryfront/ai";
+import { z } from "zod";
+import { createDocsClient } from "../../lib/docs-client.ts";
+
+// Default user ID for demo/dev purposes
+// In production, get from authenticated session
+const DEFAULT_USER_ID = "demo-user";
+
+export default tool({
+  id: "create-document",
+  description:
+    "Create a new Google Docs document with optional initial content. Returns the new document ID and URL.",
+  inputSchema: z.object({
+    title: z
+      .string()
+      .describe("Title of the new document"),
+    content: z
+      .string()
+      .optional()
+      .describe("Optional initial text content to insert into the document"),
+  }),
+  async execute({ title, content }) {
+    const client = createDocsClient(DEFAULT_USER_ID);
+
+    let document;
+
+    if (content) {
+      // Create document with content
+      document = await client.createDocumentWithContent(title, content);
+    } else {
+      // Create empty document
+      document = await client.createDocument({ title });
+    }
+
+    // Get the web view link from Drive
+    const documents = await client.listDocuments({ maxResults: 1 });
+    const webViewLink = documents.find(d => d.id === document.documentId)?.webViewLink;
+
+    return {
+      documentId: document.documentId,
+      title: document.title,
+      url: webViewLink || `https://docs.google.com/document/d/${document.documentId}/edit`,
+      revisionId: document.revisionId,
+    };
+  },
+});

package/dist/integrations/docs-google/files/ai/tools/get-document.ts

@@ -0,0 +1,46 @@
+import { tool } from "veryfront/ai";
+import { z } from "zod";
+import { createDocsClient } from "../../lib/docs-client.ts";
+
+// Default user ID for demo/dev purposes
+// In production, get from authenticated session
+const DEFAULT_USER_ID = "demo-user";
+
+export default tool({
+  id: "get-document",
+  description:
+    "Get a Google Docs document's content and metadata. Returns the full document structure including text, formatting, and styles.",
+  inputSchema: z.object({
+    documentId: z
+      .string()
+      .describe("The ID of the document to retrieve"),
+    extractTextOnly: z
+      .boolean()
+      .default(false)
+      .describe("If true, only return plain text content without formatting"),
+  }),
+  async execute({ documentId, extractTextOnly }) {
+    const client = createDocsClient(DEFAULT_USER_ID);
+
+    const document = await client.getDocument(documentId);
+
+    if (extractTextOnly) {
+      const text = client.extractText(document);
+      return {
+        documentId: document.documentId,
+        title: document.title,
+        text,
+        revisionId: document.revisionId,
+      };
+    }
+
+    // Return full document structure
+    return {
+      documentId: document.documentId,
+      title: document.title,
+      revisionId: document.revisionId,
+      body: document.body,
+      documentStyle: document.documentStyle,
+    };
+  },
+});

package/dist/integrations/docs-google/files/ai/tools/list-documents.ts

@@ -0,0 +1,42 @@
+import { tool } from "veryfront/ai";
+import { z } from "zod";
+import { createDocsClient } from "../../lib/docs-client.ts";
+
+// Default user ID for demo/dev purposes
+// In production, get from authenticated session
+const DEFAULT_USER_ID = "demo-user";
+
+export default tool({
+  id: "list-documents",
+  description:
+    "List recent Google Docs documents from Google Drive. Returns document names, IDs, and metadata.",
+  inputSchema: z.object({
+    maxResults: z
+      .number()
+      .min(1)
+      .max(100)
+      .default(20)
+      .describe("Maximum number of documents to return"),
+    orderBy: z
+      .enum(["createdTime", "modifiedTime", "name"])
+      .default("modifiedTime")
+      .describe("Sort order for results"),
+  }),
+  async execute({ maxResults, orderBy }) {
+    const client = createDocsClient(DEFAULT_USER_ID);
+
+    const documents = await client.listDocuments({
+      maxResults,
+      orderBy,
+    });
+
+    return documents.map((doc) => ({
+      id: doc.id,
+      name: doc.name,
+      url: doc.webViewLink,
+      createdTime: doc.createdTime,
+      modifiedTime: doc.modifiedTime,
+      thumbnail: doc.thumbnailLink,
+    }));
+  },
+});

package/dist/integrations/docs-google/files/ai/tools/search-documents.ts

@@ -0,0 +1,38 @@
+import { tool } from "veryfront/ai";
+import { z } from "zod";
+import { createDocsClient } from "../../lib/docs-client.ts";
+
+// Default user ID for demo/dev purposes
+// In production, get from authenticated session
+const DEFAULT_USER_ID = "demo-user";
+
+export default tool({
+  id: "search-documents",
+  description:
+    "Search for Google Docs documents by query string. Searches document names and content. Returns matching document IDs, names, and metadata.",
+  inputSchema: z.object({
+    query: z
+      .string()
+      .describe("Search query to find documents. Searches in document names and content."),
+    maxResults: z
+      .number()
+      .min(1)
+      .max(100)
+      .default(20)
+      .describe("Maximum number of results to return"),
+  }),
+  async execute({ query, maxResults }) {
+    const client = createDocsClient(DEFAULT_USER_ID);
+
+    const documents = await client.searchDocuments(query, maxResults);
+
+    return documents.map((doc) => ({
+      id: doc.id,
+      name: doc.name,
+      url: doc.webViewLink,
+      createdTime: doc.createdTime,
+      modifiedTime: doc.modifiedTime,
+      thumbnail: doc.thumbnailLink,
+    }));
+  },
+});

package/dist/integrations/docs-google/files/ai/tools/update-document.ts

@@ -0,0 +1,131 @@
+import { tool } from "veryfront/ai";
+import { z } from "zod";
+import { createDocsClient, type Request } from "../../lib/docs-client.ts";
+
+// Default user ID for demo/dev purposes
+// In production, get from authenticated session
+const DEFAULT_USER_ID = "demo-user";
+
+export default tool({
+  id: "update-document",
+  description:
+    "Update a Google Docs document using batch requests. Supports inserting text, deleting content, replacing text, and more.",
+  inputSchema: z.object({
+    documentId: z
+      .string()
+      .describe("The ID of the document to update"),
+    requests: z
+      .array(z.any())
+      .describe(
+        "Array of batch update requests. See Google Docs API documentation for request types: insertText, deleteContentRange, replaceAllText, etc.",
+      ),
+  }).or(
+    z.object({
+      documentId: z
+        .string()
+        .describe("The ID of the document to update"),
+      operation: z.object({
+        type: z
+          .enum(["insertText", "deleteContent", "replaceAllText"])
+          .describe("Type of operation to perform"),
+        insertText: z
+          .object({
+            text: z.string().describe("Text to insert"),
+            index: z.number().describe("Position to insert at (1 = start of document)"),
+          })
+          .optional()
+          .describe("Parameters for insertText operation"),
+        deleteContent: z
+          .object({
+            startIndex: z.number().describe("Start position of content to delete"),
+            endIndex: z.number().describe("End position of content to delete"),
+          })
+          .optional()
+          .describe("Parameters for deleteContent operation"),
+        replaceAllText: z
+          .object({
+            searchText: z.string().describe("Text to search for"),
+            replaceText: z.string().describe("Text to replace with"),
+            matchCase: z
+              .boolean()
+              .default(false)
+              .describe("Whether to match case"),
+          })
+          .optional()
+          .describe("Parameters for replaceAllText operation"),
+      }).describe("Simple operation to perform"),
+    }),
+  ),
+  async execute(input) {
+    const client = createDocsClient(DEFAULT_USER_ID);
+
+    let requests: Request[];
+
+    // Handle simple operation format
+    if ("operation" in input) {
+      const { documentId, operation } = input;
+
+      switch (operation.type) {
+        case "insertText":
+          if (!operation.insertText) {
+            throw new Error("insertText parameters required");
+          }
+          const result = await client.insertText(
+            documentId,
+            operation.insertText.text,
+            operation.insertText.index,
+          );
+          return {
+            documentId: result.documentId,
+            success: true,
+            replies: result.replies,
+          };
+
+        case "deleteContent":
+          if (!operation.deleteContent) {
+            throw new Error("deleteContent parameters required");
+          }
+          const deleteResult = await client.deleteContent(
+            documentId,
+            operation.deleteContent.startIndex,
+            operation.deleteContent.endIndex,
+          );
+          return {
+            documentId: deleteResult.documentId,
+            success: true,
+            replies: deleteResult.replies,
+          };
+
+        case "replaceAllText":
+          if (!operation.replaceAllText) {
+            throw new Error("replaceAllText parameters required");
+          }
+          const replaceResult = await client.replaceAllText(
+            documentId,
+            operation.replaceAllText.searchText,
+            operation.replaceAllText.replaceText,
+            operation.replaceAllText.matchCase,
+          );
+          return {
+            documentId: replaceResult.documentId,
+            success: true,
+            replies: replaceResult.replies,
+          };
+
+        default:
+          throw new Error(`Unknown operation type: ${operation.type}`);
+      }
+    }
+
+    // Handle raw batch requests format
+    const { documentId, requests: batchRequests } = input;
+    const result = await client.updateDocument(documentId, batchRequests as Request[]);
+
+    return {
+      documentId: result.documentId,
+      success: true,
+      replies: result.replies,
+      writeControl: result.writeControl,
+    };
+  },
+});

package/dist/integrations/docs-google/files/app/api/auth/docs-google/callback/route.ts

@@ -0,0 +1,11 @@
+/**
+ * Google Docs OAuth Callback
+ */
+
+import { createOAuthCallbackHandler, memoryTokenStore, docsGoogleConfig } from "veryfront/oauth";
+
+export const GET = createOAuthCallbackHandler(docsGoogleConfig, {
+  tokenStore: memoryTokenStore,
+  onSuccess: () => "/",
+  onError: () => "/",
+});

package/dist/integrations/docs-google/files/app/api/auth/docs-google/route.ts

@@ -0,0 +1,9 @@
+/**
+ * Google Docs OAuth Initiation
+ */
+
+import { createOAuthInitHandler, memoryTokenStore, docsGoogleConfig } from "veryfront/oauth";
+
+export const GET = createOAuthInitHandler(docsGoogleConfig, {
+  tokenStore: memoryTokenStore,
+});