veryfront 0.0.48 → 0.0.50

package/dist/integrations/asana/files/app/api/auth/asana/callback/route.ts

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

package/dist/integrations/asana/files/app/api/auth/asana/route.ts

@@ -0,0 +1,7 @@
+/**
+ * Asana OAuth Init
+ */
+
+import { asanaConfig, createOAuthInitHandler } from "veryfront/oauth";
+
+export const GET = createOAuthInitHandler(asanaConfig);

package/dist/integrations/asana/files/lib/asana-client.ts

@@ -0,0 +1,162 @@
+import { getAccessToken } from "./token-store.ts";
+
+const ASANA_BASE_URL = "https://app.asana.com/api/1.0";
+
+interface AsanaResponse<T> {
+  data: T;
+  next_page?: { offset: string } | null;
+}
+
+interface AsanaTask {
+  gid: string;
+  name: string;
+  notes: string;
+  completed: boolean;
+  due_on: string | null;
+  assignee: { gid: string; name: string } | null;
+  projects: Array<{ gid: string; name: string }>;
+  created_at: string;
+  modified_at: string;
+}
+
+interface AsanaProject {
+  gid: string;
+  name: string;
+  notes: string;
+  workspace: { gid: string; name: string };
+  created_at: string;
+  modified_at: string;
+}
+
+interface AsanaWorkspace {
+  gid: string;
+  name: string;
+}
+
+async function asanaFetch<T>(
+  endpoint: string,
+  options: RequestInit = {},
+): Promise<T> {
+  const token = await getAccessToken();
+  if (!token) {
+    throw new Error("Not authenticated with Asana. Please connect your account.");
+  }
+
+  const response = await fetch(`${ASANA_BASE_URL}${endpoint}`, {
+    ...options,
+    headers: {
+      "Authorization": `Bearer ${token}`,
+      "Content-Type": "application/json",
+      ...options.headers,
+    },
+  });
+
+  if (!response.ok) {
+    const error = await response.json().catch(() => ({}));
+    throw new Error(
+      `Asana API error: ${response.status} ${error.errors?.[0]?.message || response.statusText}`,
+    );
+  }
+
+  return response.json();
+}
+
+export async function listWorkspaces(): Promise<AsanaWorkspace[]> {
+  const response = await asanaFetch<AsanaResponse<AsanaWorkspace[]>>("/workspaces");
+  return response.data;
+}
+
+export async function listProjects(workspaceGid: string): Promise<AsanaProject[]> {
+  const response = await asanaFetch<AsanaResponse<AsanaProject[]>>(
+    `/workspaces/${workspaceGid}/projects?opt_fields=name,notes,created_at,modified_at`,
+  );
+  return response.data;
+}
+
+export async function listTasks(options: {
+  projectGid?: string;
+  assigneeGid?: string;
+  workspaceGid?: string;
+  completedSince?: string;
+}): Promise<AsanaTask[]> {
+  const params = new URLSearchParams({
+    opt_fields: "name,notes,completed,due_on,assignee.name,projects.name,created_at,modified_at",
+  });
+
+  if (options.completedSince) {
+    params.set("completed_since", options.completedSince);
+  }
+
+  let endpoint = "/tasks";
+  if (options.projectGid) {
+    endpoint = `/projects/${options.projectGid}/tasks`;
+  } else if (options.assigneeGid && options.workspaceGid) {
+    params.set("assignee", options.assigneeGid);
+    params.set("workspace", options.workspaceGid);
+  }
+
+  const response = await asanaFetch<AsanaResponse<AsanaTask[]>>(`${endpoint}?${params}`);
+  return response.data;
+}
+
+export async function getTask(taskGid: string): Promise<AsanaTask> {
+  const response = await asanaFetch<AsanaResponse<AsanaTask>>(
+    `/tasks/${taskGid}?opt_fields=name,notes,completed,due_on,assignee.name,projects.name,created_at,modified_at`,
+  );
+  return response.data;
+}
+
+export async function createTask(options: {
+  projectGid: string;
+  name: string;
+  notes?: string;
+  dueOn?: string;
+  assigneeGid?: string;
+}): Promise<AsanaTask> {
+  const body: Record<string, unknown> = {
+    name: options.name,
+    projects: [options.projectGid],
+  };
+
+  if (options.notes) body.notes = options.notes;
+  if (options.dueOn) body.due_on = options.dueOn;
+  if (options.assigneeGid) body.assignee = options.assigneeGid;
+
+  const response = await asanaFetch<AsanaResponse<AsanaTask>>("/tasks", {
+    method: "POST",
+    body: JSON.stringify({ data: body }),
+  });
+  return response.data;
+}
+
+export async function updateTask(
+  taskGid: string,
+  updates: {
+    name?: string;
+    notes?: string;
+    completed?: boolean;
+    dueOn?: string;
+    assigneeGid?: string;
+  },
+): Promise<AsanaTask> {
+  const body: Record<string, unknown> = {};
+
+  if (updates.name !== undefined) body.name = updates.name;
+  if (updates.notes !== undefined) body.notes = updates.notes;
+  if (updates.completed !== undefined) body.completed = updates.completed;
+  if (updates.dueOn !== undefined) body.due_on = updates.dueOn;
+  if (updates.assigneeGid !== undefined) body.assignee = updates.assigneeGid;
+
+  const response = await asanaFetch<AsanaResponse<AsanaTask>>(`/tasks/${taskGid}`, {
+    method: "PUT",
+    body: JSON.stringify({ data: body }),
+  });
+  return response.data;
+}
+
+export async function getMe(): Promise<{ gid: string; name: string; email: string }> {
+  const response = await asanaFetch<AsanaResponse<{ gid: string; name: string; email: string }>>(
+    "/users/me",
+  );
+  return response.data;
+}

package/dist/integrations/asana/files/lib/token-store.ts

@@ -0,0 +1,11 @@
+/**
+ * Asana Token Store
+ */
+
+export { memoryTokenStore as tokenStore, type OAuthTokens, type TokenStore } from "veryfront/oauth";
+
+export async function getAccessToken(): Promise<string | null> {
+  const { tokenStore } = await import("./token-store.ts");
+  const tokens = await tokenStore.get("asana");
+  return tokens?.accessToken ?? null;
+}

package/dist/integrations/aws/connector.json

@@ -0,0 +1,72 @@
+{
+  "name": "aws",
+  "displayName": "Amazon Web Services",
+  "description": "Integration with AWS services including S3, EC2, and Lambda",
+  "version": "1.0.0",
+  "auth": {
+    "type": "api-key",
+    "fields": [
+      {
+        "name": "accessKeyId",
+        "label": "AWS Access Key ID",
+        "type": "string",
+        "required": true,
+        "envVar": "AWS_ACCESS_KEY_ID"
+      },
+      {
+        "name": "secretAccessKey",
+        "label": "AWS Secret Access Key",
+        "type": "password",
+        "required": true,
+        "envVar": "AWS_SECRET_ACCESS_KEY"
+      },
+      {
+        "name": "region",
+        "label": "AWS Region",
+        "type": "string",
+        "required": true,
+        "default": "us-east-1",
+        "envVar": "AWS_REGION"
+      }
+    ]
+  },
+  "envVars": [
+    "AWS_ACCESS_KEY_ID",
+    "AWS_SECRET_ACCESS_KEY",
+    "AWS_REGION"
+  ],
+  "tools": [
+    {
+      "name": "list-s3-buckets",
+      "description": "List all S3 buckets in your AWS account",
+      "file": "ai/tools/list-s3-buckets.ts"
+    },
+    {
+      "name": "list-s3-objects",
+      "description": "List objects in a specific S3 bucket",
+      "file": "ai/tools/list-s3-objects.ts"
+    },
+    {
+      "name": "get-s3-object",
+      "description": "Get the contents of an object from S3",
+      "file": "ai/tools/get-s3-object.ts"
+    },
+    {
+      "name": "list-ec2-instances",
+      "description": "List EC2 instances in your AWS account",
+      "file": "ai/tools/list-ec2-instances.ts"
+    },
+    {
+      "name": "list-lambda-functions",
+      "description": "List Lambda functions in your AWS account",
+      "file": "ai/tools/list-lambda-functions.ts"
+    }
+  ],
+  "dependencies": {
+    "@aws-sdk/client-s3": "^3.600.0",
+    "@aws-sdk/client-ec2": "^3.600.0",
+    "@aws-sdk/client-lambda": "^3.600.0",
+    "@aws-sdk/credential-providers": "^3.600.0"
+  },
+  "SETUP_GUIDE": "# AWS Integration Setup Guide\n\n## Step 1: Create an IAM User\n\n1. Log in to the [AWS Console](https://console.aws.amazon.com/)\n2. Navigate to **IAM** (Identity and Access Management)\n3. Click on **Users** in the left sidebar\n4. Click **Add users**\n5. Enter a username (e.g., `veryfront-integration`)\n6. Select **Access key - Programmatic access**\n7. Click **Next: Permissions**\n\n## Step 2: Attach Permissions\n\nYou can either:\n\n### Option A: Create a Custom Policy (Recommended)\n\n1. Click **Attach existing policies directly**\n2. Click **Create policy**\n3. Choose the **JSON** tab\n4. Paste the following policy:\n\n```json\n{\n  \"Version\": \"2012-10-17\",\n  \"Statement\": [\n    {\n      \"Effect\": \"Allow\",\n      \"Action\": [\n        \"s3:ListAllMyBuckets\",\n        \"s3:ListBucket\",\n        \"s3:GetObject\",\n        \"ec2:DescribeInstances\",\n        \"lambda:ListFunctions\"\n      ],\n      \"Resource\": \"*\"\n    }\n  ]\n}\n```\n\n5. Click **Review policy**\n6. Name it `VeryfrontAWSIntegration`\n7. Click **Create policy**\n8. Go back to the user creation tab and refresh the policy list\n9. Search for and select `VeryfrontAWSIntegration`\n\n### Option B: Use AWS Managed Policies\n\nAttach these managed policies:\n- `AmazonS3ReadOnlyAccess`\n- `AmazonEC2ReadOnlyAccess`\n- `AWSLambdaReadOnlyAccess`\n\n**Note:** Option B provides broader read access than Option A.\n\n## Step 3: Complete User Creation\n\n1. Click **Next: Tags** (optional)\n2. Click **Next: Review**\n3. Click **Create user**\n4. **Important:** Save your credentials:\n   - **Access Key ID**\n   - **Secret Access Key**\n   \n   ⚠️ This is the only time you'll be able to see the Secret Access Key!\n\n## Step 4: Configure Environment Variables\n\n1. Copy the `.env.example` file to `.env.local`\n2. Add your AWS credentials:\n\n```env\nAWS_ACCESS_KEY_ID=your_access_key_id_here\nAWS_SECRET_ACCESS_KEY=your_secret_access_key_here\nAWS_REGION=us-east-1\n```\n\n3. Replace `your_access_key_id_here` and `your_secret_access_key_here` with your actual credentials\n4. Update `AWS_REGION` to your preferred region (e.g., `us-west-2`, `eu-west-1`)\n\n## Step 5: Install Dependencies\n\nRun the following command to install required AWS SDK packages:\n\n```bash\nnpm install @aws-sdk/client-s3 @aws-sdk/client-ec2 @aws-sdk/client-lambda @aws-sdk/credential-providers\n```\n\n## Step 6: Test Your Integration\n\nYou can test your integration by using any of the available tools:\n\n- `list-s3-buckets` - List all your S3 buckets\n- `list-s3-objects` - List objects in a specific bucket\n- `get-s3-object` - Retrieve an object from S3\n- `list-ec2-instances` - List your EC2 instances\n- `list-lambda-functions` - List your Lambda functions\n\n## Security Best Practices\n\n1. **Never commit your `.env.local` file** - It's already in `.gitignore`\n2. **Use the principle of least privilege** - Only grant permissions needed\n3. **Rotate credentials regularly** - Update your access keys periodically\n4. **Use different credentials for different environments** - Dev, staging, and production\n5. **Consider using AWS IAM Roles** - For production environments, use IAM roles with EC2/ECS/Lambda\n\n## Troubleshooting\n\n### \"Access Denied\" Errors\n\n- Verify your IAM user has the correct permissions\n- Check that the region in your `.env.local` matches where your resources are located\n\n### \"Invalid Access Key\" Errors\n\n- Double-check your `AWS_ACCESS_KEY_ID` and `AWS_SECRET_ACCESS_KEY`\n- Ensure there are no extra spaces or newlines in your credentials\n- Verify the IAM user is active and the access key hasn't been deleted\n\n### Region Issues\n\n- Some resources are region-specific (EC2, Lambda)\n- S3 bucket listing is global, but object access respects bucket regions\n- Update `AWS_REGION` to match where your resources are located\n\n## Additional Resources\n\n- [AWS IAM User Guide](https://docs.aws.amazon.com/IAM/latest/UserGuide/)\n- [AWS SDK for JavaScript v3](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/)\n- [AWS Security Best Practices](https://aws.amazon.com/security/best-practices/)"
+}

package/dist/integrations/aws/files/_env.example

@@ -0,0 +1,10 @@
+# AWS Integration Configuration
+
+# AWS Access Key ID (from IAM user)
+AWS_ACCESS_KEY_ID=your_access_key_id_here
+
+# AWS Secret Access Key (from IAM user)
+AWS_SECRET_ACCESS_KEY=your_secret_access_key_here
+
+# AWS Region (e.g., us-east-1, us-west-2, eu-west-1)
+AWS_REGION=us-east-1

package/dist/integrations/aws/files/ai/tools/get-s3-object.ts

@@ -0,0 +1,62 @@
+import { tool } from 'veryfront/ai';
+import { z } from 'zod';
+import { getAWSClient } from '../../lib/aws-client';
+
+/**
+ * Tool for retrieving an object from S3
+ */
+export const getS3ObjectTool = tool({
+  name: 'get-s3-object',
+  description: 'Get the contents of an object from an S3 bucket. Returns the object content as a string.',
+  input: z.object({
+    bucket: z.string().describe('The name of the S3 bucket'),
+    key: z.string().describe('The key (path) of the object to retrieve'),
+  }),
+  execute: async ({ bucket, key }) => {
+    try {
+      const client = getAWSClient();
+      const content = await client.getS3Object(bucket, key);
+
+      // Check if content is likely binary (this is a simple heuristic)
+      const isBinary = /[\x00-\x08\x0E-\x1F]/.test(content.substring(0, 8000));
+
+      if (isBinary) {
+        return {
+          success: true,
+          message: `Retrieved object "${key}" from bucket "${bucket}". Content appears to be binary.`,
+          bucket,
+          key,
+          contentType: 'binary',
+          contentLength: content.length,
+          contentPreview: '[Binary content - not displayed]',
+        };
+      }
+
+      // For text content, provide preview if too long
+      const maxPreviewLength = 10000;
+      const contentPreview = content.length > maxPreviewLength
+        ? content.substring(0, maxPreviewLength) + '\n... [truncated]'
+        : content;
+
+      return {
+        success: true,
+        message: `Retrieved object "${key}" from bucket "${bucket}".`,
+        bucket,
+        key,
+        contentType: 'text',
+        contentLength: content.length,
+        content: contentPreview,
+        truncated: content.length > maxPreviewLength,
+      };
+    } catch (error) {
+      return {
+        success: false,
+        error: error instanceof Error ? error.message : 'Failed to get S3 object',
+        bucket,
+        key,
+      };
+    }
+  },
+});
+
+export default getS3ObjectTool;

package/dist/integrations/aws/files/ai/tools/list-ec2-instances.ts

@@ -0,0 +1,56 @@
+import { tool } from 'veryfront/ai';
+import { z } from 'zod';
+import { getAWSClient } from '../../lib/aws-client';
+
+/**
+ * Tool for listing EC2 instances
+ */
+export const listEC2InstancesTool = tool({
+  name: 'list-ec2-instances',
+  description: 'List all EC2 instances in your AWS account. Returns instance details including ID, type, state, and IP addresses.',
+  input: z.object({
+    region: z.string().optional().describe('AWS region to list instances from (e.g., "us-east-1", "eu-west-1"). Defaults to configured region.'),
+  }),
+  execute: async ({ region }) => {
+    try {
+      const client = getAWSClient();
+      const instances = await client.listEC2Instances(region);
+
+      if (instances.length === 0) {
+        const regionMessage = region ? ` in region "${region}"` : '';
+        return {
+          success: true,
+          message: `No EC2 instances found${regionMessage}.`,
+          instances: [],
+          region,
+        };
+      }
+
+      return {
+        success: true,
+        message: `Found ${instances.length} EC2 instance${instances.length === 1 ? '' : 's'}${region ? ` in region "${region}"` : ''}.`,
+        instances: instances.map(instance => ({
+          instanceId: instance.instanceId,
+          instanceType: instance.instanceType,
+          state: instance.state,
+          name: instance.name || 'N/A',
+          publicIpAddress: instance.publicIpAddress || 'N/A',
+          privateIpAddress: instance.privateIpAddress || 'N/A',
+          availabilityZone: instance.availabilityZone || 'N/A',
+          launchTime: instance.launchTime?.toISOString(),
+        })),
+        count: instances.length,
+        region,
+      };
+    } catch (error) {
+      return {
+        success: false,
+        error: error instanceof Error ? error.message : 'Failed to list EC2 instances',
+        instances: [],
+        region,
+      };
+    }
+  },
+});
+
+export default listEC2InstancesTool;

package/dist/integrations/aws/files/ai/tools/list-lambda-functions.ts

@@ -0,0 +1,57 @@
+import { tool } from 'veryfront/ai';
+import { z } from 'zod';
+import { getAWSClient } from '../../lib/aws-client';
+
+/**
+ * Tool for listing Lambda functions
+ */
+export const listLambdaFunctionsTool = tool({
+  name: 'list-lambda-functions',
+  description: 'List all Lambda functions in your AWS account. Returns function details including name, ARN, runtime, and configuration.',
+  input: z.object({
+    region: z.string().optional().describe('AWS region to list Lambda functions from (e.g., "us-east-1", "eu-west-1"). Defaults to configured region.'),
+  }),
+  execute: async ({ region }) => {
+    try {
+      const client = getAWSClient();
+      const functions = await client.listLambdaFunctions(region);
+
+      if (functions.length === 0) {
+        const regionMessage = region ? ` in region "${region}"` : '';
+        return {
+          success: true,
+          message: `No Lambda functions found${regionMessage}.`,
+          functions: [],
+          region,
+        };
+      }
+
+      return {
+        success: true,
+        message: `Found ${functions.length} Lambda function${functions.length === 1 ? '' : 's'}${region ? ` in region "${region}"` : ''}.`,
+        functions: functions.map(func => ({
+          functionName: func.functionName,
+          functionArn: func.functionArn,
+          runtime: func.runtime || 'N/A',
+          handler: func.handler || 'N/A',
+          codeSize: func.codeSize,
+          lastModified: func.lastModified,
+          memorySize: func.memorySize || 'N/A',
+          timeout: func.timeout || 'N/A',
+          description: func.description || 'No description',
+        })),
+        count: functions.length,
+        region,
+      };
+    } catch (error) {
+      return {
+        success: false,
+        error: error instanceof Error ? error.message : 'Failed to list Lambda functions',
+        functions: [],
+        region,
+      };
+    }
+  },
+});
+
+export default listLambdaFunctionsTool;

package/dist/integrations/aws/files/ai/tools/list-s3-buckets.ts

@@ -0,0 +1,44 @@
+import { tool } from 'veryfront/ai';
+import { z } from 'zod';
+import { getAWSClient } from '../../lib/aws-client';
+
+/**
+ * Tool for listing all S3 buckets in the AWS account
+ */
+export const listS3BucketsTool = tool({
+  name: 'list-s3-buckets',
+  description: 'List all S3 buckets in your AWS account. Returns bucket names and creation dates.',
+  input: z.object({}),
+  execute: async () => {
+    try {
+      const client = getAWSClient();
+      const buckets = await client.listS3Buckets();
+
+      if (buckets.length === 0) {
+        return {
+          success: true,
+          message: 'No S3 buckets found in your AWS account.',
+          buckets: [],
+        };
+      }
+
+      return {
+        success: true,
+        message: `Found ${buckets.length} S3 bucket${buckets.length === 1 ? '' : 's'}.`,
+        buckets: buckets.map(bucket => ({
+          name: bucket.name,
+          creationDate: bucket.creationDate?.toISOString(),
+        })),
+        count: buckets.length,
+      };
+    } catch (error) {
+      return {
+        success: false,
+        error: error instanceof Error ? error.message : 'Failed to list S3 buckets',
+        buckets: [],
+      };
+    }
+  },
+});
+
+export default listS3BucketsTool;

package/dist/integrations/aws/files/ai/tools/list-s3-objects.ts

@@ -0,0 +1,58 @@
+import { tool } from 'veryfront/ai';
+import { z } from 'zod';
+import { getAWSClient } from '../../lib/aws-client';
+
+/**
+ * Tool for listing objects in an S3 bucket
+ */
+export const listS3ObjectsTool = tool({
+  name: 'list-s3-objects',
+  description: 'List objects in a specific S3 bucket. Optionally filter by prefix and limit the number of results.',
+  input: z.object({
+    bucket: z.string().describe('The name of the S3 bucket to list objects from'),
+    prefix: z.string().optional().describe('Optional prefix to filter objects (e.g., "folder/" or "images/")'),
+    maxKeys: z.number().min(1).max(1000).optional().describe('Maximum number of objects to return (default: 1000)'),
+  }),
+  execute: async ({ bucket, prefix, maxKeys }) => {
+    try {
+      const client = getAWSClient();
+      const objects = await client.listS3Objects(bucket, prefix, maxKeys);
+
+      if (objects.length === 0) {
+        const prefixMessage = prefix ? ` with prefix "${prefix}"` : '';
+        return {
+          success: true,
+          message: `No objects found in bucket "${bucket}"${prefixMessage}.`,
+          objects: [],
+          bucket,
+          prefix,
+        };
+      }
+
+      return {
+        success: true,
+        message: `Found ${objects.length} object${objects.length === 1 ? '' : 's'} in bucket "${bucket}"${prefix ? ` with prefix "${prefix}"` : ''}.`,
+        objects: objects.map(obj => ({
+          key: obj.key,
+          size: obj.size,
+          lastModified: obj.lastModified?.toISOString(),
+          etag: obj.etag,
+          storageClass: obj.storageClass,
+        })),
+        count: objects.length,
+        bucket,
+        prefix,
+      };
+    } catch (error) {
+      return {
+        success: false,
+        error: error instanceof Error ? error.message : 'Failed to list S3 objects',
+        objects: [],
+        bucket,
+        prefix,
+      };
+    }
+  },
+});
+
+export default listS3ObjectsTool;