@indemn/cli 1.7.1 → 1.7.2

package/src/mcp/tool-meta.ts

@@ -47,7 +47,7 @@ export const TOOL_META: Record<string, ToolMeta> = {
   get_agent: read('Get agent'),
   create_agent: write('Create agent'),
   update_agent: { ...write('Update agent', { idempotentHint: true }), guard: true, describe: (a) => `This will change agent ${a.agent_id}.` },
-  delete_agent: { ...destroy('Delete agent'), guard: true, describe: (a) => `This will delete agent ${a.agent_id}. It cannot be restored from the CLI.` },
+  delete_agent: { ...destroy('Delete agent'), guard: true, describe: (a) => `This will delete agent ${a.agent_id}. It cannot be restored.` },
   agent_summary: read('Summarize agent'),
   agent_stats: read('Agent conversation metrics'),
   set_agent_lifecycle: {
@@ -93,8 +93,9 @@ export const TOOL_META: Record<string, ToolMeta> = {
     describe: (a) => `This will create ${((a.functions as unknown[] | undefined) ?? []).length} skill(s) on agent ${a.agent_id}.`,
   },
   list_function_parameters: read('List skill parameters'),
-  add_function_parameter: write('Add skill parameter'),
-  update_function_parameter: write('Update skill parameter', { idempotentHint: true }),
+  // Guarded like update_function: asked only when the agent may be live (liveChange in tools.ts).
+  add_function_parameter: { ...write('Add skill parameter'), guard: true },
+  update_function_parameter: { ...write('Update skill parameter', { idempotentHint: true }), guard: true },
   delete_function_parameter: { ...destroy('Delete skill parameter'), guard: true, describe: (a) => `This will delete parameter ${a.parameter_id} of skill ${a.function_id} on agent ${a.agent_id}.` },
   list_master_functions: { ...read('List skill templates'), paginate: true },
   list_llm_models: { ...read('List LLM models'), paginate: true },
@@ -109,12 +110,28 @@ export const TOOL_META: Record<string, ToolMeta> = {
   add_kb_data: write('Add knowledge base entry'),
   scrape_url: write('Scrape a website into a knowledge base', { openWorldHint: true }),
   upload_kb_file: write('Upload file to knowledge base'),
-  update_kb_data: write('Update knowledge base entry', { idempotentHint: true }),
+  update_kb_data: {
+    ...write('Update knowledge base entry', { idempotentHint: true }),
+    guard: true,
+    describe: (a) => `This will change entry ${a.source_id} of knowledge base ${a.kb_id}${a.answer ? ` to the answer: "${String(a.answer)}"` : ''}.`,
+  },
   delete_kb_data: { ...destroy('Delete knowledge base entry'), guard: true, describe: (a) => `This will delete source ${a.source_id} from knowledge base ${a.kb_id}, with its vectors.` },
-  link_kb: write('Link knowledge bases to agent', { idempotentHint: true }),
+  link_kb: {
+    ...write('Link knowledge bases to agent', { idempotentHint: true }),
+    guard: true,
+    describe: (a) => `This will let agent ${a.agent_id} answer from knowledge base(s) ${((a.kb_ids as string[] | undefined) ?? []).join(', ')}; customers get answers from them right away.`,
+  },
   unlink_kb: { ...destroy('Unlink knowledge base from agent'), guard: true, describe: (a) => `This will unlink knowledge base ${a.kb_id} from agent ${a.agent_id}; the agent stops using it immediately.` },
   export_kb: read('Export knowledge base'),
-  import_kb: { ...destroy('Import into knowledge base'), guard: true, describe: (a) => `This will import new content into knowledge base ${a.kb_id}.` },
+  import_kb: {
+    ...destroy('Import into knowledge base'),
+    guard: true,
+    describe: (a) => {
+      const sources = ((a.data as { sources?: Array<{ name?: string; url?: string }> } | undefined)?.sources ?? []);
+      const files = sources.map((s) => s.name ?? s.url?.split('?')[0].split('/').pop() ?? 'a file');
+      return `This will import ${files.length ? files.map((f) => `"${f}"`).join(', ') : 'new content'} into knowledge base ${a.kb_id}.`;
+    },
+  },
   kb_chunks: read('Show what the agent learned from a source'),
   reimport_kb_source: {
     ...write('Re-crawl a website source', { openWorldHint: true }),
@@ -144,7 +161,8 @@ export const TOOL_META: Record<string, ToolMeta> = {
   attach_phone_number: { ...write('Attach phone number'), guard: true, describe: (a) => `This will attach ${a.phone_number} to agent ${a.agent_id}; its voice settings reset to the defaults. Numbers the org does not own are refused (never bought).` },
   search_phone_numbers: read('Search phone numbers to buy'),
   get_phone_number: read('Get phone number details'),
-  buy_phone_number: { ...write('Buy phone number'), guard: true, describe: (a) => `This will BUY ${a.phone_number} from Twilio and attach it to agent ${a.agent_id}. The org pays for it every month, and it cannot be undone from here.` },
+  // Money leaves the org and nothing here undoes it: shown like a delete.
+  buy_phone_number: { ...destroy('Buy phone number'), guard: true, describe: (a) => `This will BUY ${a.phone_number} from Twilio and attach it to agent ${a.agent_id}. The org pays for it every month, and it cannot be undone from here.` },
   detach_phone_number: { ...destroy('Detach phone number'), guard: true, describe: (a) => `This will detach ${a.phone_number} from agent ${a.agent_id}; calls to it stop reaching the agent.` },
   voice_preview: write('Start a test voice call'),
 
@@ -166,8 +184,9 @@ export const TOOL_META: Record<string, ToolMeta> = {
   get_custom_chart: read('Get custom chart data'),
   get_org_settings: read('Get org settings'),
   set_org_timezone: { ...write('Set org timezone', { idempotentHint: true }), guard: true, describe: (a) => `This will set the org timezone to ${a.timezone}.` },
-  set_business_hours: { ...destroy('Replace business hours', { idempotentHint: true }), guard: true, describe: (a) => `This will replace the org business hours (enabled: ${a.enabled}).` },
+  set_business_hours: { ...destroy('Replace business hours', { idempotentHint: true }), guard: true },
   add_holiday: { ...write('Add holiday'), guard: true, describe: (a) => `This will close the org on ${a.date} (${a.name}).` },
+  remove_holiday: { ...destroy('Remove holiday'), guard: true, describe: (a) => `This will remove the holiday on ${a.date}; the org is open that day again.` },
   set_org_admin_settings: { ...write('Change org admin settings', { idempotentHint: true }), guard: true },
   list_audit_logs: read('List audit log'),
 
@@ -178,7 +197,14 @@ export const TOOL_META: Record<string, ToolMeta> = {
   update_ticket: write('Update, assign or close a ticket'),
   archive_ticket: { ...destroy('Archive ticket'), guard: true, describe: (a) => `This will archive ticket ${a.ticket_id}.` },
   list_ticket_rules: read('List ticket rules'),
-  save_ticket_rule: write('Create or change a ticket rule'),
+  // A standing rule: agents open tickets on their own from now on.
+  save_ticket_rule: {
+    ...write('Create or change a ticket rule'),
+    guard: true,
+    describe: (a) => a.rule_id
+      ? `This will change ticket rule ${a.rule_id}${a.prompt ? ` to open a ticket when: ${a.prompt}` : ''}${a.enabled === false ? ' and turn it off' : ''}.`
+      : `This will add ticket rule "${a.name ?? 'untitled'}": agents open a ticket whenever ${a.prompt}, for ${(a.agent_ids as string[] | undefined)?.length ? 'the chosen agents' : 'every agent'}, from now on.`,
+  },
   delete_ticket_rule: { ...destroy('Delete ticket rule'), guard: true, describe: (a) => `This will delete ticket rule ${a.rule_id}; agents stop opening tickets for it.` },
 
   // Billing (read-only)