@igoruehara/canvas-flow 0.1.12 → 0.1.14

package/README.md

@@ -219,6 +219,21 @@ npx @igoruehara/canvas-flow@latest --home C:\canvas-flow-data --open
 
 Tambem e possivel configurar provedores pela propria aplicacao depois que ela estiver rodando. Nesse caso, a configuracao fica salva no MongoDB.
 
+## WhatsApp Oficial E Open Source
+
+O onboarding da Meta tem dois modos principais:
+
+- **Sinergy gerenciado / Coexistence**: usa o preset da Sinergy. Funciona quando
+  o onboarding roda por uma URL fixa da Sinergy ou por dominios autorizados no
+  app Meta da Sinergy.
+- **Self-hosted / app Meta proprio**: use quando cada usuario hospeda o Canvas
+  Flow no proprio dominio. O usuario precisa informar o proprio App ID,
+  Configuration ID e App Secret, alem de cadastrar o dominio HTTPS/redirect URI
+  no app Meta dele.
+
+Use o modo manual quando o cliente ja tiver WABA ID, Phone Number ID e access
+token existentes.
+
 `providers.milvus`: opcional para RAG com Milvus/Zilliz. Milvus local via Docker pode rodar sem token. Milvus remoto normalmente precisa de `token` ou `username/password`.
 
 ```json

package/bin/canvas-flow.js

@@ -19,6 +19,62 @@ const INFRA_COMPOSE_FILE = path.join(PACKAGE_ROOT, 'templates', 'docker-compose.
 const INFRA_PROJECT_NAME = 'canvas-flow';
 const INFRA_BASE_SERVICES = ['mongo'];
 const INFRA_FULL_SERVICES = ['mongo', 'etcd', 'minio', 'milvus'];
+const SINERGY_WHATSAPP_COEXISTENCE_PRESET = {
+  embeddedSignupAppId: '617497366521622',
+  embeddedSignupConfigId: '1952866105586018',
+  embeddedSignupSessionInfoVersion: '3',
+  embeddedSignupVersion: 'v3',
+};
+
+const STARTUP_BANNER = [
+  '   ______                            ________               ',
+  '  / ____/___ _____ _   ______ ______/ ____/ /___ _      __ ',
+  " / /   / __ '/ __ \\ | / / __ '/ ___/ /_  / / __ \\ | /| / / ",
+  '/ /___/ /_/ / / / / |/ / /_/ (__  ) __/ / / /_/ / |/ |/ /  ',
+  '\\____/\\__,_/_/ /_/|___/\\__,_/____/_/   /_/\\____/|__/|__/   ',
+].join('\n');
+
+function envFlagEnabled(name) {
+  return ['1', 'true', 'yes', 'sim', 'on'].includes(String(process.env[name] || '').trim().toLowerCase());
+}
+
+function shouldUseAnsiColor() {
+  if (process.env.NO_COLOR) return false;
+  return Boolean(process.stdout.isTTY || process.env.FORCE_COLOR);
+}
+
+function colorAnsi(text, code) {
+  return shouldUseAnsiColor() ? `\x1b[${code}m${text}\x1b[0m` : text;
+}
+
+function shouldPrintStartupBanner(flags = {}) {
+  if (flags.banner === false || envFlagEnabled('CANVAS_FLOW_NO_BANNER')) return false;
+  if (process.env.CI && !envFlagEnabled('CANVAS_FLOW_BANNER')) return false;
+  return Boolean(process.stdout.isTTY || envFlagEnabled('CANVAS_FLOW_BANNER'));
+}
+
+function boxLine(text, width = 74) {
+  const safeText = String(text || '').slice(0, width - 4);
+  return `| ${safeText.padEnd(width - 4, ' ')} |`;
+}
+
+function printStartupBanner(flags = {}) {
+  if (!shouldPrintStartupBanner(flags)) return;
+
+  const border = '+'.padEnd(75, '-') + '+';
+  const box = [
+    border,
+    boxLine('Canvas Flow standalone runtime'),
+    boxLine('Tip: use --with-docker for local Mongo, or --full for Mongo + Milvus.'),
+    boxLine('Docs: https://igoruehara.github.io/canvas-flow/'),
+    border,
+  ].join('\n');
+
+  console.log('');
+  console.log(colorAnsi(STARTUP_BANNER.trimEnd(), '95'));
+  console.log(colorAnsi(box, '36'));
+  console.log('');
+}
 
 function printHelp() {
   console.log(`
@@ -44,6 +100,7 @@ Options:
   --public-url <url>          Override server.publicUrl
   --open                      Open the browser after starting
   --no-open                   Do not open the browser
+  --no-banner                 Do not print the startup banner
   --with-docker               Start local Docker infrastructure before Canvas Flow
   --full                      Include Milvus, MinIO and etcd with Docker infrastructure
   --show                      Show config content with "init" or "config"
@@ -267,6 +324,7 @@ function baseConfig() {
       whatsapp: {
         provider: 'meta',
         deliveryMode: 'provider',
+        onboardingMode: 'manual',
         autoReply: true,
         verifyToken: '',
         accessToken: '',
@@ -274,6 +332,16 @@ function baseConfig() {
         wabaId: '',
         phoneNumberId: '',
         graphApiVersion: 'v20.0',
+        coexistenceEnabled: false,
+        syncMessageEchoes: true,
+        syncHistory: false,
+        embeddedSignupAppId: SINERGY_WHATSAPP_COEXISTENCE_PRESET.embeddedSignupAppId,
+        embeddedSignupConfigId: SINERGY_WHATSAPP_COEXISTENCE_PRESET.embeddedSignupConfigId,
+        embeddedSignupAppSecret: '',
+        embeddedSignupSolutionId: '',
+        embeddedSignupFeatureType: '',
+        embeddedSignupSessionInfoVersion: SINERGY_WHATSAPP_COEXISTENCE_PRESET.embeddedSignupSessionInfoVersion,
+        embeddedSignupVersion: SINERGY_WHATSAPP_COEXISTENCE_PRESET.embeddedSignupVersion,
         blipContractId: '',
         blipAuthorizationKey: '',
         sinchProjectId: '',
@@ -350,6 +418,19 @@ function mergeConfig(defaults, overrides) {
   return output;
 }
 
+function applyWhatsappCoexistenceDefaults(config) {
+  const whatsapp = config?.providers?.whatsapp;
+  if (!isPlainObject(whatsapp)) return false;
+
+  let changed = false;
+  for (const [key, value] of Object.entries(SINERGY_WHATSAPP_COEXISTENCE_PRESET)) {
+    if (String(whatsapp[key] || '').trim()) continue;
+    whatsapp[key] = value;
+    changed = true;
+  }
+  return changed;
+}
+
 function writeJson(filePath, value) {
   fs.writeFileSync(filePath, `${JSON.stringify(value, null, 2)}\n`, 'utf8');
 }
@@ -388,6 +469,9 @@ function loadConfig(configPath) {
 
   const config = mergeConfig(baseConfig(), parsed);
   let changed = false;
+  if (applyWhatsappCoexistenceDefaults(config)) {
+    changed = true;
+  }
   if (!config.auth.apiToken) {
     config.auth.apiToken = randomSecret('cf_master_');
     changed = true;
@@ -478,6 +562,17 @@ function isLoopbackUrl(value) {
   }
 }
 
+function normalizeProviderName(value) {
+  const text = String(value || '').trim().toLowerCase();
+  if (text === 'azure' || text === 'azure_openai' || text === 'azure-openai' || text === 'azureopenai') {
+    return 'azure';
+  }
+  if (['openai', 'gemini', 'claude', 'grok', 'bedrock'].includes(text)) {
+    return text;
+  }
+  return 'openai';
+}
+
 function applyEnvironment(config, paths, flags) {
   const port = Number(flags.port || config.server.port || 3333);
   const publicUrl = String(flags['public-url'] || config.server.publicUrl || `http://localhost:${port}`).replace(/\/$/, '');
@@ -486,7 +581,7 @@ function applyEnvironment(config, paths, flags) {
   const claude = config.providers.claude || {};
   const grok = config.providers.grok || {};
   const bedrock = config.providers.bedrock || {};
-  const azureOpenAI = config.providers.azureOpenAI || {};
+  const azureOpenAI = config.providers.azureOpenAI || config.providers.azureOpenai || {};
   const milvus = config.providers.milvus || {};
   const azureBlob = config.providers.azureBlob || {};
   const azureSearch = config.providers.azureSearch || {};
@@ -502,6 +597,9 @@ function applyEnvironment(config, paths, flags) {
   const httpBatch = config.httpBatch || {};
   const agentOps = config.agentOps || {};
   const aws = config.aws || {};
+  const configuredProvider = normalizeProviderName(openai.provider);
+  const azureOpenAIEnabled = configuredProvider === 'azure' || asBool(azureOpenAI.enabled);
+  const openaiProvider = azureOpenAIEnabled ? 'azure' : configuredProvider;
 
   setEnv('CANVAS_FLOW_HOME', paths.homeDir);
   setEnv('CANVAS_FLOW_CONFIG_FILE', paths.configPath);
@@ -562,7 +660,7 @@ function applyEnvironment(config, paths, flags) {
   setEnv('CANVAS_FLOW_MAX_STEP_VISITS', config.runtime.maxStepVisits || 10);
   setEnv('CANVAS_FLOW_PROVIDER_CACHE_MS', config.runtime.providerCacheMs || 10000);
 
-  setEnv('OPENAI_PROVIDER', openai.provider || 'openai');
+  setEnv('OPENAI_PROVIDER', openaiProvider);
   setEnv('LLM_PROVIDER', openai.llmProvider);
   setEnv('OPENAI_API_KEY', openai.apiKey);
   setEnv('OPENAI_CHAT_MODEL', openai.chatModel);
@@ -593,7 +691,7 @@ function applyEnvironment(config, paths, flags) {
   setEnv('BEDROCK_CHAT_MODEL', bedrock.chatModel || 'anthropic.claude-sonnet-4-6');
   setEnv('BEDROCK_MODEL', bedrock.chatModel || 'anthropic.claude-sonnet-4-6');
 
-  setBoolEnv('AZURE_OPENAI_ENABLED', asBool(azureOpenAI.enabled));
+  setBoolEnv('AZURE_OPENAI_ENABLED', azureOpenAIEnabled);
   setEnv('AZURE_OPENAI_API_KEY', azureOpenAI.apiKey);
   setEnv('AZURE_OPENAI_ENDPOINT', azureOpenAI.endpoint || azureOpenAI.apiBasePath);
   setEnv('AZURE_OPENAI_API_BASE_PATH', azureOpenAI.apiBasePath || azureOpenAI.endpoint);
@@ -650,6 +748,7 @@ function applyEnvironment(config, paths, flags) {
 
   setEnv('WHATSAPP_PROVIDER', whatsapp.provider || 'meta');
   setEnv('WHATSAPP_DELIVERY_MODE', whatsapp.deliveryMode || 'provider');
+  setEnv('WHATSAPP_ONBOARDING_MODE', whatsapp.onboardingMode || 'manual');
   setBoolEnv('WHATSAPP_AUTO_REPLY', whatsapp.autoReply !== false);
   setEnv('WHATSAPP_VERIFY_TOKEN', whatsapp.verifyToken);
   setEnv('WHATSAPP_ACCESS_TOKEN', whatsapp.accessToken);
@@ -657,6 +756,16 @@ function applyEnvironment(config, paths, flags) {
   setEnv('WHATSAPP_WABA_ID', whatsapp.wabaId || whatsapp.businessAccountId);
   setEnv('WHATSAPP_PHONE_NUMBER_ID', whatsapp.phoneNumberId);
   setEnv('WHATSAPP_GRAPH_API_VERSION', whatsapp.graphApiVersion || 'v20.0');
+  setBoolEnv('WHATSAPP_COEXISTENCE_ENABLED', whatsapp.coexistenceEnabled === true || whatsapp.onboardingMode === 'coexistence');
+  setBoolEnv('WHATSAPP_SYNC_MESSAGE_ECHOES', whatsapp.syncMessageEchoes !== false);
+  setBoolEnv('WHATSAPP_SYNC_HISTORY', whatsapp.syncHistory === true);
+  setEnv('WHATSAPP_EMBEDDED_SIGNUP_APP_ID', whatsapp.embeddedSignupAppId);
+  setEnv('WHATSAPP_EMBEDDED_SIGNUP_CONFIG_ID', whatsapp.embeddedSignupConfigId);
+  setEnv('WHATSAPP_EMBEDDED_SIGNUP_APP_SECRET', whatsapp.embeddedSignupAppSecret);
+  setEnv('WHATSAPP_EMBEDDED_SIGNUP_SOLUTION_ID', whatsapp.embeddedSignupSolutionId);
+  setEnv('WHATSAPP_EMBEDDED_SIGNUP_FEATURE_TYPE', whatsapp.embeddedSignupFeatureType);
+  setEnv('WHATSAPP_EMBEDDED_SIGNUP_SESSION_INFO_VERSION', whatsapp.embeddedSignupSessionInfoVersion || '3');
+  setEnv('WHATSAPP_EMBEDDED_SIGNUP_VERSION', whatsapp.embeddedSignupVersion);
   setEnv('BLIP_CONTRACT_ID', whatsapp.blipContractId);
   setEnv('BLIP_AUTHORIZATION_KEY', whatsapp.blipAuthorizationKey);
   setEnv('SINCH_PROJECT_ID', whatsapp.sinchProjectId);
@@ -1266,6 +1375,7 @@ async function waitForMongo(config, flags, paths, progress) {
 }
 
 async function start(flags) {
+  printStartupBanner(flags);
   const progress = createStartupProgress();
   let startupStatus;
   try {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@igoruehara/canvas-flow",
-  "version": "0.1.12",
+  "version": "0.1.14",
   "description": "Standalone npm launcher for Canvas Flow multi-agent GenAI workflows.",
   "homepage": "https://github.com/igoruehara/canvas-flow#readme",
   "repository": {