@supacloud/cli 0.14.6 → 0.15.0

package/dist/index.js

@@ -6101,6 +6101,39 @@ function coerceCliValue(value) {
     return Number(value);
   return value;
 }
+var DUPLICATE_CLI_FLAG_MESSAGE = "Duplicate CLI flag is not allowed";
+function cliFlagAt(args, index) {
+  const argument = args[index];
+  if (!argument.startsWith("--") || argument.length <= 2)
+    return null;
+  const rawFlag = argument.slice(2);
+  const equalsIndex = rawFlag.indexOf("=");
+  if (equalsIndex >= 0) {
+    return { name: rawFlag.slice(0, equalsIndex), rawValue: rawFlag.slice(equalsIndex + 1), nextIndex: index };
+  }
+  const nextArgument = args[index + 1];
+  if (nextArgument !== undefined && !nextArgument.startsWith("--")) {
+    return { name: rawFlag, rawValue: nextArgument, nextIndex: index + 1 };
+  }
+  return { name: rawFlag, nextIndex: index };
+}
+function schemaCompatibleCliValue(field, rawValue) {
+  return field && exports_value2.Check(field, rawValue) ? rawValue : coerceCliValue(rawValue);
+}
+function parseCliFlags(args, startIndex, schema) {
+  const parsedFlags = Object.create(null);
+  const fields = schemaProperties(schema);
+  for (let index = startIndex;index < args.length; index++) {
+    const flag = cliFlagAt(args, index);
+    if (!flag)
+      continue;
+    index = flag.nextIndex;
+    if (Object.hasOwn(parsedFlags, flag.name))
+      throw new Error(DUPLICATE_CLI_FLAG_MESSAGE);
+    parsedFlags[flag.name] = flag.rawValue === undefined ? true : schemaCompatibleCliValue(fields[flag.name], flag.rawValue);
+  }
+  return parsedFlags;
+}
 async function runCli(cliTools, args, options = {}) {
   const commandName = options.commandName || "supacloud";
   const formatAvailableCommands = () => Object.keys(cliTools).filter((k) => !["setup_help", "deploy_web_console"].includes(k)).join(`
@@ -6168,28 +6201,14 @@ async function runCli(cliTools, args, options = {}) {
     process.exitCode = 0;
     return;
   }
-  const parsedArgs = {};
   let startIdx = 1;
   if (args.length > 1 && !args[1].startsWith("--")) {
-    parsedArgs.action = args[1];
     startIdx = 2;
   }
-  for (let i = startIdx;i < args.length; i++) {
-    const arg = args[i];
-    if (arg.startsWith("--") && arg.length > 2) {
-      const rawFlag = arg.slice(2);
-      const equalsIndex = rawFlag.indexOf("=");
-      const key = equalsIndex >= 0 ? rawFlag.slice(0, equalsIndex) : rawFlag;
-      let val = true;
-      if (equalsIndex >= 0) {
-        val = coerceCliValue(rawFlag.slice(equalsIndex + 1));
-      } else if (i + 1 < args.length && !args[i + 1].startsWith("--")) {
-        val = coerceCliValue(args[++i]);
-      }
-      parsedArgs[key] = val;
-    }
-  }
   try {
+    const parsedArgs = parseCliFlags(args, startIdx, tool.schema);
+    if (startIdx === 2)
+      parsedArgs.action = args[1];
     const validatedArgs = parseToolArguments(tool.schema, parsedArgs);
     const result = await tool.callback(validatedArgs);
     if (result && result.content && Array.isArray(result.content)) {
@@ -6213,50 +6232,106 @@ async function runCli(cliTools, args, options = {}) {
 }
 
 // src/shared/context.ts
+import { existsSync, readFileSync } from "node:fs";
 import { homedir } from "node:os";
 import { resolve } from "node:path";
-import { existsSync, readFileSync } from "node:fs";
-function readDotEnvFile(cwd) {
-  const envPath = resolve(cwd, ".env");
-  if (!existsSync(envPath))
-    return {};
+
+// src/shared/global-options.ts
+var GLOBAL_FLAGS = {
+  "--env": "environmentName",
+  "--env-file": "envFile",
+  "--confirm-production": "confirmProduction"
+};
+var ENVIRONMENT_NAME_PATTERN = /^[A-Za-z0-9][A-Za-z0-9_-]{0,63}$/;
+function globalFlag(arg) {
+  return Object.keys(GLOBAL_FLAGS).find((flag) => arg === flag || arg.startsWith(`${flag}=`)) ?? null;
+}
+function globalFlagValue(args, index, flag) {
+  const inlineValue = args[index].slice(flag.length + 1);
+  if (args[index].startsWith(`${flag}=`)) {
+    if (!inlineValue)
+      throw new Error(`${flag} requires a value`);
+    return { value: inlineValue, consumed: 1 };
+  }
+  const value = args[index + 1];
+  if (!value || value.startsWith("--"))
+    throw new Error(`${flag} requires a value`);
+  return { value, consumed: 2 };
+}
+function normalizeEnvironmentName(name) {
+  if (!ENVIRONMENT_NAME_PATTERN.test(name)) {
+    throw new Error("--env and SUPACLOUD_ENV must match ^[A-Za-z0-9][A-Za-z0-9_-]{0,63}$");
+  }
+  const normalized = name.toLowerCase();
+  return normalized === "prod" || normalized === "production" ? "production" : normalized;
+}
+function parseGlobalOptions(args) {
   const values = {};
-  try {
-    const envContent = readFileSync(envPath, "utf-8");
-    for (const line of envContent.split(`
-`)) {
-      const match = line.trim().match(/^([^=]+)=(.*)$/);
-      if (!match)
-        continue;
-      const key = match[1].trim();
-      const value = match[2].trim().replace(/^["']|["']$/g, "");
-      values[key] = value;
+  const remainingArgs = [];
+  for (let index = 0;index < args.length; ) {
+    const flag = globalFlag(args[index]);
+    if (!flag) {
+      remainingArgs.push(args[index]);
+      index += 1;
+      continue;
     }
-  } catch {
-    return {};
+    const key = GLOBAL_FLAGS[flag];
+    if (values[key] !== undefined)
+      throw new Error(`${flag} may be provided only once`);
+    const parsed = globalFlagValue(args, index, flag);
+    values[key] = parsed.value;
+    index += parsed.consumed;
+  }
+  if (values.environmentName && values.envFile) {
+    throw new Error("--env and --env-file are mutually exclusive");
+  }
+  if (values.environmentName)
+    normalizeEnvironmentName(values.environmentName);
+  return { ...values, args: remainingArgs };
+}
+
+// src/shared/context.ts
+var CORE_CONTEXT_KEYS = [
+  "SUPABASE_URL",
+  "SUPABASE_SERVICE_ROLE_KEY",
+  "SUPACLOUD_API_URL",
+  "SUPACLOUD_MANAGEMENT_API_URL",
+  "MANAGEMENT_API_URL",
+  "SUPACLOUD_API_TOKEN",
+  "SUPACLOUD_PROJECT_REF",
+  "X_PROJECT_REF",
+  "SUPACLOUD_HOST"
+];
+function unquotedEnvValue(rawValue) {
+  const value = rawValue.trim();
+  const quote = value[0];
+  return quote && (quote === '"' || quote === "'") && value.endsWith(quote) ? value.slice(1, -1) : value;
+}
+function parseEnvFile(contents) {
+  const values = {};
+  for (const rawLine of contents.split(/\r?\n/)) {
+    const line = rawLine.trim();
+    if (!line || line.startsWith("#"))
+      continue;
+    const match = line.match(/^([A-Za-z_][A-Za-z0-9_]*)=(.*)$/);
+    if (!match)
+      continue;
+    values[match[1]] = unquotedEnvValue(match[2]);
   }
   return values;
 }
-function pickValue(env, dotenv, keys) {
-  for (const key of keys) {
-    const envValue = env[key];
-    if (envValue)
-      return { value: envValue, source: "env" };
+function readEnvFile(path, required) {
+  if (!existsSync(path)) {
+    if (required)
+      throw new Error(`SupaCloud environment file not found: ${path}`);
+    return {};
   }
-  for (const key of keys) {
-    const dotenvValue = dotenv[key];
-    if (dotenvValue)
-      return { value: dotenvValue, source: "dotenv" };
+  try {
+    return parseEnvFile(readFileSync(path, "utf8"));
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    throw new Error(`Failed to read SupaCloud environment file ${path}: ${message}`);
   }
-  return { value: "", source: "env" };
-}
-function detectSource(sources) {
-  const present = new Set(sources.filter((value) => value !== "none"));
-  if (present.size === 0)
-    return "none";
-  if (present.size === 1)
-    return present.has("env") ? "env" : "dotenv";
-  return "mixed";
 }
 function normalizeUrl(value) {
   const trimmed = value.trim().replace(/\/+$/, "");
@@ -6279,8 +6354,7 @@ function inferProjectRefFromSupabaseUrl(value) {
   const normalized = normalizeUrl(value);
   if (!normalized)
     return "";
-  const match = new URL(normalized).hostname.match(/^([a-z0-9-]+)\.api\./i);
-  return match?.[1] ?? "";
+  return new URL(normalized).hostname.match(/^([a-z0-9-]+)\.api\./i)?.[1] ?? "";
 }
 function inferManagementApiUrlFromSupabaseUrl(value, projectRef = "") {
   const normalized = normalizeUrl(value);
@@ -6297,43 +6371,209 @@ function inferManagementApiUrlFromSupabaseUrl(value, projectRef = "") {
     url.hostname = `studio-${ref}.${host.slice(`${ref}.api.`.length)}`;
     return url.toString().replace(/\/+$/, "");
   }
-  const managedHostMatch = host.match(/^([a-z0-9-]+)\.api\.(.+)$/i);
-  if (managedHostMatch) {
-    url.hostname = `studio-${managedHostMatch[1]}.${managedHostMatch[2]}`;
+  const managedHost = host.match(/^([a-z0-9-]+)\.api\.(.+)$/i);
+  if (managedHost) {
+    url.hostname = `studio-${managedHost[1]}.${managedHost[2]}`;
     return url.toString().replace(/\/+$/, "");
   }
   return normalized;
 }
-function resolveSupaCloudContext(env = process.env, cwd = process.cwd()) {
-  const dotenv = readDotEnvFile(cwd);
-  const supabaseUrl = pickValue(env, dotenv, ["SUPABASE_URL"]);
-  const explicitApiUrl = pickValue(env, dotenv, ["SUPACLOUD_API_URL", "SUPACLOUD_MANAGEMENT_API_URL", "MANAGEMENT_API_URL"]);
-  const inferredToken = pickValue(env, dotenv, ["SUPABASE_SERVICE_ROLE_KEY", "SUPACLOUD_API_TOKEN"]);
-  const explicitProjectRef = pickValue(env, dotenv, ["SUPACLOUD_PROJECT_REF", "X_PROJECT_REF"]).value;
-  const hostFromEnv = env.SUPACLOUD_HOST;
-  const normalizedSupabaseUrl = normalizeUrl(supabaseUrl.value);
-  const projectRef = explicitProjectRef || inferProjectRefFromSupabaseUrl(normalizedSupabaseUrl);
-  const apiUrl = normalizeUrl(explicitApiUrl.value) || inferManagementApiUrlFromSupabaseUrl(normalizedSupabaseUrl, projectRef) || (hostFromEnv ? `http://${hostFromEnv}:9090` : "");
-  const resolvedHostFromUrl = hostFromUrl(apiUrl || normalizedSupabaseUrl);
+function sourceProjectCore(values) {
+  const supabaseUrl = normalizeUrl(values.SUPABASE_URL || "");
+  const projectRef = (values.SUPACLOUD_PROJECT_REF || values.X_PROJECT_REF || "").trim() || inferProjectRefFromSupabaseUrl(supabaseUrl);
+  const explicitApiUrl = values.SUPACLOUD_API_URL || values.SUPACLOUD_MANAGEMENT_API_URL || values.MANAGEMENT_API_URL || "";
+  const apiUrl = normalizeUrl(explicitApiUrl) || inferManagementApiUrlFromSupabaseUrl(supabaseUrl, projectRef) || (values.SUPACLOUD_HOST ? `http://${values.SUPACLOUD_HOST}:9090` : "");
+  const apiToken = values.SUPACLOUD_API_TOKEN || values.SUPABASE_SERVICE_ROLE_KEY || "";
+  return { apiUrl, apiToken, projectRef, supabaseUrl };
+}
+function processValues(env) {
+  return Object.fromEntries(Object.entries(env).filter((entry) => entry[1] !== undefined));
+}
+function hasProcessContext(env) {
+  return CORE_CONTEXT_KEYS.some((key) => Object.hasOwn(env, key));
+}
+function completeProjectContext(values) {
+  const core = sourceProjectCore(values);
+  return Boolean(core.apiUrl && core.apiToken && core.projectRef);
+}
+function namedEnvironmentSource(cwd, selector) {
+  const environment = normalizeEnvironmentName(selector);
+  const path = resolve(cwd, `.env.supacloud.${selector}`);
+  const values = readEnvFile(path, true);
+  if (values.SUPACLOUD_ENV && normalizeEnvironmentName(values.SUPACLOUD_ENV) !== environment) {
+    throw new Error(`SUPACLOUD_ENV in ${path} does not match selector ${selector}`);
+  }
+  return { values, kind: "named_env_file", path, environment };
+}
+function explicitEnvironmentSource(cwd, envFile) {
+  const path = resolve(cwd, envFile);
+  const values = readEnvFile(path, true);
+  if (!values.SUPACLOUD_ENV)
+    throw new Error(`SUPACLOUD_ENV is required in ${path}`);
   return {
-    host: hostFromEnv ?? resolvedHostFromUrl,
+    values,
+    kind: "explicit_env_file",
+    path,
+    environment: normalizeEnvironmentName(values.SUPACLOUD_ENV)
+  };
+}
+function contextSource(env, cwd, selection) {
+  if (selection.environmentName && selection.envFile)
+    throw new Error("Environment selectors are mutually exclusive");
+  if (selection.environmentName)
+    return namedEnvironmentSource(cwd, selection.environmentName);
+  if (selection.envFile)
+    return explicitEnvironmentSource(cwd, selection.envFile);
+  if (env.SUPACLOUD_ENV) {
+    const environment2 = normalizeEnvironmentName(env.SUPACLOUD_ENV);
+    const values2 = processValues(env);
+    if (completeProjectContext(values2)) {
+      return { values: values2, kind: "process_env", path: null, environment: environment2 };
+    }
+    return namedEnvironmentSource(cwd, env.SUPACLOUD_ENV);
+  }
+  if (hasProcessContext(env)) {
+    return { values: processValues(env), kind: "process_env", path: null, environment: "" };
+  }
+  const path = resolve(cwd, ".env");
+  const values = readEnvFile(path, false);
+  const environment = values.SUPACLOUD_ENV ? normalizeEnvironmentName(values.SUPACLOUD_ENV) : "";
+  return { values, kind: Object.keys(values).length ? "legacy_dotenv" : "none", path: existsSync(path) ? path : null, environment };
+}
+function resolveSupaCloudContext(env = process.env, cwd = process.cwd(), selection = {}) {
+  const source = contextSource(env, cwd, selection);
+  const core = sourceProjectCore(source.values);
+  const host = source.values.SUPACLOUD_HOST || hostFromUrl(core.apiUrl || core.supabaseUrl);
+  const readOnly = env.SUPACLOUD_READ_ONLY === "true" || source.values.SUPACLOUD_READ_ONLY === "true";
+  return {
+    host,
     sshUser: env.SUPACLOUD_SSH_USER ?? "root",
     sshPort: parseInt(env.SUPACLOUD_SSH_PORT ?? "22", 10),
     sshKey: env.SUPACLOUD_SSH_KEY ?? resolve(homedir(), ".ssh", "id_rsa"),
     sshPass: env.SUPACLOUD_SSH_PASS ?? "",
-    apiUrl,
-    apiToken: env.SUPACLOUD_API_TOKEN ?? inferredToken.value,
-    projectRef,
-    readOnly: env.SUPACLOUD_READ_ONLY === "true",
-    inferredSupabaseUrl: normalizedSupabaseUrl,
-    inferredServiceRoleKey: inferredToken.value,
-    source: detectSource([
-      supabaseUrl.value || explicitApiUrl.value ? supabaseUrl.value ? supabaseUrl.source : explicitApiUrl.source : "none",
-      inferredToken.value ? inferredToken.source : "none"
-    ])
+    apiUrl: core.apiUrl,
+    apiToken: core.apiToken,
+    projectRef: core.projectRef,
+    readOnly,
+    environment: source.environment,
+    production: source.environment === "prod" || source.environment === "production",
+    inferredSupabaseUrl: core.supabaseUrl,
+    inferredServiceRoleKey: source.values.SUPABASE_SERVICE_ROLE_KEY || "",
+    source: source.kind,
+    sourcePath: source.path
   };
 }
 
+// src/shared/execution-policy.ts
+var ACTION_POLICY = {
+  project: {
+    read: ["get", "health", "logs", "api_keys", "settings", "tasks", "task_detail", "task_stats", "dlq", "background_settings"],
+    write: ["task_cancel", "task_retry", "update_background_settings"]
+  },
+  database: {
+    read: ["list_tables", "describe_columns", "list_indexes", "list_constraints", "list_extensions", "rls_status", "rls_policies", "list_auth_users", "get_auth_user", "connections", "stats", "slow_queries", "list_migrations", "project_url", "generate_types"],
+    write: ["query", "apply_migration", "push_migrations", "baseline_migrations", "create_table_rls"]
+  },
+  supabase: {
+    local: ["version", "migration_new", "db_diff", "db_reset", "db_pull", "db_dump", "migration_list", "gen_types"],
+    write: ["push"]
+  },
+  auth: {
+    read: ["list_providers", "get_provider", "supported_providers", "get_settings", "get_config"],
+    write: ["configure_provider", "update_provider", "disable_provider", "wechat_mini", "wechat_open", "update_settings", "update_config"]
+  },
+  storage: {
+    read: ["status", "list_buckets", "list_files"],
+    write: ["upload_base64", "delete_file"]
+  },
+  edge_functions: {
+    read: ["list", "source"],
+    local: ["check"],
+    write: ["deploy", "deploy_bundle", "config", "activate", "delete"]
+  },
+  scheduled_functions: { read: ["list"], write: ["create", "update", "delete"] },
+  secrets: { read: ["list"], write: ["upsert", "delete"] },
+  frontend: {
+    read: ["list", "get", "build_logs", "list_frameworks", "list_records"],
+    write: ["create", "update", "delete", "deploy_git", "deploy_upload", "redeploy", "add_domain", "remove_domain", "set_env"]
+  },
+  task_events: { read: ["inspect_webhook"], write: ["register_webhook", "unregister_webhook"] },
+  diagnostics: { read: ["list_checks", "get_run"], write: ["run_checks", "repair"] },
+  gateway: {
+    read: ["routes", "get_certificate", "custom_hostname"],
+    write: ["upsert_route", "update_route", "delete_route", "config", "update_certificate", "issue_certificate", "deploy_certificate", "rebuild", "set_custom_hostname", "delete_custom_hostname", "verify_custom_hostname"]
+  },
+  branch: { read: ["list", "promotion_plan"], write: ["create", "delete", "promote"] },
+  queue: {
+    read: ["list", "stats", "list_messages", "dlq", "get_message", "get_settings"],
+    write: ["send", "receive", "ack", "release", "fail", "retry", "delete_message", "update_settings"]
+  },
+  ai: { local: ["show_skill", "install_skill"] }
+};
+function declaredMode(moduleName, action) {
+  const policy = ACTION_POLICY[moduleName];
+  if (!policy)
+    return;
+  for (const mode of ["read", "write", "local"]) {
+    if (policy[mode]?.includes(action))
+      return mode;
+  }
+  return;
+}
+function executionMode(moduleName, action, args) {
+  if (moduleName === "database" && ["push_migrations", "baseline_migrations"].includes(action) && args.dry_run === true)
+    return "read";
+  if (moduleName === "supabase" && action === "push" && args.dry_run === true)
+    return "read";
+  return declaredMode(moduleName, action);
+}
+function authorizeExecution(moduleName, args, authorization) {
+  const action = typeof args.action === "string" ? args.action : "";
+  if (!action)
+    return;
+  const mode = executionMode(moduleName, action, args);
+  const { context, confirmProduction } = authorization;
+  if (!mode && (context.production || context.readOnly)) {
+    throw new Error(`Execution policy has no classification for ${moduleName}.${action}`);
+  }
+  if (context.production && mode === "read" && typeof args.ref === "string" && args.ref && args.ref !== context.projectRef) {
+    throw new Error("Production profiles cannot target a different project with --ref");
+  }
+  if (mode !== "write")
+    return;
+  if (context.production && moduleName === "diagnostics" && action === "repair") {
+    throw new Error("diagnostics repair is forbidden in production environments");
+  }
+  if (context.readOnly) {
+    throw new Error(`Remote write ${moduleName}.${action} is blocked in read-only mode (SUPACLOUD_READ_ONLY=true)`);
+  }
+  if (!context.production)
+    return;
+  const requestedRef = args.ref ?? context.projectRef;
+  if (typeof requestedRef !== "string" || !requestedRef) {
+    throw new Error(`Production write ${moduleName}.${action} requires a project ref`);
+  }
+  if (requestedRef !== context.projectRef) {
+    throw new Error("Production profiles cannot target a different project with --ref");
+  }
+  if (confirmProduction !== context.projectRef || confirmProduction !== requestedRef) {
+    throw new Error(`Production write requires --confirm-production ${context.projectRef}`);
+  }
+}
+function validateExecutionPolicyCoverage(tools) {
+  for (const [moduleName, tool] of Object.entries(tools)) {
+    const actionSchema = schemaProperties(tool.schema).action;
+    if (!actionSchema)
+      continue;
+    const actions = schemaEnumValues(actionSchema);
+    for (const action of actions) {
+      if (!declaredMode(moduleName, String(action))) {
+        throw new Error(`Execution policy has no classification for ${moduleName}.${String(action)}`);
+      }
+    }
+  }
+}
+
 // src/shared/transports/http.ts
 var DEFAULT_TIMEOUT = 30000;
 var MAX_RETRIES = 2;
@@ -6348,6 +6588,16 @@ function isRetryableError(error) {
   const networkError = error;
   return networkError.name === "AbortError" || networkError.code === "ECONNREFUSED" || networkError.code === "ECONNRESET";
 }
+function transportFailure(error) {
+  const networkError = error instanceof Error ? error : null;
+  const code = networkError?.name === "AbortError" ? "TIMEOUT" : networkError?.code === "ECONNRESET" ? "CONNECTION_RESET" : "NETWORK_ERROR";
+  return {
+    ok: false,
+    status: 500,
+    data: { error: "Network Error", code },
+    transportError: true
+  };
+}
 async function fetchWithTimeout(url, options) {
   const controller = new AbortController;
   const timeout = setTimeout(() => controller.abort(), DEFAULT_TIMEOUT);
@@ -6382,6 +6632,57 @@ async function fetchWithRetry(url, options) {
   }
   throw new Error("Unreachable");
 }
+function declaredResponseTooLarge(response, maxBytes) {
+  const contentLength = response.headers.get("content-length");
+  if (contentLength === null || !/^\d+$/.test(contentLength))
+    return false;
+  return Number(contentLength) > maxBytes;
+}
+function joinedResponseBytes(chunks, totalBytes) {
+  const responseBytes = new Uint8Array(totalBytes);
+  let offset = 0;
+  for (const chunk of chunks) {
+    responseBytes.set(chunk, offset);
+    offset += chunk.byteLength;
+  }
+  return responseBytes;
+}
+async function responseBytesWithinLimit(response, maxBytes) {
+  if (declaredResponseTooLarge(response, maxBytes)) {
+    await response.body?.cancel();
+    return null;
+  }
+  if (!response.body)
+    return new Uint8Array;
+  const reader = response.body.getReader();
+  const chunks = [];
+  let totalBytes = 0;
+  while (true) {
+    const { done, value } = await reader.read();
+    if (done)
+      return joinedResponseBytes(chunks, totalBytes);
+    totalBytes += value.byteLength;
+    if (totalBytes > maxBytes) {
+      await reader.cancel();
+      return null;
+    }
+    chunks.push(value);
+  }
+}
+function parsedUtf8Json(responseBytes) {
+  try {
+    const responseText = new TextDecoder("utf-8", { fatal: true }).decode(responseBytes);
+    return JSON.parse(responseText);
+  } catch (error) {
+    if (error instanceof SyntaxError || error instanceof TypeError)
+      return null;
+    throw error;
+  }
+}
+async function boundedResponseJson(response, maxBytes) {
+  const responseBytes = await responseBytesWithinLimit(response, maxBytes);
+  return responseBytes === null ? null : parsedUtf8Json(responseBytes);
+}
 
 class HttpTransport {
   baseUrl;
@@ -6396,16 +6697,16 @@ class HttpTransport {
       "Content-Type": "application/json"
     };
   }
-  async get(path) {
+  async get(path, options = {}) {
     try {
       const res = await fetchWithRetry(`${this.baseUrl}${path}`, {
         method: "GET",
         headers: this.headers()
       });
-      const data = await res.json().catch(() => null);
+      const data = options.maxResponseBytes === undefined ? await res.json().catch(() => null) : await boundedResponseJson(res, options.maxResponseBytes);
       return { ok: res.ok, status: res.status, data };
     } catch (error) {
-      return { ok: false, status: 500, data: { error: "Network Error", details: error.message } };
+      return transportFailure(error);
     }
   }
   async post(path, body) {
@@ -6418,7 +6719,7 @@ class HttpTransport {
       const data = await res.json().catch(() => null);
       return { ok: res.ok, status: res.status, data };
     } catch (error) {
-      return { ok: false, status: 500, data: { error: "Network Error", details: error.message } };
+      return transportFailure(error);
     }
   }
   async postMultipart(path, formData) {
@@ -6432,7 +6733,7 @@ class HttpTransport {
       const data = await res.json().catch(() => null);
       return { ok: res.ok, status: res.status, data };
     } catch (error) {
-      return { ok: false, status: 500, data: { error: "Network Error", details: error.message } };
+      return transportFailure(error);
     }
   }
   async patch(path, body) {
@@ -6445,7 +6746,7 @@ class HttpTransport {
       const data = await res.json().catch(() => null);
       return { ok: res.ok, status: res.status, data };
     } catch (error) {
-      return { ok: false, status: 500, data: { error: "Network Error", details: error.message } };
+      return transportFailure(error);
     }
   }
   async put(path, body) {
@@ -6458,7 +6759,7 @@ class HttpTransport {
       const data = await res.json().catch(() => null);
       return { ok: res.ok, status: res.status, data };
     } catch (error) {
-      return { ok: false, status: 500, data: { error: "Network Error", details: error.message } };
+      return transportFailure(error);
     }
   }
   async delete(path) {
@@ -6470,7 +6771,7 @@ class HttpTransport {
       const data = await res.json().catch(() => null);
       return { ok: res.ok, status: res.status, data };
     } catch (error) {
-      return { ok: false, status: 500, data: { error: "Network Error", details: error.message } };
+      return transportFailure(error);
     }
   }
   async ping() {
@@ -6662,7 +6963,7 @@ Actions: ${allActions.join(", ")}${readOnly ? " (read-only mode)" : ""}`, {
     owner_column: optional(Type.String(), "[create_table_rls owner] UUID owner column matched to auth.uid()")
   }, async (args) => {
     const { action } = args;
-    const ref = projectRef || args.ref;
+    const ref = args.ref || projectRef;
     const schema = args.schema || "public";
     const schemas = args.schemas || ["public"];
     if (args.file && !args.sql) {
@@ -7216,6 +7517,62 @@ function pgToTs(t) {
 }
 
 // src/shared/tools/auth-tools.ts
+var authConfigRecord = Type.Record(Type.String(), Type.Unknown());
+var safeAuthMutationCodes = new Set([
+  "AUTH_RUNTIME_APPLY_FAILED",
+  "SUPAUTH_DEPENDENT_REFRESH_FAILED"
+]);
+function parseAuthConfig(input) {
+  if (typeof input !== "string")
+    return input;
+  try {
+    return JSON.parse(input);
+  } catch (error) {
+    if (!(error instanceof SyntaxError))
+      throw error;
+    throw new Error("Invalid auth config JSON object");
+  }
+}
+var authConfigSchema = decodedSchema(Type.Union([Type.String(), authConfigRecord]), authConfigRecord, parseAuthConfig);
+function safeAuthFailureFields(payload) {
+  if (!payload || typeof payload !== "object" || Array.isArray(payload))
+    return {};
+  const body = payload;
+  const fields = {};
+  if (typeof body.code === "string" && safeAuthMutationCodes.has(body.code)) {
+    fields.code = body.code;
+  }
+  for (const field of ["persisted", "runtime_applied", "dependents_applied"]) {
+    if (typeof body[field] === "boolean")
+      fields[field] = body[field];
+  }
+  if (body.dependent_status === "failed" || body.dependent_status === "unknown") {
+    fields.dependent_status = body.dependent_status;
+  }
+  if (body.runtime_mode === "local" || body.runtime_mode === "owner" || body.runtime_mode === "shared") {
+    fields.runtime_mode = body.runtime_mode;
+  }
+  return fields;
+}
+function safeAuthMutationFailure(response) {
+  return {
+    ok: false,
+    http_status: response.status,
+    ...safeAuthFailureFields(response.data)
+  };
+}
+function authMutationResult(response, successMessage) {
+  if (response.ok) {
+    return { content: [{ type: "text", text: successMessage }] };
+  }
+  return {
+    isError: true,
+    content: [{
+      type: "text",
+      text: JSON.stringify(safeAuthMutationFailure(response), null, 2)
+    }]
+  };
+}
 function formatProviders(data) {
   if (!data || typeof data !== "object")
     return JSON.stringify(data, null, 2);
@@ -7272,7 +7629,7 @@ Actions: list_providers, get_provider, configure_provider, update_provider, disa
     url: optional(Type.String(), "[configure] Custom OAuth URL"),
     app_id: optional(Type.String(), "[wechat_*] WeChat App ID"),
     app_secret: optional(Type.String(), "[wechat_*] WeChat App Secret"),
-    config: optional(Type.Record(Type.String(), Type.Unknown()), "[update_settings/update_config] Config fields")
+    config: optional(authConfigSchema, "[update_settings/update_config] Config fields as a JSON object")
   }, async (args) => {
     const { action, ref, provider, client_id, client_secret, redirect_uri, url, app_id, app_secret, config } = args;
     const need = (f) => {
@@ -7355,8 +7712,7 @@ ${JSON.stringify(r.data, null, 2)}` : `❌ Failed (${r.status}): ${JSON.stringif
         need("ref");
         if (!config)
           throw new Error("'config' required");
-        text = (await http.patch(`/v1/projects/${ref}/auth/config`, config)).ok ? `✅ Auth settings updated` : `❌ Failed`;
-        break;
+        return authMutationResult(await http.patch(`/v1/projects/${ref}/auth/config`, config), "✅ Auth settings updated");
       case "get_config":
         need("ref");
         text = ok(await http.get(`/v1/projects/${ref}/config/auth`));
@@ -7365,8 +7721,7 @@ ${JSON.stringify(r.data, null, 2)}` : `❌ Failed (${r.status}): ${JSON.stringif
         need("ref");
         if (!config)
           throw new Error("'config' required");
-        text = (await http.patch(`/v1/projects/${ref}/config/auth`, config)).ok ? `✅ Auth config updated` : `❌ Failed`;
-        break;
+        return authMutationResult(await http.patch(`/v1/projects/${ref}/config/auth`, config), "✅ Auth config updated");
       default:
         text = `❌ Unknown action: ${action}`;
     }
@@ -7469,6 +7824,39 @@ import { tmpdir } from "node:os";
 import { basename as basename2, join as join2, resolve as resolve2 } from "node:path";
 import { promisify } from "node:util";
 import { execFile } from "node:child_process";
+
+// src/shared/tools/release-control-response.ts
+var RELEASE_CONTROL_RESPONSE_SCHEMA = "supacloud.cli.release-control.v1";
+function releaseControlSuccess(operation, payload) {
+  return releaseControlResponse({
+    schema: RELEASE_CONTROL_RESPONSE_SCHEMA,
+    ok: true,
+    operation,
+    ...payload
+  });
+}
+function releaseControlFailure(operation, code, httpStatus) {
+  return releaseControlErrorResponse({
+    schema: RELEASE_CONTROL_RESPONSE_SCHEMA,
+    ok: false,
+    operation,
+    error: { code, http_status: httpStatus }
+  });
+}
+function releaseControlMutationFailure(operation, response) {
+  const outcomeUnknown = response.transportError || response.status === 408 || response.status >= 500;
+  return outcomeUnknown ? releaseControlFailure(operation, "OUTCOME_UNKNOWN", response.transportError ? null : response.status) : releaseControlFailure(operation, "HTTP_ERROR", response.status);
+}
+function releaseControlResponse(payload) {
+  return {
+    content: [{ type: "text", text: JSON.stringify(payload, null, 2) }]
+  };
+}
+function releaseControlErrorResponse(payload) {
+  return { ...releaseControlResponse(payload), isError: true };
+}
+
+// src/shared/tools/advanced-tools.ts
 var execFileAsync = promisify(execFile);
 async function runBunBuild(args) {
   try {
@@ -7540,7 +7928,29 @@ function parseFunctionFiles(input) {
   }
 }
 var functionFilesSchema = decodedSchema(Type.Union([Type.String(), functionFilesRecordSchema]), functionFilesRecordSchema, parseFunctionFiles);
+function parseFunctionVersion(input) {
+  const version = String(input);
+  if (!CANONICAL_FUNCTION_VERSION_PATTERN.test(version) || !Number.isSafeInteger(Number(version))) {
+    throw new Error("Function version must be a canonical safe integer");
+  }
+  return version;
+}
+var CANONICAL_FUNCTION_VERSION_PATTERN = /^(?:0|[1-9][0-9]*)$/;
+var SAFE_FUNCTION_REF_PATTERN = /^[A-Za-z0-9_-]{1,64}$/;
+var SAFE_FUNCTION_SLUG_PATTERN = /^[A-Za-z0-9_-]{1,128}$/;
+var FUNCTION_ACTIVATION_ARGUMENTS = new Set(["action", "ref", "slug", "version"]);
+var functionVersionSchema = Type.Optional(decodedSchema(Type.Union([
+  Type.Integer({ minimum: 0, maximum: Number.MAX_SAFE_INTEGER }),
+  Type.String({ pattern: CANONICAL_FUNCTION_VERSION_PATTERN.source, maxLength: 16 })
+]), Type.String({ pattern: CANONICAL_FUNCTION_VERSION_PATTERN.source, maxLength: 16 }), parseFunctionVersion));
 var secretListSchema = Type.Array(Type.Object({ name: Type.String(), value: Type.String() }));
+var ENVIRONMENT_SECRET_NAME_PATTERN = /^[A-Za-z_][A-Za-z0-9_]{0,255}$/;
+var MAX_SECRET_COUNT = 1024;
+var MAX_ENVIRONMENT_SECRET_BYTES = 24 * 1024;
+var MAX_SECRET_JSON_BYTES = 1024 * 1024;
+var INVALID_ENVIRONMENT_SECRET_NAMES_MESSAGE = "Environment secret names are invalid";
+var INVALID_ENVIRONMENT_SECRET_VALUES_MESSAGE = "Environment secret values are missing or exceed safe limits";
+var INVALID_SECRET_LIST_RESPONSE = "❌ Project secret list response is invalid";
 function parseSecrets(value) {
   if (Array.isArray(value))
     return value;
@@ -7567,6 +7977,89 @@ function parseSecrets(value) {
   }).filter((entry) => entry.name);
 }
 var secretsSchema = Type.Optional(decodedSchema(Type.Union([Type.String(), secretListSchema]), secretListSchema, parseSecrets));
+function validEnvironmentSecretNames(names) {
+  if (names.length === 0 || names.length > MAX_SECRET_COUNT)
+    return false;
+  const uniqueNames = new Set;
+  for (const name of names) {
+    if (!ENVIRONMENT_SECRET_NAME_PATTERN.test(name) || uniqueNames.has(name))
+      return false;
+    uniqueNames.add(name);
+  }
+  return true;
+}
+function parseEnvironmentSecretNames(input) {
+  const names = input.split(",", MAX_SECRET_COUNT + 1).map((name) => name.trim());
+  if (!validEnvironmentSecretNames(names)) {
+    throw new Error(INVALID_ENVIRONMENT_SECRET_NAMES_MESSAGE);
+  }
+  return names;
+}
+var environmentSecretNamesSchema = Type.Optional(decodedSchema(Type.String(), Type.Array(Type.String({ pattern: ENVIRONMENT_SECRET_NAME_PATTERN.source }), {
+  minItems: 1,
+  maxItems: MAX_SECRET_COUNT,
+  uniqueItems: true
+}), parseEnvironmentSecretNames));
+function jsonWithinSecretLimit(payload) {
+  try {
+    const serializedPayload = JSON.stringify(payload);
+    return serializedPayload !== undefined && Buffer.byteLength(serializedPayload) <= MAX_SECRET_JSON_BYTES;
+  } catch (error) {
+    if (error instanceof TypeError)
+      return false;
+    throw error;
+  }
+}
+function maskedSecretEntry(candidate) {
+  if (!candidate || typeof candidate !== "object" || Array.isArray(candidate))
+    return null;
+  const { name, value } = candidate;
+  if (typeof name !== "string" || !ENVIRONMENT_SECRET_NAME_PATTERN.test(name))
+    return null;
+  if (value !== "********")
+    return null;
+  return { name, value: "********" };
+}
+function projectedMaskedSecrets(payload) {
+  if (!Array.isArray(payload) || payload.length > MAX_SECRET_COUNT)
+    return null;
+  if (!jsonWithinSecretLimit(payload))
+    return null;
+  const secretNames = new Set;
+  const projectedSecrets = [];
+  for (const candidate of payload) {
+    const secret = maskedSecretEntry(candidate);
+    if (!secret || secretNames.has(secret.name))
+      return null;
+    secretNames.add(secret.name);
+    projectedSecrets.push(secret);
+  }
+  return projectedSecrets;
+}
+function secretsFromEnvironment(names, environment) {
+  const secrets = names.map((name) => {
+    const secretValue = environment[name];
+    if (typeof secretValue !== "string" || secretValue.length === 0 || Buffer.byteLength(secretValue) > MAX_ENVIRONMENT_SECRET_BYTES) {
+      throw new Error(INVALID_ENVIRONMENT_SECRET_VALUES_MESSAGE);
+    }
+    return { name, value: secretValue };
+  });
+  if (!jsonWithinSecretLimit(secrets)) {
+    throw new Error(INVALID_ENVIRONMENT_SECRET_VALUES_MESSAGE);
+  }
+  return secrets;
+}
+function secretsForUpsert(inlineSecrets, environmentNames, environment) {
+  if (inlineSecrets !== undefined && environmentNames !== undefined) {
+    throw new Error("'--from-env' cannot be combined with '--secrets'");
+  }
+  if (environmentNames !== undefined) {
+    return secretsFromEnvironment(environmentNames, environment);
+  }
+  if (!inlineSecrets?.length)
+    throw new Error("'secrets' array required");
+  return inlineSecrets;
+}
 function confirmedFunctionConfig(payload, expected) {
   if (!payload || typeof payload !== "object" || Array.isArray(payload))
     return false;
@@ -7587,12 +8080,60 @@ function functionSourceCode(payload) {
   const code = payload.code;
   return typeof code === "string" ? code : null;
 }
-function registerAdvancedTools(server, http) {
+function objectRecord(candidate) {
+  return candidate && typeof candidate === "object" && !Array.isArray(candidate) ? candidate : null;
+}
+function activationResponse(slug, version, response) {
+  const operation = "edge_functions.activate";
+  if (!response.ok)
+    return releaseControlMutationFailure(operation, response);
+  const receipt = objectRecord(response.data);
+  const config = objectRecord(receipt?.config);
+  if (receipt?.success !== true || receipt.version !== version || config?.version !== version || typeof config.verify_jwt !== "boolean") {
+    return releaseControlFailure(operation, "OUTCOME_UNKNOWN", response.status);
+  }
+  return releaseControlSuccess(operation, {
+    slug,
+    version,
+    verify_jwt: config.verify_jwt
+  });
+}
+function readOnlyActivationResult() {
+  return {
+    isError: true,
+    content: [{ type: "text", text: "⚠️ Edge Function activation blocked in read-only mode." }]
+  };
+}
+function functionActivationTarget(args) {
+  const projectRef = typeof args.ref === "string" ? args.ref.trim() : "";
+  const functionSlug = typeof args.slug === "string" ? args.slug.trim() : "";
+  const version = args.version;
+  if (!SAFE_FUNCTION_REF_PATTERN.test(projectRef))
+    throw new Error("'ref' is invalid for 'activate'");
+  if (!SAFE_FUNCTION_SLUG_PATTERN.test(functionSlug))
+    throw new Error("'slug' is invalid for 'activate'");
+  if (typeof version !== "string" || !CANONICAL_FUNCTION_VERSION_PATTERN.test(version) || !Number.isSafeInteger(Number(version))) {
+    throw new Error("'version' is invalid for 'activate'");
+  }
+  return { projectRef, functionSlug, version };
+}
+async function activateFunctionVersion(http, args, readOnly = false) {
+  if (readOnly)
+    return readOnlyActivationResult();
+  const unsupported = Object.keys(args).filter((name) => !FUNCTION_ACTIVATION_ARGUMENTS.has(name));
+  if (unsupported.length > 0)
+    throw new Error(`'${unsupported[0]}' is not supported for 'activate'`);
+  const { projectRef, functionSlug, version } = functionActivationTarget(args);
+  const endpoint = `/v1/projects/${encodeURIComponent(projectRef)}/functions/${encodeURIComponent(functionSlug)}` + `/versions/${encodeURIComponent(version)}/activate`;
+  return activationResponse(functionSlug, version, await http.post(endpoint));
+}
+function registerAdvancedTools(server, http, environment = process.env, options = {}) {
   server.tool("edge_functions", `Edge Function management (Deno/Bun serverless). Server auto-bundles dependencies.
-Actions: list, deploy, deploy_bundle, config, source, delete, check`, {
-    action: withDescription(stringEnum(["list", "deploy", "deploy_bundle", "config", "source", "delete", "check"]), "Action"),
+Actions: list, deploy, deploy_bundle, config, source, activate, delete, check`, {
+    action: withDescription(stringEnum(["list", "deploy", "deploy_bundle", "config", "source", "activate", "delete", "check"]), "Action"),
     ref: withDescription(Type.String(), "Project ref"),
-    slug: optional(Type.String(), "[deploy/deploy_bundle/config/source/delete/check] Function name"),
+    slug: optional(Type.String(), "[deploy/deploy_bundle/config/source/activate/delete/check] Function name"),
+    version: withDescription(functionVersionSchema, "[activate] Existing Function version"),
     code: optional(Type.String(), "[deploy/check] Function source code (TypeScript)"),
     path: optional(Type.String(), "[deploy/check] Local file path to read code from (alternative to code)"),
     output: optional(Type.String(), "[source] Write source to this local file instead of stdout; the file must not already exist"),
@@ -7602,6 +8143,8 @@ Actions: list, deploy, deploy_bundle, config, source, delete, check`, {
     verify_jwt: optional(Type.Boolean(), "[deploy/deploy_bundle/config] Set JWT verification for this function"),
     background_routes: withDescription(backgroundRoutesSchema, "[deploy/deploy_bundle/config] Background route paths; pass comma-separated or JSON array in CLI")
   }, async (args) => {
+    if (args.action === "activate")
+      return activateFunctionVersion(http, args, options.readOnly);
     const { action, ref, slug, path: pathArg, output, files, entrypoint, minify, verify_jwt, background_routes } = args;
     let code = args.code;
     const need = (f, v) => {
@@ -7737,18 +8280,28 @@ Actions: list, upsert, delete`, {
     action: withDescription(stringEnum(["list", "upsert", "delete"]), "Action"),
     ref: withDescription(Type.String(), "Project ref"),
     secrets: withDescription(secretsSchema, "[upsert] Secret list as JSON array or KEY=VALUE,KEY2=VALUE2"),
+    "from-env": withDescription(environmentSecretNamesSchema, "[upsert] Comma-separated environment variable names; values are read from this CLI process"),
     name: optional(Type.String(), "[delete] Secret name to delete")
   }, async (args) => {
     const { action, ref, secrets, name } = args;
+    const environmentNames = args["from-env"];
     let text;
     switch (action) {
-      case "list":
-        text = JSON.stringify((await http.get(`/v1/projects/${ref}/secrets`)).data, null, 2);
+      case "list": {
+        const response = await http.get(`/v1/projects/${ref}/secrets`, {
+          maxResponseBytes: MAX_SECRET_JSON_BYTES
+        });
+        if (!response.ok) {
+          text = `❌ Failed (${response.status})`;
+          break;
+        }
+        const maskedSecrets = projectedMaskedSecrets(response.data);
+        text = maskedSecrets === null ? INVALID_SECRET_LIST_RESPONSE : JSON.stringify(maskedSecrets, null, 2);
         break;
+      }
       case "upsert":
-        if (!secrets?.length)
-          throw new Error("'secrets' array required");
-        text = (await http.post(`/v1/projects/${ref}/secrets`, secrets)).ok ? `✅ Updated ${secrets.length} secrets` : `❌ Failed`;
+        const secretsToUpsert = secretsForUpsert(secrets, environmentNames, environment);
+        text = (await http.post(`/v1/projects/${ref}/secrets`, secretsToUpsert)).ok ? `✅ Updated ${secretsToUpsert.length} secrets` : `❌ Failed`;
         break;
       case "delete":
         if (!name)
@@ -8171,7 +8724,7 @@ function buildProjectLogsPath(ref, logType) {
   return `/v1/projects/${ref}/logs?${params.toString()}`;
 }
 function resolveRef(refFromArgs, defaultRef) {
-  const ref = defaultRef || refFromArgs;
+  const ref = refFromArgs || defaultRef;
   if (!ref)
     throw new Error("'ref' is required for this action");
   return ref;
@@ -8360,7 +8913,7 @@ function formatMessages(data, label = "Messages") {
   return out;
 }
 function resolveRef2(refFromArgs, defaultRef) {
-  const ref = defaultRef || refFromArgs;
+  const ref = refFromArgs || defaultRef;
   if (!ref)
     throw new Error("'ref' is required for this action");
   return ref;
@@ -8660,7 +9213,7 @@ Actions: routes, upsert_route, update_route, delete_route, config, get_certifica
     custom_hostname: optional(Type.String(), "[set_custom_hostname] 自定义域名")
   }, async (args) => {
     const resolveRef3 = (override) => {
-      const ref2 = projectRef || override;
+      const ref2 = override || projectRef;
       if (!ref2)
         throw new Error("'ref' is required for this action");
       return ref2;
@@ -9602,6 +10155,416 @@ function registerAiTools(server) {
   });
 }
 
+// src/shared/tools/scheduled-function-tools.ts
+import { randomUUID } from "node:crypto";
+import { readFileSync as readFileSync6, statSync as statSync4 } from "node:fs";
+import { resolve as resolve5 } from "node:path";
+import { isDeepStrictEqual } from "node:util";
+var HEADER_NAME_PATTERN = /^[!#$%&'*+.^_`|~0-9A-Za-z-]{1,128}$/;
+var ENVIRONMENT_NAME_PATTERN2 = /^[A-Za-z_][A-Za-z0-9_]{0,255}$/;
+var FORBIDDEN_HEADER_NAMES = new Set([
+  "apikey",
+  "authorization",
+  "connection",
+  "content-length",
+  "forwarded",
+  "host",
+  "keep-alive",
+  "proxy-authenticate",
+  "proxy-authorization",
+  "proxy-connection",
+  "te",
+  "trailer",
+  "transfer-encoding",
+  "upgrade",
+  "via",
+  "x-project-ref"
+]);
+var PROJECT_REF_PATTERN = /^[A-Za-z0-9_-]{1,64}$/;
+var SCHEDULE_ID_PATTERN = /^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/;
+var SAFE_SLUG_PATTERN = /^[A-Za-z0-9_-]{1,128}$/;
+var CRON_PART_PATTERN = /^(\*|([0-9]+)(?:-([0-9]+))?)(?:\/([0-9]+))?$/;
+var CRON_FIELD_BOUNDS = [[0, 59], [0, 23], [1, 31], [1, 12], [0, 7]];
+var MAX_CRON_EXPRESSION_LENGTH = 256;
+var MAX_BODY_FILE_BYTES = 1048576;
+var MAX_HEADER_COUNT = 64;
+var MAX_HEADER_VALUE_LENGTH = 8192;
+var MAX_SCHEDULE_NAME_LENGTH = 120;
+var headerEnvironmentRecord = Type.Record(Type.String(), Type.String());
+var ACTION_ARGUMENTS = {
+  list: new Set(["action", "ref"]),
+  create: new Set(["action", "ref", "name", "slug", "cron", "method", "body_file", "header_env"]),
+  update: new Set(["action", "ref", "schedule_id", "name", "cron", "method", "enabled", "body_file", "header_env"]),
+  delete: new Set(["action", "ref", "schedule_id"])
+};
+function parseHeaderEnvironment(input) {
+  if (typeof input !== "string")
+    return input;
+  try {
+    return JSON.parse(input);
+  } catch (error) {
+    if (!(error instanceof SyntaxError))
+      throw error;
+    throw new Error("Invalid header_env JSON object");
+  }
+}
+var headerEnvironmentSchema = Type.Optional(decodedSchema(Type.Union([Type.String(), headerEnvironmentRecord]), headerEnvironmentRecord, parseHeaderEnvironment));
+function objectRecord2(candidate) {
+  return candidate && typeof candidate === "object" && !Array.isArray(candidate) ? candidate : null;
+}
+function boundedCronInteger(input, minimum, maximum) {
+  const parsed = Number(input);
+  return Number.isSafeInteger(parsed) && parsed >= minimum && parsed <= maximum;
+}
+function validCronPart(part, minimum, maximum) {
+  const match = CRON_PART_PATTERN.exec(part);
+  if (!match)
+    return false;
+  const start = match[1] === "*" ? minimum : Number(match[2]);
+  const end = match[1] === "*" ? maximum : Number(match[3] ?? match[2]);
+  const step = Number(match[4] ?? "1");
+  return boundedCronInteger(String(start), minimum, maximum) && boundedCronInteger(String(end), minimum, maximum) && start <= end && boundedCronInteger(String(step), 1, maximum - minimum + 1);
+}
+function validCronField(field, minimum, maximum) {
+  const parts = field.split(",");
+  return parts.length <= maximum - minimum + 1 && parts.every((part) => part.length > 0 && validCronPart(part, minimum, maximum));
+}
+function validScheduledFunctionCron(expression) {
+  if (!expression || expression.length > MAX_CRON_EXPRESSION_LENGTH)
+    return false;
+  const fields = expression.trim().split(/\s+/);
+  return fields.length === CRON_FIELD_BOUNDS.length && fields.every((field, index) => {
+    const [minimum, maximum] = CRON_FIELD_BOUNDS[index];
+    return validCronField(field, minimum, maximum);
+  });
+}
+function readScheduleBodyFile(bodyPathInput) {
+  if (!bodyPathInput.trim())
+    throw new Error("'body_file' must be a path");
+  const bodyPath = resolve5(bodyPathInput);
+  const bodyStat = statSync4(bodyPath);
+  if (!bodyStat.isFile() || bodyStat.size > MAX_BODY_FILE_BYTES) {
+    throw new Error("Scheduled Function body file must be a regular file no larger than 1 MiB");
+  }
+  let payload;
+  try {
+    payload = JSON.parse(readFileSync6(bodyPath, "utf8"));
+  } catch (error) {
+    if (!(error instanceof SyntaxError))
+      throw error;
+    throw new Error("Scheduled Function body file must contain exact JSON");
+  }
+  const body = objectRecord2(payload);
+  if (!body)
+    throw new Error("Scheduled Function body file must contain a JSON object");
+  return body;
+}
+function scheduleBody(bodyFile) {
+  if (bodyFile === undefined)
+    return;
+  if (typeof bodyFile !== "string")
+    throw new Error("'body_file' must be a path");
+  return readScheduleBodyFile(bodyFile);
+}
+function resolvedHeaderEntry(headerName, environmentName, environment) {
+  const normalizedName = headerName.toLowerCase();
+  if (!HEADER_NAME_PATTERN.test(headerName) || forbiddenHeaderName(normalizedName) || typeof environmentName !== "string" || !ENVIRONMENT_NAME_PATTERN2.test(environmentName)) {
+    throw new Error("SCHEDULE_HEADER_MAPPING_INVALID");
+  }
+  const headerValue = environment[environmentName];
+  if (!headerValue)
+    throw new Error("SCHEDULE_HEADER_ENV_MISSING");
+  if (!headerValueIsStable(normalizedName, headerValue))
+    throw new Error("SCHEDULE_HEADER_INVALID");
+  return [normalizedName, headerValue];
+}
+function forbiddenHeaderName(name) {
+  return FORBIDDEN_HEADER_NAMES.has(name) || name.startsWith("x-forwarded-");
+}
+function headerValueIsStable(name, value) {
+  if (!value || value.length > MAX_HEADER_VALUE_LENGTH)
+    return false;
+  try {
+    const headers = new Headers;
+    headers.set(name, value);
+    return headers.get(name) === value;
+  } catch {
+    return false;
+  }
+}
+function scheduleHeaders(mapping, environment) {
+  if (mapping === undefined)
+    return;
+  const headerEnvironment = objectRecord2(mapping);
+  if (!headerEnvironment)
+    throw new Error("'header_env' must be a JSON object");
+  const entries = Object.entries(headerEnvironment).map(([headerName, environmentName]) => resolvedHeaderEntry(headerName, environmentName, environment));
+  const names = entries.map(([name]) => name);
+  if (entries.length > MAX_HEADER_COUNT || new Set(names).size !== names.length) {
+    throw new Error("SCHEDULE_HEADER_INVALID");
+  }
+  return Object.fromEntries(entries);
+}
+function validSafeSchedule(schedule) {
+  return validScheduleIdentity(schedule) && validScheduleDefinition(schedule) && validScheduleMetadata(schedule);
+}
+function validScheduleIdentity(schedule) {
+  return typeof schedule.id === "string" && SCHEDULE_ID_PATTERN.test(schedule.id) && typeof schedule.name === "string" && schedule.name.trim().length > 0 && schedule.name.length <= MAX_SCHEDULE_NAME_LENGTH && typeof schedule.slug === "string" && SAFE_SLUG_PATTERN.test(schedule.slug);
+}
+function validScheduleDefinition(schedule) {
+  return typeof schedule.cron === "string" && validScheduledFunctionCron(schedule.cron) && (schedule.method === "GET" || schedule.method === "POST") && typeof schedule.enabled === "boolean";
+}
+function validScheduleMetadata(schedule) {
+  return typeof schedule.created_at === "string" && typeof schedule.updated_at === "string";
+}
+function safeSchedulePayload(schedule) {
+  const headerNames = safeHeaderNames(schedule.header_names);
+  if (typeof schedule.body_empty !== "boolean" || !headerNames)
+    return null;
+  return { body_empty: schedule.body_empty, header_names: headerNames };
+}
+function safeHeaderNames(candidate) {
+  if (!Array.isArray(candidate) || candidate.length > MAX_HEADER_COUNT)
+    return null;
+  const names = candidate.map((name) => typeof name === "string" ? name.toLowerCase() : "");
+  const valid = candidate.every((name, index) => typeof name === "string" && HEADER_NAME_PATTERN.test(name) && !forbiddenHeaderName(names[index]));
+  return valid && new Set(names).size === names.length ? names.sort() : null;
+}
+function safeSchedule(candidate) {
+  const schedule = objectRecord2(candidate);
+  if (!schedule || !validSafeSchedule(schedule))
+    return null;
+  const safePayload = safeSchedulePayload(schedule);
+  if (!safePayload)
+    return null;
+  return {
+    id: schedule.id,
+    name: schedule.name,
+    slug: schedule.slug,
+    cron: schedule.cron,
+    method: schedule.method,
+    enabled: schedule.enabled,
+    ...safePayload,
+    created_at: schedule.created_at,
+    updated_at: schedule.updated_at
+  };
+}
+function requiredText(args, name, action) {
+  const candidate = args[name];
+  if (typeof candidate !== "string" || !candidate.trim()) {
+    throw new Error(`'${name}' is required for '${action}'`);
+  }
+  return candidate.trim();
+}
+function assertActionArguments(action, args) {
+  const unsupported = Object.keys(args).filter((name) => !ACTION_ARGUMENTS[action].has(name));
+  if (unsupported.length > 0) {
+    throw new Error(`'${unsupported[0]}' is not supported for '${action}'`);
+  }
+}
+function schedulePath(ref, scheduleId) {
+  if (!PROJECT_REF_PATTERN.test(ref))
+    throw new Error("'ref' is invalid for Scheduled Functions");
+  if (scheduleId !== undefined && !SCHEDULE_ID_PATTERN.test(scheduleId)) {
+    throw new Error("'schedule_id' is invalid");
+  }
+  const root = `/v1/projects/${encodeURIComponent(ref)}/scheduled-functions`;
+  return scheduleId ? `${root}/${encodeURIComponent(scheduleId)}` : root;
+}
+function scheduleFailure(operation, response) {
+  return releaseControlFailure(operation, "HTTP_ERROR", response.transportError ? null : response.status);
+}
+function listResponse(ref, response) {
+  const operation = "scheduled_functions.list";
+  if (!response.ok)
+    return scheduleFailure(operation, response);
+  const payload = objectRecord2(response.data);
+  const rawSchedules = payload?.schedules;
+  const schedules = Array.isArray(rawSchedules) ? rawSchedules.map(safeSchedule) : null;
+  if (payload?.project_ref !== ref || !schedules || schedules.some((schedule) => !schedule)) {
+    return releaseControlFailure(operation, "INVALID_RESPONSE", null);
+  }
+  const ids = schedules.map((schedule) => schedule.id);
+  if (new Set(ids).size !== ids.length)
+    return releaseControlFailure(operation, "INVALID_RESPONSE", null);
+  return releaseControlSuccess(operation, { project_ref: ref, schedules });
+}
+function mutationResponse(expectation, response) {
+  const { action, ref, requestId, expectedFields } = expectation;
+  const scheduleId = action === "update" ? expectation.scheduleId : undefined;
+  const operation = `scheduled_functions.${action}`;
+  if (!response.ok)
+    return releaseControlMutationFailure(operation, response);
+  const payload = objectRecord2(response.data);
+  const schedule = safeSchedule(payload?.schedule);
+  const confirmsRequest = schedule && Object.entries(expectedFields).every(([field, expected]) => isDeepStrictEqual(schedule[field], expected));
+  if (payload?.project_ref !== ref || payload.request_id !== requestId || payload?.[action === "create" ? "created" : "updated"] !== true || !schedule || !confirmsRequest || scheduleId !== undefined && schedule.id !== scheduleId) {
+    return releaseControlFailure(operation, "OUTCOME_UNKNOWN", response.status);
+  }
+  return releaseControlSuccess(operation, { project_ref: ref, request_id: requestId, schedule });
+}
+function deleteResponse(ref, scheduleId, response) {
+  const operation = "scheduled_functions.delete";
+  if (!response.ok)
+    return releaseControlMutationFailure(operation, response);
+  const payload = objectRecord2(response.data);
+  if (payload?.deleted !== true || payload.project_ref !== ref || payload.schedule_id !== scheduleId) {
+    return releaseControlFailure(operation, "OUTCOME_UNKNOWN", response.status);
+  }
+  return releaseControlSuccess(operation, {
+    project_ref: ref,
+    schedule_id: scheduleId,
+    deleted: true
+  });
+}
+function readOnlyResult2() {
+  return {
+    isError: true,
+    content: [{ type: "text", text: "⚠️ Scheduled Function write blocked in read-only mode." }]
+  };
+}
+function createRequest(args, environment) {
+  return {
+    request_id: randomUUID(),
+    name: requiredName(args, "create"),
+    slug: requiredSlug(args, "create"),
+    cron: requiredCron(args, "create"),
+    method: requiredText(args, "method", "create"),
+    body: scheduleBody(args.body_file) ?? {},
+    headers: scheduleHeaders(args.header_env, environment) ?? {}
+  };
+}
+function safeMutationFields(request) {
+  const safeFields = Object.fromEntries(["name", "slug", "cron", "method", "enabled"].filter((field) => request[field] !== undefined).map((field) => [field, request[field]]));
+  if (request.body !== undefined) {
+    safeFields.body_empty = Object.keys(request.body).length === 0;
+  }
+  if (request.headers !== undefined) {
+    safeFields.header_names = Object.keys(request.headers).sort();
+  }
+  return safeFields;
+}
+function requiredName(args, action) {
+  const name = requiredText(args, "name", action);
+  if (name.length > MAX_SCHEDULE_NAME_LENGTH)
+    throw new Error(`'name' is too long for '${action}'`);
+  return name;
+}
+function requiredSlug(args, action) {
+  const slug = requiredText(args, "slug", action);
+  if (!SAFE_SLUG_PATTERN.test(slug))
+    throw new Error(`'slug' is invalid for '${action}'`);
+  return slug;
+}
+function requiredCron(args, action) {
+  const cron = requiredText(args, "cron", action);
+  if (!validScheduledFunctionCron(cron))
+    throw new Error(`'cron' is invalid for '${action}'`);
+  return cron;
+}
+function updateRequest(args, environment) {
+  const body = scheduleBody(args.body_file);
+  const headers = scheduleHeaders(args.header_env, environment);
+  const cron = args.cron === undefined ? undefined : requiredCron(args, "update");
+  const name = args.name === undefined ? undefined : requiredName(args, "update");
+  const mutationFields = Object.fromEntries([
+    ["name", name],
+    ["cron", cron],
+    ["method", args.method],
+    ["enabled", args.enabled],
+    ["body", body],
+    ["headers", headers]
+  ].filter((entry) => entry[1] !== undefined));
+  if (Object.keys(mutationFields).length === 0) {
+    throw new Error("Scheduled Function update requires at least one field");
+  }
+  return { request_id: randomUUID(), ...mutationFields };
+}
+async function executeScheduleAction(http, environment, args, readOnly = false) {
+  const action = args.action;
+  if (readOnly && action !== "list")
+    return readOnlyResult2();
+  assertActionArguments(action, args);
+  const ref = requiredText(args, "ref", action);
+  if (action === "list")
+    return listResponse(ref, await http.get(schedulePath(ref)));
+  if (action === "create") {
+    const request = createRequest(args, environment);
+    const requestId = request.request_id;
+    return mutationResponse({ action, ref, requestId, expectedFields: safeMutationFields(request) }, await http.post(schedulePath(ref), request));
+  }
+  const scheduleId = requiredText(args, "schedule_id", action);
+  if (action === "update") {
+    const request = updateRequest(args, environment);
+    const requestId = request.request_id;
+    return mutationResponse({
+      action,
+      ref,
+      scheduleId,
+      requestId,
+      expectedFields: safeMutationFields(request)
+    }, await http.patch(schedulePath(ref, scheduleId), request));
+  }
+  return deleteResponse(ref, scheduleId, await http.delete(schedulePath(ref, scheduleId)));
+}
+function registerScheduledFunctionTools(server, http, environment = process.env, options = {}) {
+  server.tool("scheduled_functions", SCHEDULE_TOOL_DESCRIPTION, SCHEDULE_TOOL_SCHEMA, (args) => executeScheduleAction(http, environment, args, options.readOnly));
+}
+var SCHEDULE_TOOL_DESCRIPTION = "Scheduled Edge Function lifecycle. Actions: list, create, update, delete";
+var SCHEDULE_TOOL_SCHEMA = {
+  action: withDescription(stringEnum(["list", "create", "update", "delete"]), "Action"),
+  ref: withDescription(Type.String(), "Project ref"),
+  schedule_id: optional(Type.String(), "[update/delete] Schedule ID"),
+  name: optional(Type.String(), "[create/update] Display name"),
+  slug: optional(Type.String(), "[create] Edge Function slug"),
+  cron: optional(Type.String(), "[create/update] Five-field cron expression"),
+  method: optional(stringEnum(["GET", "POST"]), "[create/update] HTTP method"),
+  enabled: optional(Type.Boolean(), "[update] Enabled state"),
+  body_file: optional(Type.String(), "[create/update] Local JSON object file; content is never printed"),
+  header_env: withDescription(headerEnvironmentSchema, "[create/update] JSON map of HTTP header names to environment variable names")
+};
+// package.json
+var package_default = {
+  name: "@supacloud/cli",
+  version: "0.15.0",
+  description: "Project-scoped CLI for SupaCloud users",
+  type: "module",
+  main: "./dist/index.js",
+  bin: {
+    "supacloud-cli": "dist/index.js"
+  },
+  files: [
+    "dist",
+    "README.md",
+    "skills"
+  ],
+  scripts: {
+    dev: "bun run --watch src/index.ts",
+    build: "bun build src/index.ts --outdir dist --target node",
+    prepublishOnly: "bun run build",
+    typecheck: "tsc --noEmit"
+  },
+  keywords: [
+    "supacloud",
+    "cli",
+    "deploy",
+    "supabase"
+  ],
+  license: "MIT",
+  repository: {
+    type: "git",
+    url: "https://github.com/zuohuadong/supacloud.git",
+    directory: "packages/cli"
+  },
+  dependencies: {
+    "@sinclair/typebox": "^0.34.52"
+  },
+  devDependencies: {
+    "@types/bun": "^1.3.14",
+    typescript: "^7.0.2"
+  }
+};
+
 // src/index.ts
 var commandName = "supacloud-cli";
 var preferredCommand = commandName;
@@ -9679,9 +10642,12 @@ async function createProjectStatusResult(context) {
   const checks = await collectProjectStatusChecks(context);
   const statusPayload = {
     mode: "project",
-    source: context.source,
+    environment: context.environment || null,
+    source: { kind: context.source, path: context.sourcePath },
     projectRef: context.projectRef || null,
     apiUrl: context.apiUrl || null,
+    readOnly: context.readOnly,
+    production: context.production,
     autoLinked: Boolean(context.inferredSupabaseUrl && context.inferredServiceRoleKey),
     hasApiToken: Boolean(context.apiToken),
     checks
@@ -9714,7 +10680,7 @@ function captureTools(register) {
   register(server);
   return tools;
 }
-function printHelp(context = resolveSupaCloudContext()) {
+function printHelp(context) {
   const autoLink = context.inferredSupabaseUrl ? `Project context: ${context.inferredSupabaseUrl} (${context.source})` : "Project context: not detected";
   console.error(`
 ╔═══════════════════════════════════════════════════════════╗
@@ -9724,18 +10690,31 @@ function printHelp(context = resolveSupaCloudContext()) {
 
 USAGE
 
-  ${preferredCommand} <module> <action> [--flags]
-  ${preferredCommand} status
+  ${preferredCommand} [global flags] <module> <action> [--flags]
+  ${preferredCommand} [global flags] status
   ${preferredCommand} --help
+  ${preferredCommand} --version
+
+GLOBAL FLAGS
+
+  --env <name>                    Load .env.supacloud.<name> from the current directory.
+  --env-file <path>               Load an exact file that declares SUPACLOUD_ENV.
+  --confirm-production <ref>      Confirm a write to the selected production project.
+
+  Global flags may appear before or after the command. --env and --env-file are
+  mutually exclusive, and a selected source is never mixed with another source.
 
 DEFAULT CONTEXT
 
-  Unauthenticated runs default to the current project's .env.
+  Without a selector or project variables, runs use the current project's legacy .env.
   Supported auto-link variables:
     SUPABASE_URL / SUPACLOUD_API_URL
     SUPABASE_SERVICE_ROLE_KEY / SUPACLOUD_API_TOKEN
     SUPACLOUD_PROJECT_REF (when it cannot be inferred from <ref>.api.*)
 
+  SUPACLOUD_READ_ONLY=true blocks remote writes. Production writes require an
+  exact --confirm-production value, and cannot override the selected project ref.
+
   status checks configuration, Management API connectivity, and authentication.
   It exits non-zero when a required check fails.
 
@@ -9763,7 +10742,10 @@ EXAMPLES
   ${preferredCommand} ai show_skill
   ${preferredCommand} ai install_skill --dry_run
   ${preferredCommand} edge_functions deploy --ref abc123 --slug hello --path ./supabase/functions/hello
+  ${preferredCommand} edge_functions activate --ref abc123 --slug hello --version 3
+  ${preferredCommand} scheduled_functions list --ref abc123
   ${preferredCommand} edge_functions config --ref abc123 --slug hello --verify_jwt false --background_routes "/queue/*,/render/*"
+  ${preferredCommand} secrets upsert --ref abc123 --from-env API_KEY,WEBHOOK_SECRET
   ${preferredCommand} gateway routes --ref abc123
   ${preferredCommand} gateway upsert_route --ref abc123 --route_id webhook --hosts "api.example.com" --paths "/webhook/*" --upstream 10.0.0.5:8080
   ${preferredCommand} gateway config --ref abc123 --rate_limit_tier pro
@@ -9777,8 +10759,18 @@ SEPARATE ADMIN CLI
     npx @supacloud/admin --help
 `);
 }
-function createCliTools() {
-  const context = resolveSupaCloudContext();
+function authorizedToolMap(tools, context, confirmProduction) {
+  validateExecutionPolicyCoverage(tools);
+  for (const [moduleName, tool] of Object.entries(tools)) {
+    const callback = tool.callback;
+    tool.callback = async (args) => {
+      authorizeExecution(moduleName, args, { context, confirmProduction });
+      return callback(args);
+    };
+  }
+  return tools;
+}
+function createCliTools(context, confirmProduction) {
   let pushMigrations;
   const tools = {
     status: {
@@ -9804,6 +10796,8 @@ function createCliTools() {
               "⚠️ Project commands need a project-scoped API context.",
               "",
               "Provide one of these sources:",
+              "  - --env <name> for .env.supacloud.<name>",
+              "  - --env-file <path> for a file declaring SUPACLOUD_ENV",
               "  - .env with SUPABASE_URL + SUPABASE_SERVICE_ROLE_KEY",
               "  - SUPACLOUD_API_URL + SUPACLOUD_API_TOKEN",
               "",
@@ -9816,7 +10810,7 @@ function createCliTools() {
         ]
       })
     };
-    for (const name of ["database", "auth", "storage", "edge_functions", "secrets", "frontend", "queue", "task_events", "diagnostics", "gateway", "branch"]) {
+    for (const name of ["database", "auth", "storage", "edge_functions", "secrets", "frontend", "queue", "task_events", "scheduled_functions", "diagnostics", "gateway", "branch"]) {
       tools[name] = {
         schema: { action: genericActionSchema },
         callback: async () => ({
@@ -9853,11 +10847,14 @@ function createCliTools() {
               `${preferredCommand} expects project-scoped credentials by default.`,
               "Provide one of these sources:",
               "",
-              "  1. Current workspace .env",
+              "  1. Named environment file",
+              "     supacloud-cli --env test status",
+              "",
+              "  2. Current workspace .env",
               "     SUPABASE_URL=https://your-project.example.com",
               "     SUPABASE_SERVICE_ROLE_KEY=...",
               "",
-              "  2. Explicit environment variables",
+              "  3. Explicit environment variables",
               "     SUPACLOUD_API_URL=https://your-project.example.com",
               "     SUPACLOUD_API_TOKEN=...",
               "",
@@ -9869,7 +10866,7 @@ function createCliTools() {
         ]
       })
     };
-    return tools;
+    return authorizedToolMap(tools, context, confirmProduction);
   }
   const http = new HttpTransport({
     baseUrl: context.apiUrl,
@@ -9887,7 +10884,12 @@ function createCliTools() {
   assign(databaseTools);
   assign(captureTools((server) => registerAuthTools(server, http)));
   assign(captureTools((server) => registerStorageTools(server, http)));
-  assign(captureTools((server) => registerAdvancedTools(server, http)));
+  assign(captureTools((server) => registerAdvancedTools(server, http, process.env, {
+    readOnly: context.readOnly
+  })));
+  assign(captureTools((server) => registerScheduledFunctionTools(server, http, process.env, {
+    readOnly: context.readOnly
+  })));
   assign(captureTools((server) => registerFrontendTools(server, http)));
   assign(captureTools((server) => registerGatewayTools(server, http, {
     projectRef: context.projectRef || undefined
@@ -9900,16 +10902,26 @@ function createCliTools() {
     projectRef: context.projectRef || undefined
   })));
   delete tools.platform;
-  return tools;
+  return authorizedToolMap(tools, context, confirmProduction);
 }
 async function main() {
-  const args = process.argv.slice(2);
+  const rawArgs = process.argv.slice(2);
+  if (rawArgs.length === 1 && rawArgs[0] === "--version") {
+    console.log(package_default.version);
+    return;
+  }
+  const globalOptions = parseGlobalOptions(rawArgs);
+  const args = globalOptions.args;
+  const context = resolveSupaCloudContext(process.env, process.cwd(), {
+    environmentName: globalOptions.environmentName,
+    envFile: globalOptions.envFile
+  });
   if (args.length === 0 || args[0] === "--help" || args[0] === "-h") {
-    printHelp();
+    printHelp(context);
     process.exitCode = 0;
     return;
   }
-  const cliTools = createCliTools();
+  const cliTools = createCliTools(context, globalOptions.confirmProduction);
   if (args.length === 1 && !["ai", "supabase"].includes(args[0]) && cliTools[args[0]]) {
     const result = await cliTools[args[0]].callback({});
     if (result?.content && Array.isArray(result.content)) {