needware-cli 1.5.21 → 1.5.23

package/dist/commands/system-prompt.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"system-prompt.d.ts","sourceRoot":"","sources":["../../src/commands/system-prompt.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,UAAU,cAAc;IACtB,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAoKD,wBAAgB,eAAe,CAC7B,UAAU,EAAE,MAAM,EAClB,QAAQ,CAAC,EAAE,cAAc,GACxB,MAAM,CA+YR"}
+{"version":3,"file":"system-prompt.d.ts","sourceRoot":"","sources":["../../src/commands/system-prompt.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,UAAU,cAAc;IACtB,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,wBAAgB,eAAe,CAC7B,UAAU,EAAE,MAAM,EAClB,QAAQ,CAAC,EAAE,cAAc,GACxB,MAAM,CA8YR"}

package/dist/commands/system-prompt.js

@@ -1,163 +1,6 @@
 /**
  * System prompt for Agent command
  */
-function getDatabaseInstructions(supabase) {
-    const hasSupabaseProject = supabase?.hasSelectedProject && supabase?.projectId && supabase?.publishableKey;
-    if (!hasSupabaseProject && !supabase) {
-        return `
-## Database Instructions
-
-CRITICAL: Use Supabase for databases by default, unless specified otherwise. Supabase can provide login, register, database query, authorization, storage, Edge Functions etc.
-
-Supabase project setup handled separately by user!
-`;
-    }
-    if (supabase && !supabase.hasSelectedProject) {
-        return `
-## Database Instructions
-
-CRITICAL: Use Supabase for databases by default, unless specified otherwise. Supabase can provide login, register, database query, authorization, storage, Edge Functions etc.
-
-Supabase project setup handled separately by user! No project selected. Remind user to select project in chat box.
-`;
-    }
-    const envConfig = hasSupabaseProject && supabase.url
-        ? ` with:
-  VITE_SUPABASE_PROJECT_ID="${supabase.projectId}"
-  VITE_SUPABASE_PUBLISHABLE_KEY="${supabase.publishableKey}"
-  VITE_SUPABASE_URL="${supabase.url}"`
-        : '.';
-    return `
-## Database Instructions
-
-CRITICAL: Use Supabase for databases by default, unless specified otherwise. Supabase can provide login, register, database query, authorization, storage, Edge Functions etc.
-
-Create .env file if it doesn't exist${envConfig}
-
-### IMPORTANT: If user says "Enable Cloud" or asks to initialize Supabase:
-
-You MUST immediately perform these steps WITHOUT asking for clarification:
-
-1. **Install Supabase client** (if not already installed):
-   Run: \`pnpm add @supabase/supabase-js\`
-
-2. **Create/Update .env file** with project credentials:
-   \`\`\`
-   VITE_SUPABASE_PROJECT_ID=${supabase.projectId}
-   VITE_SUPABASE_PUBLISHABLE_KEY=${supabase.publishableKey}
-   VITE_SUPABASE_URL=${supabase.url}
-   \`\`\`
-
-3. **Create Supabase client file** at \`src/lib/supabase.ts\`:
-   \`\`\`typescript
-   import { createClient } from '@supabase/supabase-js';
-   
-   const supabaseUrl = import.meta.env.VITE_SUPABASE_URL;
-   const supabaseKey = import.meta.env.VITE_SUPABASE_PUBLISHABLE_KEY;
-   
-   if (!supabaseUrl || !supabaseKey) {
-     throw new Error('Missing Supabase environment variables');
-   }
-   
-   export const supabase = createClient(supabaseUrl, supabaseKey);
-   \`\`\`
-
-4. **Create migrations directory**: \`supabase/migrations/\` (if not exists)
-
-5. **Inform user** that Supabase is now initialized and ready to use
-
-### DATA PRESERVATION REQUIREMENTS:
-- DATA INTEGRITY IS HIGHEST PRIORITY - users must NEVER lose data
-- FORBIDDEN: Destructive operations (DROP, DELETE) that could cause data loss
-- FORBIDDEN: Transaction control (BEGIN, COMMIT, ROLLBACK, END)
-  Note: DO $$ BEGIN ... END $$ blocks (PL/pgSQL) are allowed
-
-### SQL Migrations - CRITICAL:
-For EVERY database change, create a migration file in /supabase/migrations/ directory:
-
-1. Create a new .sql file with descriptive name (e.g., create_users_table.sql)
-2. Write complete SQL migration content with comments
-3. Include safety checks (IF EXISTS/IF NOT EXISTS)
-4. Always enable RLS and add appropriate policies
-
-### Migration Rules:
-- NEVER use diffs, ALWAYS provide COMPLETE file content
-- Create new migration file for each change in /home/project/supabase/migrations
-- NEVER update existing migration files
-- Descriptive names without number prefix (e.g., create_users.sql)
-- ALWAYS enable RLS: \`alter table users enable row level security;\`
-- Add appropriate RLS policies for CRUD operations
-- Use default values: DEFAULT false/true, DEFAULT 0, DEFAULT '', DEFAULT now()
-- Start with markdown summary in multi-line comment explaining changes
-- Use IF EXISTS/IF NOT EXISTS for safe operations
-
-### Migration Example:
-\`\`\`sql
-/*
-  # Create users table
-  1. New Tables: users (id uuid, email text, created_at timestamp)
-  2. Security: Enable RLS, add read policy for authenticated users
-*/
-CREATE TABLE IF NOT EXISTS users (
-  id uuid PRIMARY KEY DEFAULT gen_random_uuid(),
-  email text UNIQUE NOT NULL,
-  created_at timestamptz DEFAULT now()
-);
-ALTER TABLE users ENABLE ROW LEVEL SECURITY;
-CREATE POLICY "Users read own data" ON users FOR SELECT TO authenticated USING (auth.uid() = id);
-\`\`\`
-
-### Client Setup:
-- Use @supabase/supabase-js
-- Create singleton client instance in \`src/lib/supabase.ts\`
-- Use environment variables: VITE_SUPABASE_URL and VITE_SUPABASE_PUBLISHABLE_KEY
-- Example client setup:
-  \`\`\`typescript
-  import { createClient } from '@supabase/supabase-js';
-  
-  const supabaseUrl = import.meta.env.VITE_SUPABASE_URL;
-  const supabaseKey = import.meta.env.VITE_SUPABASE_PUBLISHABLE_KEY;
-  
-  export const supabase = createClient(supabaseUrl, supabaseKey);
-  \`\`\`
-
-### Authentication:
-- ALWAYS use email/password signup
-- FORBIDDEN: magic links, social providers, SSO (unless explicitly stated)
-- FORBIDDEN: custom auth systems, ALWAYS use Supabase's built-in auth
-- Email confirmation ALWAYS disabled unless stated
-
-### User Profiles:
-- ALWAYS create public.profiles table linked to auth.users
-- Use: \`user_id uuid REFERENCES auth.users(id) ON DELETE CASCADE UNIQUE NOT NULL\`
-- Include common fields: username, avatar_url, created_at, updated_at
-- Create trigger to auto-insert profile on user signup (INSERT INTO profiles on auth.users INSERT)
-
-### Storage (If the user needs):
-- Use Supabase Storage for file uploads (images, documents, etc.)
-- Create buckets in migrations: \`INSERT INTO storage.buckets (id, name, public) VALUES ('avatars', 'avatars', true)\`
-- ALWAYS add RLS policies for storage.objects table with bucket_id filter
-- Common operations: .upload(), .download(), .getPublicUrl(), .remove(), .list()
-- Organize files with user ID prefix: '{userId}/filename' for private files
-
-### Edge Functions (If the user needs):
-- Use Supabase Edge Functions for server-side logic, background tasks, webhooks, and API integrations
-- Create functions in /supabase/functions/<function-name>/index.ts
-- Use Deno runtime with TypeScript support
-- Import from: 'https://esm.sh/@supabase/supabase-js@2' for Supabase client
-- Access environment variables via Deno.env.get('VARIABLE_NAME')
-- Invoke from client: supabase.functions.invoke('function-name', { body: { ... } })
-- Common use cases: webhooks, scheduled jobs, third-party API calls, complex business logic
-- Return Response object: new Response(JSON.stringify(data), { headers: { 'Content-Type': 'application/json' } })
-
-### Security:
-- ALWAYS enable RLS for every new table
-- Create policies based on user authentication
-- One migration per logical change
-- Use descriptive policy names
-- Add indexes for frequently queried columns
-`;
-}
 export function getSystemPrompt(workingDir, supabase) {
     return `
 ## Working Directory Context
@@ -194,7 +37,6 @@ CRITICAL SECURITY RULES:
 - FORBIDDEN: Spawning daemon processes or background jobs
 - You may run standard development commands (pnpm, node, etc.) but NEVER manage system processes
 
-${getDatabaseInstructions(supabase)}
 
 ## Project Structure
 

package/dist/commands/system-prompt.js.map

@@ -1 +1 @@
-{"version":3,"file":"system-prompt.js","sourceRoot":"","sources":["../../src/commands/system-prompt.ts"],"names":[],"mappings":"AAAA;;GAEG;AASH,SAAS,uBAAuB,CAAC,QAAyB;IACxD,MAAM,kBAAkB,GAAG,QAAQ,EAAE,kBAAkB,IAAI,QAAQ,EAAE,SAAS,IAAI,QAAQ,EAAE,cAAc,CAAC;IAE3G,IAAI,CAAC,kBAAkB,IAAI,CAAC,QAAQ,EAAE,CAAC;QACrC,OAAO;;;;;;CAMV,CAAC;IACA,CAAC;IAED,IAAI,QAAQ,IAAI,CAAC,QAAQ,CAAC,kBAAkB,EAAE,CAAC;QAC7C,OAAO;;;;;;CAMV,CAAC;IACA,CAAC;IAED,MAAM,SAAS,GAAG,kBAAkB,IAAI,QAAQ,CAAC,GAAG;QAClD,CAAC,CAAC;8BACwB,QAAQ,CAAC,SAAS;mCACb,QAAQ,CAAC,cAAc;uBACnC,QAAQ,CAAC,GAAG,GAAG;QAClC,CAAC,CAAC,GAAG,CAAC;IAER,OAAO;;;;;sCAK6B,SAAS;;;;;;;;;;;8BAWjB,QAAQ,CAAC,SAAS;mCACb,QAAQ,CAAC,cAAc;uBACnC,QAAQ,CAAC,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+GlC,CAAC;AACF,CAAC;AAED,MAAM,UAAU,eAAe,CAC7B,UAAkB,EAClB,QAAyB;IAEzB,OAAO;;;+CAGsC,UAAU;;wEAEe,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA8BhF,uBAAuB,CAAC,QAAQ,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;WA0WxB,CAAC,IAAI,EAAE,CAAC;AACnB,CAAC"}
+{"version":3,"file":"system-prompt.js","sourceRoot":"","sources":["../../src/commands/system-prompt.ts"],"names":[],"mappings":"AAAA;;GAEG;AASH,MAAM,UAAU,eAAe,CAC7B,UAAkB,EAClB,QAAyB;IAEzB,OAAO;;;+CAGsC,UAAU;;wEAEe,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;WAuYvE,CAAC,IAAI,EAAE,CAAC;AACnB,CAAC"}

package/dist/tools/add-secret-tool.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Add Secret Tool
+ * Tool for adding secrets to Supabase project
+ */
+import { BaseTool } from './base-tool.js';
+import { ToolDefinition, ToolResult } from '../types/tool.js';
+import { z } from 'zod';
+export declare class AddSecretTool extends BaseTool {
+    definition: ToolDefinition;
+    getZodSchema(): {
+        placeholder: z.ZodString;
+    };
+    execute(input: Record<string, any>): Promise<ToolResult>;
+}
+//# sourceMappingURL=add-secret-tool.d.ts.map

package/dist/tools/add-secret-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"add-secret-tool.d.ts","sourceRoot":"","sources":["../../src/tools/add-secret-tool.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9D,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,qBAAa,aAAc,SAAQ,QAAQ;IACzC,UAAU,EAAE,cAAc,CAaxB;IAEF,YAAY;;;IAMN,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC;CA4B/D"}

package/dist/tools/add-secret-tool.js

@@ -0,0 +1,53 @@
+/**
+ * Add Secret Tool
+ * Tool for adding secrets to Supabase project
+ */
+import { BaseTool } from './base-tool.js';
+import chalk from 'chalk';
+import { z } from 'zod';
+export class AddSecretTool extends BaseTool {
+    definition = {
+        name: 'add-secret',
+        description: 'Add a secret (environment variable) to the Supabase project for use in Edge Functions',
+        input_schema: {
+            type: 'object',
+            properties: {
+                placeholder: {
+                    type: 'string',
+                    description: 'The placeholder of the secret (environment variable), e.g., RESEND_API_KEY',
+                },
+            },
+            required: ['placeholder'],
+        },
+    };
+    getZodSchema() {
+        return {
+            placeholder: z.string().min(1).describe('The placeholder of the secret (environment variable)'),
+        };
+    }
+    async execute(input) {
+        try {
+            // 验证输入参数
+            this.validateInput(input, ['placeholder']);
+            const { placeholder } = input;
+            console.log(chalk.blue(`\n🔐 准备添加密钥: ${placeholder}...\n`));
+            console.log(chalk.green(`\n✓ 密钥 "${placeholder}" 准备就绪\n`));
+            // 构建返回的 JSON 数据
+            const resultData = {
+                placeholder: placeholder,
+                secret_added: false,
+                secret_names: [placeholder],
+                requires_approval: true,
+                message: '密钥等待用户提供值',
+                instructions: `请在 Supabase 项目设置中添加此密钥，或使用 Supabase CLI: supabase secrets set ${placeholder}=your_value_here`
+            };
+            return this.successWithContent(JSON.stringify(resultData, null, 2));
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : '生成密钥请求失败';
+            console.log(chalk.red(`\n✖ ${message}\n`));
+            return this.errorWithContent(message);
+        }
+    }
+}
+//# sourceMappingURL=add-secret-tool.js.map

package/dist/tools/add-secret-tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"add-secret-tool.js","sourceRoot":"","sources":["../../src/tools/add-secret-tool.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1C,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,OAAO,aAAc,SAAQ,QAAQ;IACzC,UAAU,GAAmB;QAC3B,IAAI,EAAE,YAAY;QAClB,WAAW,EAAE,uFAAuF;QACpG,YAAY,EAAE;YACZ,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,WAAW,EAAE;oBACX,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,4EAA4E;iBAC1F;aACF;YACD,QAAQ,EAAE,CAAC,aAAa,CAAC;SAC1B;KACF,CAAC;IAEF,YAAY;QACV,OAAO;YACL,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,sDAAsD,CAAC;SAChG,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,KAA0B;QACtC,IAAI,CAAC;YACH,SAAS;YACT,IAAI,CAAC,aAAa,CAAC,KAAK,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC;YAE3C,MAAM,EAAE,WAAW,EAAE,GAAG,KAAK,CAAC;YAE9B,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,gBAAgB,WAAW,OAAO,CAAC,CAAC,CAAC;YAE5D,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,WAAW,WAAW,UAAU,CAAC,CAAC,CAAC;YAE3D,gBAAgB;YAChB,MAAM,UAAU,GAAG;gBACjB,WAAW,EAAE,WAAW;gBACxB,YAAY,EAAE,KAAK;gBACnB,YAAY,EAAE,CAAC,WAAW,CAAC;gBAC3B,iBAAiB,EAAE,IAAI;gBACvB,OAAO,EAAE,WAAW;gBACpB,YAAY,EAAE,iEAAiE,WAAW,kBAAkB;aAC7G,CAAC;YAEF,OAAO,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,SAAS,CAAC,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QACtE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,UAAU,CAAC;YACpE,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,OAAO,IAAI,CAAC,CAAC,CAAC;YAC3C,OAAO,IAAI,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC;QACxC,CAAC;IACH,CAAC;CACF"}

package/dist/tools/index.d.ts

@@ -6,5 +6,6 @@ export { SupabaseEnableTool } from './supabase-enable-tool.js';
 export { SupabaseDeployFunctionsTool } from './supabase-deploy-functions-tool.js';
 export { SupabaseExecuteSqlTool } from './supabase-execute-sql-tool.js';
 export { AiGatewayEnableTool } from './ai-gateway-enable-tool.js';
+export { AddSecretTool } from './add-secret-tool.js';
 export { ToolRegistry, ToolConfig } from './tool-registry.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/tools/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,2BAA2B,EAAE,MAAM,qCAAqC,CAAC;AAClF,OAAO,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AACxE,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,2BAA2B,EAAE,MAAM,qCAAqC,CAAC;AAClF,OAAO,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AACxE,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/tools/index.js

@@ -6,5 +6,6 @@ export { SupabaseEnableTool } from './supabase-enable-tool.js';
 export { SupabaseDeployFunctionsTool } from './supabase-deploy-functions-tool.js';
 export { SupabaseExecuteSqlTool } from './supabase-execute-sql-tool.js';
 export { AiGatewayEnableTool } from './ai-gateway-enable-tool.js';
+export { AddSecretTool } from './add-secret-tool.js';
 export { ToolRegistry } from './tool-registry.js';
 //# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,QAAQ,EAAkB,MAAM,gBAAgB,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,2BAA2B,EAAE,MAAM,qCAAqC,CAAC;AAClF,OAAO,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AACxE,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,EAAE,YAAY,EAAc,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,QAAQ,EAAkB,MAAM,gBAAgB,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,2BAA2B,EAAE,MAAM,qCAAqC,CAAC;AAClF,OAAO,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AACxE,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAc,MAAM,oBAAoB,CAAC"}

package/dist/tools/tool-registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tool-registry.d.ts","sourceRoot":"","sources":["../../src/tools/tool-registry.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAMxD,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEhD,MAAM,WAAW,UAAU;IACzB,OAAO,CAAC,EAAE,cAAc,CAAC;CAC1B;AAED,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAgC;IAEpD;;;OAGG;IACH,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,UAAU,GAAG,IAAI;IAY5C;;;OAGG;IACH,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI;IAIjC;;;OAGG;IACH,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS;IAI1C;;OAEG;IACH,MAAM,CAAC,iBAAiB,IAAI,cAAc,EAAE;IAI5C;;OAEG;IACH,MAAM,CAAC,MAAM,IAAI,IAAI,EAAE;IAIvB;;;OAGG;IACH,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIjC;;;;OAIG;WACU,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC;IAQ5E;;OAEG;IACH,MAAM,CAAC,gBAAgB,IAAI,GAAG,EAAE;CAOjC"}
+{"version":3,"file":"tool-registry.d.ts","sourceRoot":"","sources":["../../src/tools/tool-registry.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAOxD,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEhD,MAAM,WAAW,UAAU;IACzB,OAAO,CAAC,EAAE,cAAc,CAAC;CAC1B;AAED,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAgC;IAEpD;;;OAGG;IACH,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,UAAU,GAAG,IAAI;IAa5C;;;OAGG;IACH,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI;IAIjC;;;OAGG;IACH,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS;IAI1C;;OAEG;IACH,MAAM,CAAC,iBAAiB,IAAI,cAAc,EAAE;IAI5C;;OAEG;IACH,MAAM,CAAC,MAAM,IAAI,IAAI,EAAE;IAIvB;;;OAGG;IACH,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIjC;;;;OAIG;WACU,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC;IAQ5E;;OAEG;IACH,MAAM,CAAC,gBAAgB,IAAI,GAAG,EAAE;CAOjC"}

package/dist/tools/tool-registry.js

@@ -6,6 +6,7 @@ import { SupabaseEnableTool } from './supabase-enable-tool.js';
 import { SupabaseDeployFunctionsTool } from './supabase-deploy-functions-tool.js';
 import { SupabaseExecuteSqlTool } from './supabase-execute-sql-tool.js';
 import { AiGatewayEnableTool } from './ai-gateway-enable-tool.js';
+import { AddSecretTool } from './add-secret-tool.js';
 export class ToolRegistry {
     static tools = new Map();
     /**
@@ -21,6 +22,7 @@ export class ToolRegistry {
         this.register(new SupabaseDeployFunctionsTool(config?.gateway));
         this.register(new SupabaseExecuteSqlTool(config?.gateway));
         this.register(new AiGatewayEnableTool(config?.gateway));
+        this.register(new AddSecretTool(config?.gateway));
     }
     /**
      * 注册工具

package/dist/tools/tool-registry.js.map

@@ -1 +1 @@
-{"version":3,"file":"tool-registry.js","sourceRoot":"","sources":["../../src/tools/tool-registry.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,2BAA2B,EAAE,MAAM,qCAAqC,CAAC;AAClF,OAAO,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AACxE,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAQlE,MAAM,OAAO,YAAY;IACf,MAAM,CAAC,KAAK,GAAsB,IAAI,GAAG,EAAE,CAAC;IAEpD;;;OAGG;IACH,MAAM,CAAC,UAAU,CAAC,MAAmB;QACnC,WAAW;QACX,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QAEnB,cAAc;QACd,eAAe;QACf,IAAI,CAAC,QAAQ,CAAC,IAAI,kBAAkB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;QACvD,IAAI,CAAC,QAAQ,CAAC,IAAI,2BAA2B,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;QAChE,IAAI,CAAC,QAAQ,CAAC,IAAI,sBAAsB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;QAC3D,IAAI,CAAC,QAAQ,CAAC,IAAI,mBAAmB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAC1D,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,QAAQ,CAAC,IAAU;QACxB,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAC7C,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,GAAG,CAAC,IAAY;QACrB,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,iBAAiB;QACtB,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACxE,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,MAAM;QACX,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;IACzC,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,GAAG,CAAC,IAAY;QACrB,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,IAAY,EAAE,KAA0B;QAC3D,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC5B,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,MAAM,IAAI,KAAK,CAAC,mBAAmB,IAAI,EAAE,CAAC,CAAC;QAC7C,CAAC;QACD,OAAO,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACnC,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,gBAAgB;QACrB,OAAO,IAAI,CAAC,iBAAiB,EAAE,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;YAC5C,IAAI,EAAE,GAAG,CAAC,IAAI;YACd,WAAW,EAAE,GAAG,CAAC,WAAW;YAC5B,YAAY,EAAE,GAAG,CAAC,YAAY;SAC/B,CAAC,CAAC,CAAC;IACN,CAAC;;AAGH,qCAAqC;AACrC,YAAY,CAAC,UAAU,EAAE,CAAC"}
+{"version":3,"file":"tool-registry.js","sourceRoot":"","sources":["../../src/tools/tool-registry.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,2BAA2B,EAAE,MAAM,qCAAqC,CAAC;AAClF,OAAO,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AACxE,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAQrD,MAAM,OAAO,YAAY;IACf,MAAM,CAAC,KAAK,GAAsB,IAAI,GAAG,EAAE,CAAC;IAEpD;;;OAGG;IACH,MAAM,CAAC,UAAU,CAAC,MAAmB;QACnC,WAAW;QACX,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QAEnB,cAAc;QACd,eAAe;QACf,IAAI,CAAC,QAAQ,CAAC,IAAI,kBAAkB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;QACvD,IAAI,CAAC,QAAQ,CAAC,IAAI,2BAA2B,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;QAChE,IAAI,CAAC,QAAQ,CAAC,IAAI,sBAAsB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;QAC3D,IAAI,CAAC,QAAQ,CAAC,IAAI,mBAAmB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;QACxD,IAAI,CAAC,QAAQ,CAAC,IAAI,aAAa,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACpD,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,QAAQ,CAAC,IAAU;QACxB,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAC7C,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,GAAG,CAAC,IAAY;QACrB,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,iBAAiB;QACtB,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACxE,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,MAAM;QACX,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;IACzC,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,GAAG,CAAC,IAAY;QACrB,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,IAAY,EAAE,KAA0B;QAC3D,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC5B,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,MAAM,IAAI,KAAK,CAAC,mBAAmB,IAAI,EAAE,CAAC,CAAC;QAC7C,CAAC;QACD,OAAO,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACnC,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,gBAAgB;QACrB,OAAO,IAAI,CAAC,iBAAiB,EAAE,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;YAC5C,IAAI,EAAE,GAAG,CAAC,IAAI;YACd,WAAW,EAAE,GAAG,CAAC,WAAW;YAC5B,YAAY,EAAE,GAAG,CAAC,YAAY;SAC/B,CAAC,CAAC,CAAC;IACN,CAAC;;AAGH,qCAAqC;AACrC,YAAY,CAAC,UAAU,EAAE,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "needware-cli",
-  "version": "1.5.21",
+  "version": "1.5.23",
   "description": "一个功能强大的 Node.js 命令行工具",
   "type": "module",
   "main": "dist/index.js",

package/skills/resend-integration/SKILL.md

@@ -0,0 +1,657 @@
+---
+name: resend-integration
+description: Complete Resend email integration for sending transactional emails, notifications, and alerts. REQUIRES Supabase integration as prerequisite (Resend functions run on Supabase Edge Functions). Use this skill when users mention sending emails, email notifications, transactional emails, or email alerts. 使用此技能处理邮件发送、邮件通知、事务性邮件等功能。必须先集成 Supabase 才能使用此技能。
+---
+
+# Resend Integration
+
+## Before Starting - Integration Check
+
+**CRITICAL**: Resend integration requires Supabase Edge Functions. Before proceeding, always check Supabase integration status:
+
+**Step 1: Check Supabase Integration**
+
+Check if Supabase is already integrated:
+- Look for `src/lib/supabase.ts` file
+- Check `.env` file for Supabase environment variables:
+  - `VITE_SUPABASE_PROJECT_ID`
+  - `VITE_SUPABASE_PUBLISHABLE_KEY`
+  - `VITE_SUPABASE_URL`
+- Check for `supabase/functions/` directory
+
+**Step 2: Handle Based on Status**
+
+**If Supabase is already integrated** (supabase.ts exists with valid configuration):
+- ✓ Proceed with Resend integration
+- Inform user: "✓ Supabase is integrated. Proceeding with Resend setup."
+
+**If Supabase is NOT integrated** (no supabase.ts or missing environment variables):
+- ❌ Stop immediately
+- Inform user: "⚠️ Supabase integration is required before setting up Resend. Resend email functions run on Supabase Edge Functions."
+- Suggest: "Please enable Supabase first by saying 'Enable Cloud' or use the supabase-integration skill."
+- Do NOT proceed with Resend setup until Supabase is properly configured
+
+**Step 3: Verify Edge Functions Support**
+
+Once Supabase is confirmed:
+- Check if `supabase/functions/` directory exists
+- If not, create the directory structure
+- Proceed with Resend Edge Function creation
+
+---
+
+## Quick Start
+
+### When to Use This Skill
+
+Use this skill when working with:
+- Transactional emails (welcome emails, password resets)
+- Email notifications (alerts, reminders)
+- Batch email sending
+- HTML email templates
+- Email verification and confirmation
+- User communication
+
+**关键原则**: 
+- ✅ 使用 Resend 作为邮件发送服务
+- ✅ 所有邮件功能通过 Supabase Edge Functions 实现
+- ⚠️ **必须先集成 Supabase** - Resend 依赖 Supabase Edge Functions 运行
+
+## Initial Setup
+
+### Prerequisites
+
+**Required**:
+1. ✅ **Supabase must be integrated** - Resend functions run on Supabase Edge Functions
+   - Verify `src/lib/supabase.ts` exists
+   - Verify Supabase environment variables are configured
+   - Verify `supabase/functions/` directory exists
+
+2. 🔑 **Resend API key** - If no API key is available, remind user to:
+   - Visit [Resend Dashboard](https://resend.com/api-keys)
+   - Create a new API key
+   - Add key to Supabase Edge Functions environment variables (`supabase/.env.local`)
+
+### Installation in Edge Functions
+
+**Step 1: Import Resend in Edge Function**
+
+Create a new Edge Function file in `/supabase/functions/<function-name>/index.ts`:
+
+```typescript
+import { serve } from "https://deno.land/std@0.190.0/http/server.ts";
+import { Resend } from "https://esm.sh/resend@2.0.0";
+
+const resend = new Resend(Deno.env.get("RESEND_API_KEY"));
+```
+
+**Step 2: Configure Environment Variables**
+
+Add to `/supabase/.env.local`:
+
+```env
+RESEND_API_KEY=re_your_api_key_here
+```
+
+**Step 3: CORS Headers Setup**
+
+Always include CORS headers for client-side invocation:
+
+```typescript
+const corsHeaders = {
+  "Access-Control-Allow-Origin": "*",
+  "Access-Control-Allow-Headers":
+    "authorization, x-client-info, apikey, content-type",
+};
+```
+
+## Email Sending Patterns
+
+### Basic Email Template
+
+```typescript
+import { serve } from "https://deno.land/std@0.190.0/http/server.ts";
+import { Resend } from "https://esm.sh/resend@2.0.0";
+
+const resend = new Resend(Deno.env.get("RESEND_API_KEY"));
+
+const corsHeaders = {
+  "Access-Control-Allow-Origin": "*",
+  "Access-Control-Allow-Headers":
+    "authorization, x-client-info, apikey, content-type",
+};
+
+interface EmailRequest {
+  to: string;
+  subject: string;
+  message: string;
+}
+
+const handler = async (req: Request): Promise<Response> => {
+  // Handle CORS preflight requests
+  if (req.method === "OPTIONS") {
+    return new Response(null, { headers: corsHeaders });
+  }
+
+  try {
+    const { to, subject, message }: EmailRequest = await req.json();
+
+    const { data, error } = await resend.emails.send({
+      from: "Your App <onboarding@resend.dev>",
+      to: [to],
+      subject: subject,
+      html: `<p>${message}</p>`,
+    });
+
+    if (error) {
+      throw new Error(error.message);
+    }
+
+    return new Response(
+      JSON.stringify({ success: true, data }),
+      {
+        status: 200,
+        headers: { "Content-Type": "application/json", ...corsHeaders },
+      }
+    );
+  } catch (error: any) {
+    console.error("Error sending email:", error);
+    return new Response(
+      JSON.stringify({ error: error.message }),
+      {
+        status: 500,
+        headers: { "Content-Type": "application/json", ...corsHeaders },
+      }
+    );
+  }
+};
+
+serve(handler);
+```
+
+### Batch Email Sending
+
+Send emails to multiple recipients:
+
+```typescript
+interface BatchEmailRequest {
+  recipients: {
+    name: string;
+    email: string;
+  }[];
+  subject: string;
+  message: string;
+}
+
+const handler = async (req: Request): Promise<Response> => {
+  if (req.method === "OPTIONS") {
+    return new Response(null, { headers: corsHeaders });
+  }
+
+  try {
+    const { recipients, subject, message }: BatchEmailRequest = await req.json();
+
+    if (!recipients || recipients.length === 0) {
+      return new Response(
+        JSON.stringify({ error: "No recipients provided" }),
+        {
+          status: 400,
+          headers: { "Content-Type": "application/json", ...corsHeaders },
+        }
+      );
+    }
+
+    // Send emails in parallel
+    const results = await Promise.all(
+      recipients.map(async (recipient) => {
+        const emailResponse = await resend.emails.send({
+          from: "Your App <onboarding@resend.dev>",
+          to: [recipient.email],
+          subject: subject,
+          html: `<p>Hi ${recipient.name},</p><p>${message}</p>`,
+        });
+        return { 
+          recipient: recipient.email, 
+          response: emailResponse 
+        };
+      })
+    );
+
+    return new Response(
+      JSON.stringify({ success: true, results }),
+      {
+        status: 200,
+        headers: { "Content-Type": "application/json", ...corsHeaders },
+      }
+    );
+  } catch (error: any) {
+    return new Response(
+      JSON.stringify({ error: error.message }),
+      {
+        status: 500,
+        headers: { "Content-Type": "application/json", ...corsHeaders },
+      }
+    );
+  }
+};
+```
+
+### Alert Email Example
+
+Complete example for sending alert emails:
+
+```typescript
+import { serve } from "https://deno.land/std@0.190.0/http/server.ts";
+import { Resend } from "https://esm.sh/resend@2.0.0";
+
+const resend = new Resend(Deno.env.get("RESEND_API_KEY"));
+
+const corsHeaders = {
+  "Access-Control-Allow-Origin": "*",
+  "Access-Control-Allow-Headers":
+    "authorization, x-client-info, apikey, content-type",
+};
+
+interface AlertEmailRequest {
+  contacts: {
+    name: string;
+    email: string;
+  }[];
+  userName?: string;
+  message?: string;
+}
+
+const handler = async (req: Request): Promise<Response> => {
+  if (req.method === "OPTIONS") {
+    return new Response(null, { headers: corsHeaders });
+  }
+
+  try {
+    const { contacts, userName = "用户", message }: AlertEmailRequest = await req.json();
+
+    if (!contacts || contacts.length === 0) {
+      return new Response(
+        JSON.stringify({ error: "No contacts provided" }),
+        {
+          status: 400,
+          headers: { "Content-Type": "application/json", ...corsHeaders },
+        }
+      );
+    }
+
+    const results = await Promise.all(
+      contacts.map(async (contact) => {
+        const emailResponse = await resend.emails.send({
+          from: "Your App <onboarding@resend.dev>",
+          to: [contact.email],
+          subject: `⚠️ Alert: ${userName} triggered notification`,
+          html: `
+            <div style="font-family: sans-serif; max-width: 600px; margin: 0 auto; padding: 20px;">
+              <h1 style="color: #f59e0b; border-bottom: 2px solid #f59e0b; padding-bottom: 10px;">
+                ⚠️ Alert Notification
+              </h1>
+              <p>Hi ${contact.name},</p>
+              <p>This is an alert notification from Your App.</p>
+              <p><strong>${userName}</strong> ${message || "has triggered an alert notification."}</p>
+              <div style="background: #fef3c7; padding: 15px; border-radius: 8px; margin: 20px 0;">
+                <p style="margin: 0; color: #92400e;">
+                  Please take appropriate action.
+                </p>
+              </div>
+              <p style="color: #666; font-size: 14px;">
+                This is an automated email from Your App.
+              </p>
+            </div>
+          `,
+        });
+        return { contact: contact.email, response: emailResponse };
+      })
+    );
+
+    console.log("Emails sent successfully:", results);
+
+    return new Response(
+      JSON.stringify({ success: true, results }),
+      {
+        status: 200,
+        headers: { "Content-Type": "application/json", ...corsHeaders },
+      }
+    );
+  } catch (error: any) {
+    console.error("Error in send-alert-email function:", error);
+    return new Response(
+      JSON.stringify({ error: error.message }),
+      {
+        status: 500,
+        headers: { "Content-Type": "application/json", ...corsHeaders },
+      }
+    );
+  }
+};
+
+serve(handler);
+```
+
+## Email Templates
+
+### Welcome Email Template
+
+```typescript
+const welcomeEmailHTML = (userName: string) => `
+  <div style="font-family: sans-serif; max-width: 600px; margin: 0 auto;">
+    <h1>Welcome to Our App!</h1>
+    <p>Hi ${userName},</p>
+    <p>Thank you for signing up. We're excited to have you on board!</p>
+    <a href="https://yourapp.com/get-started" 
+       style="background: #3b82f6; color: white; padding: 12px 24px; 
+              text-decoration: none; border-radius: 6px; display: inline-block;">
+      Get Started
+    </a>
+  </div>
+`;
+```
+
+### Password Reset Template
+
+```typescript
+const resetPasswordHTML = (resetLink: string) => `
+  <div style="font-family: sans-serif; max-width: 600px; margin: 0 auto;">
+    <h1>Reset Your Password</h1>
+    <p>Click the button below to reset your password:</p>
+    <a href="${resetLink}" 
+       style="background: #ef4444; color: white; padding: 12px 24px; 
+              text-decoration: none; border-radius: 6px; display: inline-block;">
+      Reset Password
+    </a>
+    <p style="color: #666; font-size: 14px; margin-top: 20px;">
+      If you didn't request this, please ignore this email.
+    </p>
+  </div>
+`;
+```
+
+### Notification Email Template
+
+```typescript
+const notificationEmailHTML = (title: string, content: string) => `
+  <div style="font-family: sans-serif; max-width: 600px; margin: 0 auto; padding: 20px;">
+    <h2 style="color: #1f2937; border-bottom: 2px solid #e5e7eb; padding-bottom: 10px;">
+      ${title}
+    </h2>
+    <div style="background: #f3f4f6; padding: 15px; border-radius: 8px; margin: 20px 0;">
+      <p style="margin: 0; color: #374151;">${content}</p>
+    </div>
+    <p style="color: #6b7280; font-size: 14px;">
+      This is an automated notification from Your App.
+    </p>
+  </div>
+`;
+```
+
+## Invoking from Client
+
+### Using Supabase Functions
+
+```typescript
+// In your React/Vue/etc. component
+import { supabase } from '@/lib/supabase';
+
+// Send single email
+const sendEmail = async () => {
+  const { data, error } = await supabase.functions.invoke('send-email', {
+    body: {
+      to: 'user@example.com',
+      subject: 'Hello from Your App',
+      message: 'This is a test email'
+    }
+  });
+
+  if (error) {
+    console.error('Error sending email:', error);
+    return;
+  }
+
+  console.log('Email sent:', data);
+};
+
+// Send alert emails
+const sendAlertEmails = async () => {
+  const { data, error } = await supabase.functions.invoke('send-alert-email', {
+    body: {
+      contacts: [
+        { name: 'John Doe', email: 'john@example.com' },
+        { name: 'Jane Smith', email: 'jane@example.com' }
+      ],
+      userName: '张三',
+      message: '触发了紧急通知'
+    }
+  });
+
+  if (error) {
+    console.error('Error sending alerts:', error);
+    return;
+  }
+
+  console.log('Alerts sent:', data);
+};
+```
+
+## Common Use Cases
+
+### 1. Welcome Emails
+Send when user signs up:
+```typescript
+const { data, error } = await supabase.functions.invoke('send-welcome-email', {
+  body: { email: user.email, name: user.name }
+});
+```
+
+### 2. Password Reset
+Send password reset link:
+```typescript
+const { data, error } = await supabase.functions.invoke('send-password-reset', {
+  body: { email: user.email, resetToken: token }
+});
+```
+
+### 3. Email Verification
+Send verification code:
+```typescript
+const { data, error } = await supabase.functions.invoke('send-verification', {
+  body: { email: user.email, code: verificationCode }
+});
+```
+
+### 4. Transaction Confirmations
+Send order/payment confirmations:
+```typescript
+const { data, error } = await supabase.functions.invoke('send-confirmation', {
+  body: { email: user.email, orderDetails: order }
+});
+```
+
+### 5. Scheduled Reminders
+Send reminder emails:
+```typescript
+const { data, error } = await supabase.functions.invoke('send-reminder', {
+  body: { email: user.email, reminderText: reminder }
+});
+```
+
+## Best Practices
+
+### 1. Email Sender Configuration
+
+**✅ DO**:
+- Use custom domain for production: `Your App <noreply@yourdomain.com>`
+- Use descriptive sender names
+- Keep sender email consistent
+
+**❌ DON'T**:
+- Use `onboarding@resend.dev` in production (for testing only)
+- Change sender email frequently
+- Use confusing sender names
+
+### 2. Error Handling
+
+Always handle errors gracefully:
+
+```typescript
+try {
+  const { data, error } = await resend.emails.send({...});
+  
+  if (error) {
+    console.error("Resend API error:", error);
+    throw new Error(error.message);
+  }
+  
+  return new Response(JSON.stringify({ success: true, data }), {...});
+} catch (error: any) {
+  console.error("Unexpected error:", error);
+  return new Response(
+    JSON.stringify({ error: error.message }),
+    { status: 500, headers: {...} }
+  );
+}
+```
+
+### 3. Rate Limiting
+
+Implement rate limiting for batch sends:
+
+```typescript
+// Send emails in batches of 10
+const batchSize = 10;
+for (let i = 0; i < recipients.length; i += batchSize) {
+  const batch = recipients.slice(i, i + batchSize);
+  await Promise.all(batch.map(recipient => sendEmail(recipient)));
+  // Add delay between batches if needed
+  await new Promise(resolve => setTimeout(resolve, 1000));
+}
+```
+
+### 4. HTML Email Best Practices
+
+**✅ DO**:
+- Use inline CSS styles
+- Keep width under 600px
+- Test on multiple email clients
+- Include plain text fallback
+- Use responsive design
+- Add unsubscribe links (if applicable)
+
+**❌ DON'T**:
+- Use external CSS files
+- Use JavaScript
+- Use complex layouts
+- Forget alt text for images
+
+### 5. Security
+
+**✅ DO**:
+- Store API key in environment variables
+- Validate input data
+- Sanitize user-generated content
+- Use HTTPS for all links
+- Implement rate limiting
+
+**❌ DON'T**:
+- Hardcode API keys
+- Trust user input without validation
+- Include sensitive data in emails
+- Allow arbitrary email sending
+
+## Debugging
+
+### Common Issues
+
+**1. Email not received**:
+- Check spam/junk folder
+- Verify recipient email address
+- Check Resend Dashboard for delivery status
+- Verify sender domain configuration
+
+**2. API Key errors**:
+- Verify `RESEND_API_KEY` in environment variables
+- Check API key is active in Resend Dashboard
+- Ensure proper Deno.env.get() usage
+
+**3. CORS errors**:
+- Verify CORS headers are included
+- Handle OPTIONS requests
+- Check browser console for specific errors
+
+**4. Function timeout**:
+- Reduce batch size
+- Optimize email sending logic
+- Check for blocking operations
+
+### Logging
+
+Add comprehensive logging:
+
+```typescript
+console.log("Sending email to:", recipient.email);
+console.log("Email response:", emailResponse);
+console.error("Error sending email:", error);
+```
+
+### Testing
+
+Test Edge Function locally:
+
+```bash
+supabase functions serve send-email --env-file supabase/.env.local
+```
+
+Test with curl:
+
+```bash
+curl -i --location --request POST 'http://localhost:54321/functions/v1/send-email' \
+  --header 'Authorization: Bearer YOUR_ANON_KEY' \
+  --header 'Content-Type: application/json' \
+  --data '{"to":"test@example.com","subject":"Test","message":"Hello"}'
+```
+
+## Project Structure
+
+```
+project-root/
+├── supabase/
+│   ├── functions/
+│   │   ├── send-email/
+│   │   │   └── index.ts          # Basic email sending
+│   │   ├── send-alert-email/
+│   │   │   └── index.ts          # Alert emails
+│   │   ├── send-welcome-email/
+│   │   │   └── index.ts          # Welcome emails
+│   │   └── send-notification/
+│   │       └── index.ts          # Notification emails
+│   └── .env.local                # RESEND_API_KEY
+├── src/
+│   ├── lib/
+│   │   └── supabase.ts           # Supabase Client
+│   └── components/
+│       └── EmailForm.tsx          # Email sending UI
+└── .env                          # Frontend env vars
+```
+
+## Additional Resources
+
+- [Resend Documentation](https://resend.com/docs)
+- [Resend API Reference](https://resend.com/docs/api-reference)
+- [Email Templates Best Practices](https://resend.com/docs/send-with-react)
+- [Supabase Edge Functions Guide](https://supabase.com/docs/guides/functions)
+
+## Migration Checklist
+
+When moving to production:
+
+- [ ] Register custom domain in Resend Dashboard
+- [ ] Update sender email from `onboarding@resend.dev` to custom domain
+- [ ] Configure SPF, DKIM, and DMARC records
+- [ ] Update `RESEND_API_KEY` with production key
+- [ ] Test all email flows
+- [ ] Set up email delivery monitoring
+- [ ] Implement unsubscribe functionality (if needed)
+- [ ] Add email preference management