@xuda.io/ai_module 1.1.5638 → 1.1.5640

package/index.mjs

@@ -413,7 +413,6 @@ const get_studio_table_info_tool = tool({
   async execute(e, RunContext) {
     const { table } = e;
     const { app_id, uid } = RunContext.context;
-    debugger;
     if (!table) throw new Error('got null in the table parameter');
 
     try {
@@ -558,7 +557,6 @@ const fetch_data_tool = tool({
       }
 
       const validateQuery_result = validateQueryAgainstTable(query_obj, table_doc.tableFields);
-      debugger;
       if (!validateQuery_result.isValid) {
         // console.error('Validation failed:', validateQuery_result.errors);
         throw new Error(`Validation failed: ${JSON.stringify(validateQuery_result.errors)}`);
@@ -795,7 +793,6 @@ const create_index_tool = tool({
     const { index } = e;
     const { app_id, uid } = RunContext.context;
     try {
-      debugger;
       const index_obj = JSON5.parse(index);
       console.log('Create Index', index_obj);
       const project_db = await get_project_db(app_id);
@@ -3993,7 +3990,6 @@ export const update_ai_agent_properties = async function (doc, app_id, uid, fiel
     db_doc.agentConfig.agent_industry = await get_agent_industry();
     db_doc.studio_meta.agent_industry = db_doc.agentConfig.agent_industry;
   }
-  debugger;
   if (db_doc.agentConfig.agent_user_guide && (fields_changed.agent_user_guide_changed || fields_changed.all)) {
     db_doc.agentConfig.agent_user_guide_fields = await get_agent_user_guide_fields();
     db_doc.studio_meta.agent_user_guide_fields = db_doc.agentConfig.agent_user_guide_fields;
@@ -4122,7 +4118,6 @@ export const update_thumbnail = async function (type, doc, app_id, uid, job_id,
     }
     return save_ret;
   } catch (error) {
-    debugger;
   }
   // }, 500);
 };
@@ -4738,6 +4733,154 @@ export const diagnose_vps_snapshot = async function (req) {
   }
 };
 
+// Map a studio program's menuType to a friendly, user-facing noun so the
+// release-notes prompt talks about "screens" and "workflows" rather than the
+// internal type ids. Unknown types fall back to a de-underscored label.
+const _human_menu_type = function (t) {
+  const map = {
+    component: 'screen',
+    workflow: 'workflow',
+    table: 'data table',
+    javascript: 'logic',
+    js: 'logic',
+    ai_agent: 'AI agent',
+    api: 'API',
+    style: 'style',
+    function: 'function',
+    query: 'query',
+    report: 'report',
+  };
+  return map[t] || (t ? String(t).replace(/_/g, ' ') : 'item');
+};
+
+// Generate user-facing release notes for a build the developer is about to
+// create. READ-ONLY: reads the project's PUBLISHED studio programs, diffs them
+// against the previous release's timestamp to see what changed since the last
+// build, and asks the model for a concise, plain-language changelog. Never
+// writes the release or mutates a program — the notes are returned for the
+// developer to review/edit before they hit Build. Credits are metered to the
+// caller via submit_chat_gpt_prompt -> record_ai_usage.
+// req: { app_id, version?, build_type?(major|minor|patch), instructions? }
+// -> { code:1, data:{ notes, changed_count, since_build, version } }
+//    { code:-6, insufficient_credits:true } when the account is out of credits.
+export const generate_release_notes = async function (req) {
+  const uid = req.uid || req.token_ret?.data?.uid;
+  const app_id_in = req.app_id;
+  const version = String(req.version || '').trim();
+  const build_type = String(req.build_type || '').trim(); // major | minor | patch
+  const steer = String(req.instructions || '')
+    .trim()
+    .slice(0, 400); // optional free-text hint from the developer
+
+  if (!uid) return { code: -1, data: 'not authorized' };
+  if (!app_id_in) return { code: -1, data: 'app_id required' };
+
+  // Credit gate — usage is metered, but block up-front if the account is
+  // already out (validate_credits_limit RETURNS the error, never throws).
+  const credit_err = await validate_credits_limit(uid, null, _conf.release_notes?.model || _conf.default_ai_model, 'release notes');
+  if (credit_err) return { code: -6, data: credit_err.message || 'insufficient credits', insufficient_credits: true };
+
+  // Resolve to the project (master) app — build/release data lives there.
+  let app_obj;
+  let app_ref;
+  try {
+    app_ref = await _common.get_project_app_id(app_id_in, true);
+    const app_ret = await db_module.get_app_obj(app_ref);
+    if (app_ret.code < 0 || !app_ret.data) return { code: -1, data: 'app not found' };
+    app_obj = app_ret.data;
+  } catch (e) {
+    return { code: -1, data: 'app not found' };
+  }
+
+  const app_name = app_obj.app_name || 'the app';
+  const prev_version = app_obj.app_publish_info?.version || '';
+  const last_build = app_obj.app_publish_info?.app_lastBuild || 0;
+
+  // Cutoff = the previous release's timestamp. Any program whose `ts`
+  // (last-saved time) is newer than this changed since that build.
+  let since_ts = 0;
+  try {
+    const rel = await db_module.find_app_couch_query(app_ref, {
+      selector: { docType: 'release', stat: { $lt: 4 } },
+      sort: [{ build_id: 'desc' }],
+      limit: 1,
+    });
+    since_ts = rel.docs?.[0]?.date || 0;
+  } catch (e) {
+    since_ts = 0;
+  }
+
+  // Published programs, projected to a tiny summary (bounds prompt tokens).
+  let progs = [];
+  try {
+    const res = await db_module.find_app_couch_query(app_ref, {
+      selector: { docType: 'studio', stat: 3 },
+      fields: ['ts', 'properties.menuType', 'properties.menuName', 'properties.menuTitle'],
+      limit: 99999,
+    });
+    progs = res.docs || [];
+  } catch (e) {
+    progs = [];
+  }
+
+  const first_build = !since_ts || last_build === 0;
+  const changed = progs.filter((p) => p && (first_build || (p.ts && p.ts > since_ts))).sort((a, b) => (b.ts || 0) - (a.ts || 0));
+
+  // Compact, deduped change list for the prompt (name + type; capped at 80).
+  const seen = new Set();
+  const items = [];
+  for (const p of changed) {
+    const name = p.properties?.menuTitle || p.properties?.menuName || 'Untitled';
+    const type = _human_menu_type(p.properties?.menuType);
+    const key = `${type}:${name}`;
+    if (seen.has(key)) continue;
+    seen.add(key);
+    items.push({ name, type });
+    if (items.length >= 80) break;
+  }
+
+  const by_type = {};
+  for (const it of items) by_type[it.type] = (by_type[it.type] || 0) + 1;
+  const type_summary = Object.entries(by_type)
+    .map(([t, n]) => `${n} ${t}${n > 1 ? 's' : ''}`)
+    .join(', ');
+
+  const parts = [
+    `You are writing end-user release notes for a no-code app called "${app_name}" built on the Xuda platform.`,
+    `The developer is publishing a new build to every deployment of this app. Write short, friendly, user-facing release notes that tell the people who USE the app what is new — in plain language, not technical jargon.`,
+    '',
+    'RULES:',
+    '- Output ONLY 2 to 5 concise bullet points, each a single short line. No title, no preamble, no sign-off — bullets only.',
+    '- Describe outcomes and improvements ("New School Info screen", "Faster class enrollment"), never internal file names or program types.',
+    '- Group related changes into one bullet instead of listing every item.',
+    '- Neutral, professional tone. Never invent features that the change list does not imply.',
+    '- Write in the SAME language as the program names below (e.g. Hebrew names -> Hebrew notes).',
+    steer ? `- The developer added this guidance — follow it: ${steer}` : '',
+    '',
+    `Version: ${prev_version ? prev_version + ' -> ' : ''}${version || '(new)'}${build_type ? `  (${build_type} release)` : ''}`,
+    first_build ? 'This is the FIRST published build. Write a brief "initial release" style note highlighting the main areas of the app.' : `Programs changed since the last build (${type_summary || 'general updates'}):`,
+    items.length ? items.map((it) => `- ${it.name} (${it.type})`).join('\n') : '(No specific program changes were detected — write a brief note about minor improvements and stability fixes.)',
+  ].filter(Boolean);
+
+  // account_profile_info is REQUIRED for usage to be metered: record_ai_usage
+  // throws (and skips broadcast_credits, so the nav meter never moves) without
+  // it. Fetch it like classify_external_app_scan / the chat flows do.
+  const account_profile_info = await get_active_account_profile_info(uid);
+
+  const ret = await submit_chat_gpt_prompt({
+    uid,
+    prompt: parts.join('\n'),
+    model: _conf.release_notes?.model || _conf.default_ai_model,
+    metadata: { func: 'generate_release_notes', app_id: app_ref, version },
+    account_profile_info,
+  });
+  if (ret.code < 0) return { code: -1, data: ret.data };
+
+  const notes = String(ret.data || '').trim();
+  if (!notes) return { code: -1, data: 'no notes generated' };
+  return { code: 1, data: { notes, changed_count: changed.length, since_build: last_build, version } };
+};
+
 function getFirstNWords(text, n = 10) {
   // Split on whitespace, keep punctuation attached to words
   const words = text.match(/\S+/g) || [];
@@ -4919,7 +5062,6 @@ export const create_conversation = async function (req, job_id, headers) {
 
     return save_ret;
   } catch (err) {
-    debugger;
 
     return { code: -5, data: err.message || String(err) };
   }
@@ -5176,7 +5318,6 @@ const update_conversation_mood_level = async function (uid, target_contacts = []
       }
     }
   } catch (err) {
-    debugger;
   }
 };
 
@@ -7144,7 +7285,6 @@ Hard restrictions:
         }
 
         try {
-          debugger;
           const api_allow_methods = Object.keys(_conf.cpi_methods);
           for (const method_name of api_allow_methods || []) {
             const method_prop = _conf.cpi_methods[method_name];
@@ -7199,7 +7339,6 @@ Hard restrictions:
                   inputSchema[key] = get_z_item(key, val);
                 }
               } catch (error) {
-                debugger;
               }
             }
             try {
@@ -7231,11 +7370,9 @@ Hard restrictions:
                 }),
               );
             } catch (error) {
-              debugger;
             }
           }
         } catch (error) {
-          debugger;
         }
         break;
       }
@@ -7306,7 +7443,6 @@ Hard restrictions:
               numGenerations: z.number().int().describe('Number generations to image create.').default(3),
             }),
             async execute(e, RunContext) {
-              debugger;
               const { prompt, numGenerations } = e;
 
               try {
@@ -7690,7 +7826,6 @@ const ai_chat_conversation = async function (req, job_id, headers) {
       });
 
       agent.on('agent_tool_start', (context, tool, details) => {
-        debugger;
         // emitToDashboard('agent_tool_start', tool.name);
         emitToDashboard('stream_phase', `Starting ${tool?.name?.replaceAll('_', ' ')} tool`, { update: true });
       });
@@ -7849,13 +7984,11 @@ const ai_chat_conversation = async function (req, job_id, headers) {
             if (!prompt_suggestion_activated) {
               // init_agent_hooks(agent);
               agent.on('onToolStart', (context, tool, details) => {
-                debugger;
                 // emitToDashboard('agent_tool_start', tool.name);
                 // emitToDashboard('stream_phase', `Starting ${tool.name} tool`);
               });
 
               agent.on('onToolEnd', (context, tool, details) => {
-                debugger;
                 // emitToDashboard('agent_tool_start', tool.name);
                 // emitToDashboard('stream_phase', `Starting ${tool.name} tool`);
               });
@@ -8000,7 +8133,6 @@ const ai_chat_conversation = async function (req, job_id, headers) {
     emitToDashboard('stream_phase', 'Submitting chat', { update: true });
     init_agent_hooks(_agent);
     // const output = await runner.run(_agent, prompt, opt);
-    debugger;
     const output = await run_agent(_agent, prompt, opt);
     const done = async function (output) {
       try {
@@ -8048,7 +8180,6 @@ const ai_chat_conversation = async function (req, job_id, headers) {
         // }
         const save_ret = await db_module.save_app_couch_doc_native(account_profile_info.app_id, in_conversation_item_obj);
 
-        debugger;
 
         let conversation_items = await client.conversations.items.list(conversation_doc.reference_conversation_id, { order: 'asc', after: last_conversation_item });
 
@@ -8070,7 +8201,6 @@ const ai_chat_conversation = async function (req, job_id, headers) {
 
         return save_ret;
       } catch (error) {
-        debugger;
       }
       // }
 
@@ -8135,7 +8265,6 @@ const ai_chat_conversation = async function (req, job_id, headers) {
     };
     // }
   } catch (err) {
-    debugger;
 
     conversation_doc = await db_module.get_app_couch_doc_native(account_profile_info.app_id, conversation_id);
     conversation_doc.ts = Date.now();
@@ -8239,6 +8368,11 @@ const auto_response = async function (uid, profile_id, contact_id, conversation_
 
     let account_doc = await db_module.get_couch_doc_native('xuda_accounts', uid);
 
+    // The main profile is the account's OWN identity: never auto-respond on it
+    // (you don't auto-reply to yourself). Authoritative check via the account's
+    // account_profile_id, independent of the stored auto_respond flag.
+    if (account_doc?.account_profile_id && profile_id === account_doc.account_profile_id) return;
+
     if (account_profile_doc.auto_respond_mode === 'when_offline' && account_doc.socket_id) return;
     if (!['always', 'when_offline'].includes(account_profile_doc.auto_respond_mode)) return;
 

package/index_ms.mjs

@@ -133,6 +133,10 @@ export const diagnose_vps_snapshot = async function (...args) {
   return await broker.send_to_queue("diagnose_vps_snapshot", ...args);
 };
 
+export const generate_release_notes = async function (...args) {
+  return await broker.send_to_queue("generate_release_notes", ...args);
+};
+
 export const create_openai_conversation = async function (...args) {
   return await broker.send_to_queue("create_openai_conversation", ...args);
 };

package/index_msa.mjs

@@ -133,6 +133,10 @@ export const diagnose_vps_snapshot =  function (...args) {
    broker.send_to_queue_async("diagnose_vps_snapshot", ...args);
 };
 
+export const generate_release_notes =  function (...args) {
+   broker.send_to_queue_async("generate_release_notes", ...args);
+};
+
 export const create_openai_conversation =  function (...args) {
    broker.send_to_queue_async("create_openai_conversation", ...args);
 };

package/old.mjs

@@ -580,7 +580,6 @@ async function testTool(app_id, uid) {
 
     console.log('Input:', JSON.stringify(input, null, 2));
     console.log('RunContext:', JSON.stringify(runContext, null, 2));
-    debugger;
     // CORRECT ORDER: input first, then runContext
     const result = await get_studio_table_info_by_table_id_tool.invoke(
       runContext, // 1st: context

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xuda.io/ai_module",
-  "version": "1.1.5638",
+  "version": "1.1.5640",
   "description": "Xuda AI Module",
   "main": "index.mjs",
   "type": "module",