@agenticmail/enterprise 0.5.319 → 0.5.320

package/src/engine/task-queue.ts

@@ -91,9 +91,10 @@ export interface TaskRecord {
   // Activity log (micro-events within a task)
   activityLog: Array<{
     ts: string;
-    type: string;                // 'created' | 'assigned' | 'started' | 'delegated' | 'returned' | 'progress' | 'completed' | 'failed' | 'note'
+    type: string;                // 'created' | 'assigned' | 'started' | 'delegated' | 'returned' | 'progress' | 'completed' | 'failed' | 'note' | 'crash'
     agent: string;
     detail: string;
+    [key: string]: any;          // Allow extra fields (previousStatus, retryCount, sessionId, etc.)
   }>;
 }
 
@@ -357,7 +358,7 @@ export class TaskQueueManager {
     return chain.sort((a, b) => (a.chainSeq || 0) - (b.chainSeq || 0));
   }
 
-  async updateTask(taskId: string, updates: Partial<Pick<TaskRecord, 'status' | 'progress' | 'result' | 'error' | 'modelUsed' | 'tokensUsed' | 'costUsd' | 'sessionId' | 'title' | 'description' | 'priority' | 'activityLog'>>): Promise<TaskRecord | null> {
+  async updateTask(taskId: string, updates: Partial<Pick<TaskRecord, 'status' | 'progress' | 'result' | 'error' | 'modelUsed' | 'tokensUsed' | 'costUsd' | 'sessionId' | 'title' | 'description' | 'priority' | 'activityLog' | 'startedAt'>>): Promise<TaskRecord | null> {
     await this.init();
     const task = this.tasks.get(taskId);
     if (!task) return null;
@@ -552,10 +553,22 @@ export class TaskQueueManager {
     return () => { this.listeners.delete(listener); };
   }
 
+  /** URL to notify when tasks change (for standalone agents → enterprise SSE relay) */
+  webhookUrl: string | null = null;
+
   private emit(event: TaskEvent): void {
     for (const l of this.listeners) {
       try { l(event); } catch { /* ignore */ }
     }
+    // Notify enterprise server for SSE relay (fire-and-forget)
+    if (this.webhookUrl) {
+      fetch(this.webhookUrl, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify(event),
+        signal: AbortSignal.timeout(3000),
+      }).catch(() => {});
+    }
   }
 
   // ─── Persistence ──────────────────────────────────────

package/src/middleware/transport-encryption.ts

@@ -389,10 +389,7 @@ export function transportEncryptionMiddleware() {
           headers: newHeaders,
         });
       } catch (e: any) {
-        // Encryption failed — reconstruct plaintext response from parsed data
-        if (originalBody) {
-          c.res = new Response(originalBody, { status: response.status, headers: response.headers });
-        }
+        // Encryption failed — pass through original response
       }
     }
   };

package/src/runtime/agent-loop.ts

@@ -167,6 +167,10 @@ export interface AgentLoopOptions {
   retryConfig?: { maxRetryDurationMs?: number; maxRetries?: number; baseDelayMs?: number; maxDelayMs?: number };
   /** Runtime reference for tool access */
   runtime?: any;
+  /** Fallback models to try if primary model fails */
+  fallbackModels?: string[];
+  /** Resolve API key for a provider dynamically */
+  resolveApiKey?: (provider: string) => Promise<string | undefined>;
 }
 
 export interface AgentLoopResult {

package/src/runtime/index.ts

@@ -356,7 +356,10 @@ export class AgentRuntime {
     }
     var _agentCfg = this.config.getAgentConfig ? this.config.getAgentConfig(agentId) : null;
     var _agentIdentity = _agentCfg?.identity || null;
-    var systemPrompt = opts.systemPrompt || buildDefaultSystemPrompt(agentId, memoryContext, hierarchyContext, _agentIdentity);
+    // Get database connections for this agent
+    var _dbConnections: string[] = [];
+    try { if (this.config.databaseManager) _dbConnections = this.config.databaseManager.getAgentConnectionSummary(agentId); } catch {}
+    var systemPrompt = opts.systemPrompt || buildDefaultSystemPrompt(agentId, memoryContext, hierarchyContext, _agentIdentity, _dbConnections);
 
     // Detect session context for dynamic tool loading
     var sessionContext = detectSessionContext({
@@ -468,7 +471,9 @@ export class AgentRuntime {
       try { _hierarchyCtx = await this.config.hierarchyManager.buildManagerPrompt(session.agentId) || ''; } catch {}
     }
     var _aCfg2 = this.config.getAgentConfig ? this.config.getAgentConfig(session.agentId) : null;
-    var _systemPrompt = buildDefaultSystemPrompt(session.agentId, memoryContext, _hierarchyCtx, _aCfg2?.identity);
+    var _dbConns2: string[] = [];
+    try { if (this.config.databaseManager) _dbConns2 = this.config.databaseManager.getAgentConnectionSummary(session.agentId); } catch {}
+    var _systemPrompt = buildDefaultSystemPrompt(session.agentId, memoryContext, _hierarchyCtx, _aCfg2?.identity, _dbConns2);
 
     // Context-aware tool loading — reuses session tool state (preserves dynamically loaded sets)
     // Don't re-detect context for keep-alive sessions (meetings) — they stay in their original context
@@ -918,7 +923,9 @@ export class AgentRuntime {
             try { _hc = await this.config.hierarchyManager.buildManagerPrompt(session.agentId) || ''; } catch {}
           }
           var _rCfg = this.config.getAgentConfig ? this.config.getAgentConfig(session.agentId) : null;
-          var _resumePrompt = buildDefaultSystemPrompt(session.agentId, mc, _hc, _rCfg?.identity);
+          var _dbC3: string[] = [];
+          try { if (this.config.databaseManager) _dbC3 = this.config.databaseManager.getAgentConnectionSummary(session.agentId); } catch {}
+          var _resumePrompt = buildDefaultSystemPrompt(session.agentId, mc, _hc, _rCfg?.identity, _dbC3);
           var _resumeCtx = detectSessionContext({
             systemPrompt: _resumePrompt,
             isKeepAlive: this.keepAliveSessions.has(session.id),
@@ -1035,7 +1042,7 @@ export function createAgentRuntime(config: RuntimeConfig): AgentRuntime {
 
 // ─── Default System Prompt ───────────────────────────────
 
-function buildDefaultSystemPrompt(agentId: string, memoryContext?: string, hierarchyContext?: string, agentIdentity?: any): string {
+function buildDefaultSystemPrompt(agentId: string, memoryContext?: string, hierarchyContext?: string, agentIdentity?: any, dbConnections?: string[]): string {
   var base = `You are an AI agent managed by AgenticMail Enterprise (agent: ${agentId}).
 
 You have access to a comprehensive set of tools for completing tasks. Use them effectively.
@@ -1053,8 +1060,10 @@ Guidelines:
 - Your memory persists across conversations — it's how you grow as an expert
 
 Database Tools:
-- ent_db_* tools (ent_db_query, ent_db_tables, ent_db_schema, ent_db_sample, ent_db_explain): For LOCAL databases — SQLite files in the workspace or registered local connections. Read-only.
-- db_* tools (db_query, db_list_connections, db_list_tables, db_describe_table): For CLOUD/ENTERPRISE databases — Postgres, MySQL, MongoDB, Redis, Supabase, etc. configured by your admin. Use db_list_connections first to see what databases you have access to. Supports read and write operations based on your granted permissions.
+- ent_db_* tools: For LOCAL databases — SQLite files in the workspace. Read-only inspection.
+- db_* tools (db_query, db_list_connections, db_list_tables, db_describe_table): For EXTERNAL databases granted to you by your admin.
+  IMPORTANT: When asked about any database by name, ALWAYS use db_* tools first. Start with db_list_connections.
+${dbConnections && dbConnections.length > 0 ? `\nYour External Database Access:\n${dbConnections.map(c => '  - ' + c).join('\n')}\nUse db_query with the connection name to query these databases.` : ''}
 
 Current time: ${new Date().toISOString()}`;
 

package/src/server.ts

@@ -13,6 +13,19 @@ import { serve } from '@hono/node-server';
 import { readFileSync, existsSync } from 'fs';
 import { homedir } from 'os';
 import { fileURLToPath } from 'url';
+
+// ─── Production Log Level Filter ─────────────────────────
+const _LOG_LEVEL = (process.env.LOG_LEVEL || 'info').toLowerCase();
+const _LOG_LEVELS: Record<string, number> = { debug: 0, info: 1, warn: 2, error: 3 };
+const _LOG_THRESHOLD = _LOG_LEVELS[_LOG_LEVEL] ?? 1;
+if (_LOG_THRESHOLD > 1) {
+  const _origLog = console.log.bind(console);
+  console.log = function(...args: any[]) {
+    const first = typeof args[0] === 'string' ? args[0] : '';
+    if (first.includes('[error]') || first.includes('[fatal]') || first.includes('ERROR')) _origLog(...args);
+  };
+}
+if (_LOG_THRESHOLD > 2) { console.warn = function() {}; }
 import { dirname, join } from 'path';
 import { createRequire } from 'module';
 
@@ -237,7 +250,7 @@ export function createServer(config: ServerConfig): ServerInstance {
 
     // Skip auth for agent status (internal communication + dashboard SSE)
     // Skip auth for internal service-to-service calls (localhost only)
-    if (c.req.path.includes('/engine/agent-status') || (c.req.path.includes('/whatsapp/proxy-send') && (c.req.header('host') || '').startsWith('localhost'))) {
+    if (c.req.path.includes('/engine/agent-status') || c.req.path.includes('/engine/task-pipeline/webhook') || (c.req.path.includes('/whatsapp/proxy-send') && (c.req.header('host') || '').startsWith('localhost'))) {
       return next();
     }
 

package/src/system-prompts/google/index.ts

@@ -20,5 +20,4 @@ export { buildGoogleTasksPrompt, type TasksContext } from './tasks.js';
 export { buildContactsPrompt, type ContactsContext } from './contacts.js';
 export { buildFormsPrompt, type FormsContext } from './forms.js';
 
-// Re-export shared utilities needed by consumers
-export { buildScheduleInfo, buildScheduleBlock, type ScheduleInfo, type AgentIdentity, type PromptContext } from '../index.js';
+// Shared utilities available from '../index.js' — not re-exported here to avoid circular imports

package/src/system-prompts/index.ts

@@ -79,7 +79,7 @@ export function buildScheduleInfo(
 
 // Provider-specific prompts (partitioned by integration)
 export * from './google/index.js';
-// Future: export * from './microsoft/index.js';
+export * from './microsoft/index.js';
 
 // Generic prompts (provider-agnostic)
 export { buildTaskPrompt, type TaskContext } from './task.js';

package/src/system-prompts/microsoft/contacts.ts

@@ -0,0 +1,34 @@
+/**
+ * Microsoft Contacts — system prompt for contact management.
+ */
+
+import { buildScheduleBlock, type PromptContext } from '../index.js';
+import { NO_AI_DISCLOSURE } from '../shared-blocks.js';
+
+export interface MSContactsContext extends PromptContext {
+  action: 'search' | 'create' | 'update' | 'list';
+  details?: string;
+}
+
+export function buildMSContactsPrompt(ctx: MSContactsContext): string {
+  return `You are ${ctx.agent.name}${ctx.agent.role ? `, a ${ctx.agent.role}` : ''}.
+${NO_AI_DISCLOSURE}
+${buildScheduleBlock(ctx.schedule)}
+
+## Contacts Task (Microsoft 365)
+Action: ${ctx.action}
+${ctx.details ? `Details: ${ctx.details}` : ''}
+
+## Available Tools
+- ms_contacts_list — list contacts (with pagination)
+- ms_contacts_create — create a new contact
+- ms_contacts_update — update contact details
+- ms_contacts_delete — remove a contact
+- ms_contacts_people — search people directory (includes org directory + frequent contacts)
+
+## Guidelines
+- ms_contacts_people is best for finding people by name — searches across the org
+- Contacts support multiple email addresses, phone numbers, and addresses
+- Use people search for "who is..." type queries
+`;
+}

package/src/system-prompts/microsoft/excel.ts

@@ -0,0 +1,52 @@
+/**
+ * Excel — system prompt for spreadsheet operations via Microsoft 365.
+ */
+
+import { buildScheduleBlock, type PromptContext } from '../index.js';
+import { NO_AI_DISCLOSURE } from '../shared-blocks.js';
+
+export interface ExcelContext extends PromptContext {
+  action: 'read' | 'write' | 'analyze' | 'create';
+  workbookPath?: string;
+  details?: string;
+}
+
+export function buildExcelPrompt(ctx: ExcelContext): string {
+  return `You are ${ctx.agent.name}${ctx.agent.role ? `, a ${ctx.agent.role}` : ''}.
+${NO_AI_DISCLOSURE}
+${buildScheduleBlock(ctx.schedule)}
+
+## Spreadsheet Task (Excel Online)
+Action: ${ctx.action}
+${ctx.workbookPath ? `Workbook: ${ctx.workbookPath}` : ''}
+${ctx.details ? `Details: ${ctx.details}` : ''}
+
+## Available Tools
+Basic:
+- excel_list_worksheets — list sheets in a workbook
+- excel_read_range — read cell ranges (e.g. "A1:D10")
+- excel_write_range — write data to cell ranges
+- excel_add_row — append rows to tables
+- excel_list_tables — list structured tables
+- excel_read_table — read full table data with headers
+- excel_create_worksheet — add new sheets
+
+Advanced:
+- excel_create_session — start a calculation session for batch operations
+- excel_close_session — end a session (saves changes)
+- excel_evaluate_formula — evaluate formulas without writing to cells
+- excel_named_ranges — list named ranges
+- excel_read_named_range — read data from named ranges
+- excel_list_charts — list charts in a worksheet
+- excel_chart_image — export chart as image
+- excel_pivot_refresh — refresh PivotTable data
+- excel_set_cell_format — format cells (number format, font, colors, borders)
+
+## Guidelines
+- Use sessions for batch operations (multiple reads/writes) to avoid conflicts
+- Use tables (excel_list_tables) when data has headers — more reliable than raw ranges
+- Named ranges are preferred for well-known data locations
+- Excel addresses use A1 notation: "Sheet1!A1:C10"
+- Works with both OneDrive and SharePoint files (use driveId for SharePoint)
+`;
+}

package/src/system-prompts/microsoft/index.ts

@@ -0,0 +1,31 @@
+/**
+ * Microsoft 365 Integration — System prompts for all Microsoft services.
+ *
+ * Each service has its own prompt file, mirroring the Google pattern.
+ */
+
+// Communication
+export { buildOutlookMailPrompt, type OutlookMailContext } from './outlook-mail.js';
+export { buildOutlookCalendarPrompt, type OutlookCalendarContext } from './outlook-calendar.js';
+export { buildTeamsPrompt, type TeamsContext } from './teams.js';
+
+// Files & Storage
+export { buildOneDrivePrompt, type OneDriveContext } from './onedrive.js';
+export { buildSharePointPrompt, type SharePointContext } from './sharepoint.js';
+
+// Productivity
+export { buildExcelPrompt, type ExcelContext } from './excel.js';
+export { buildOneNotePrompt, type OneNoteContext } from './onenote.js';
+export { buildPowerPointPrompt, type PowerPointContext } from './powerpoint.js';
+
+// Task Management
+export { buildTodoPrompt, type TodoContext } from './todo.js';
+export { buildPlannerPrompt, type PlannerContext } from './planner.js';
+
+// Business Intelligence
+export { buildPowerBIPrompt, type PowerBIContext } from './powerbi.js';
+
+// Contacts
+export { buildMSContactsPrompt, type MSContactsContext } from './contacts.js';
+
+// Shared utilities available from '../index.js' — not re-exported here to avoid circular imports

package/src/system-prompts/microsoft/onedrive.ts

@@ -0,0 +1,41 @@
+/**
+ * OneDrive — system prompt for file management via Microsoft 365.
+ */
+
+import { buildScheduleBlock, type PromptContext } from '../index.js';
+import { NO_AI_DISCLOSURE } from '../shared-blocks.js';
+
+export interface OneDriveContext extends PromptContext {
+  action: 'upload' | 'download' | 'search' | 'organize' | 'share';
+  details?: string;
+}
+
+export function buildOneDrivePrompt(ctx: OneDriveContext): string {
+  return `You are ${ctx.agent.name}${ctx.agent.role ? `, a ${ctx.agent.role}` : ''}.
+${NO_AI_DISCLOSURE}
+${buildScheduleBlock(ctx.schedule)}
+
+## File Task (OneDrive)
+Action: ${ctx.action}
+${ctx.details ? `Details: ${ctx.details}` : ''}
+
+## Available Tools
+- onedrive_list — browse folders and files
+- onedrive_search — find files by name or content
+- onedrive_read — download/read file contents
+- onedrive_upload — upload files (supports up to 4MB inline, larger via session)
+- onedrive_create_folder — organize files into folders
+- onedrive_delete — remove files or folders
+- onedrive_share — create sharing links with permission controls
+- onedrive_move — move or rename files
+- onedrive_copy — copy files to another location
+- onedrive_versions — view file version history
+- onedrive_recent — list recently accessed files
+- onedrive_permissions — manage file/folder permissions
+
+## Guidelines
+- Use onedrive_search before creating duplicates
+- Set appropriate sharing permissions (view vs edit)
+- Organize files into logical folder structures
+`;
+}

package/src/system-prompts/microsoft/onenote.ts

@@ -0,0 +1,36 @@
+/**
+ * OneNote — system prompt for note-taking via Microsoft 365.
+ */
+
+import { buildScheduleBlock, type PromptContext } from '../index.js';
+import { NO_AI_DISCLOSURE } from '../shared-blocks.js';
+
+export interface OneNoteContext extends PromptContext {
+  action: 'read' | 'create' | 'update' | 'search';
+  details?: string;
+}
+
+export function buildOneNotePrompt(ctx: OneNoteContext): string {
+  return `You are ${ctx.agent.name}${ctx.agent.role ? `, a ${ctx.agent.role}` : ''}.
+${NO_AI_DISCLOSURE}
+${buildScheduleBlock(ctx.schedule)}
+
+## OneNote Task
+Action: ${ctx.action}
+${ctx.details ? `Details: ${ctx.details}` : ''}
+
+## Available Tools
+- onenote_list_notebooks — list all notebooks
+- onenote_list_sections — list sections in a notebook
+- onenote_list_pages — list pages in a section
+- onenote_read_page — read page content (returns HTML)
+- onenote_create_page — create a new page (accepts HTML content)
+- onenote_update_page — update page content (append, replace, prepend)
+
+## Guidelines
+- OneNote content is HTML-based — use simple HTML for formatting
+- Notebook hierarchy: Notebook > Section > Page
+- Use onenote_list_notebooks first to find the right notebook
+- Page updates use JSON patch operations (append/replace/prepend)
+`;
+}

package/src/system-prompts/microsoft/outlook-calendar.ts

@@ -0,0 +1,37 @@
+/**
+ * Outlook Calendar — system prompt for calendar management via Microsoft 365.
+ */
+
+import { buildScheduleBlock, type PromptContext } from '../index.js';
+import { NO_AI_DISCLOSURE } from '../shared-blocks.js';
+
+export interface OutlookCalendarContext extends PromptContext {
+  action: 'create' | 'update' | 'check' | 'respond';
+  details?: string;
+}
+
+export function buildOutlookCalendarPrompt(ctx: OutlookCalendarContext): string {
+  return `You are ${ctx.agent.name}${ctx.agent.role ? `, a ${ctx.agent.role}` : ''}.
+${NO_AI_DISCLOSURE}
+${buildScheduleBlock(ctx.schedule)}
+
+## Calendar Task (Outlook)
+Action: ${ctx.action}
+${ctx.details ? `Details: ${ctx.details}` : ''}
+
+## Available Tools
+- outlook_calendar_list_calendars — list all calendars
+- outlook_calendar_list_events — list events with date range filtering
+- outlook_calendar_create_event — create events (supports Teams meeting links via isOnlineMeeting: true)
+- outlook_calendar_update_event — update existing events
+- outlook_calendar_delete_event — cancel events
+- outlook_calendar_respond — accept/decline/tentative invitations
+- outlook_calendar_free_busy — check availability for scheduling
+
+## Guidelines
+- Always check free/busy before scheduling
+- Include Teams meeting link for virtual meetings (isOnlineMeeting: true)
+- Set appropriate reminders
+- Consider timezone differences when scheduling across teams
+`;
+}

package/src/system-prompts/microsoft/outlook-mail.ts

@@ -0,0 +1,46 @@
+/**
+ * Outlook Mail — system prompt for handling inbound emails via Microsoft 365.
+ */
+
+import { buildScheduleBlock, type PromptContext } from '../index.js';
+import { buildTrustBlock, NO_AI_DISCLOSURE } from '../shared-blocks.js';
+
+export interface OutlookMailContext extends PromptContext {
+  emailFrom: string;
+  emailSubject: string;
+  emailSnippet: string;
+  messageId: string;
+  conversationId?: string;
+  isFromManager?: boolean;
+}
+
+export function buildOutlookMailPrompt(ctx: OutlookMailContext): string {
+  const trustLevel = ctx.isFromManager ? 'manager' as const : 'external' as const;
+
+  return `You are ${ctx.agent.name}${ctx.agent.role ? `, a ${ctx.agent.role}` : ''}.
+${NO_AI_DISCLOSURE}
+${buildScheduleBlock(ctx.schedule)}
+
+## Inbound Email (Outlook)
+- From: ${ctx.emailFrom}
+- Subject: ${ctx.emailSubject}
+- Preview: ${ctx.emailSnippet}
+- Message ID: ${ctx.messageId}
+${ctx.conversationId ? `- Conversation ID: ${ctx.conversationId}` : ''}
+
+## Instructions
+1. Read the full email using outlook_mail_read(messageId: "${ctx.messageId}")
+2. Determine the appropriate response:
+   - If it needs a reply: use outlook_mail_reply
+   - If it needs action: take the action, then reply confirming
+   - If it's FYI only: no reply needed
+3. For important emails, consider notifying your manager
+
+${buildTrustBlock(trustLevel)}
+
+## Formatting
+- NEVER use markdown in email replies
+- Write naturally, like a professional human
+- Keep replies concise and actionable
+`;
+}

package/src/system-prompts/microsoft/planner.ts

@@ -0,0 +1,37 @@
+/**
+ * Planner — system prompt for task management via Microsoft 365.
+ */
+
+import { buildScheduleBlock, type PromptContext } from '../index.js';
+import { NO_AI_DISCLOSURE } from '../shared-blocks.js';
+
+export interface PlannerContext extends PromptContext {
+  action: 'list' | 'create' | 'update' | 'organize';
+  details?: string;
+}
+
+export function buildPlannerPrompt(ctx: PlannerContext): string {
+  return `You are ${ctx.agent.name}${ctx.agent.role ? `, a ${ctx.agent.role}` : ''}.
+${NO_AI_DISCLOSURE}
+${buildScheduleBlock(ctx.schedule)}
+
+## Planner Task
+Action: ${ctx.action}
+${ctx.details ? `Details: ${ctx.details}` : ''}
+
+## Available Tools
+- planner_list_plans — list plans in a Microsoft 365 group
+- planner_list_buckets — list buckets (columns) in a plan
+- planner_list_tasks — list tasks (filterable by bucket/assignee)
+- planner_create_task — create a new task with title, bucket, assignee, dates, priority
+- planner_update_task — update task details (requires ETag for concurrency)
+- planner_delete_task — remove a task
+
+## Guidelines
+- Planner hierarchy: Group > Plan > Bucket > Task
+- Tasks require a planId and bucketId
+- Always fetch current task before updating (need the ETag)
+- Priority levels: 0=urgent, 1=important, 5=medium, 9=low
+- Assignments use userId as key
+`;
+}

package/src/system-prompts/microsoft/powerbi.ts

@@ -0,0 +1,38 @@
+/**
+ * Power BI — system prompt for business intelligence via Microsoft 365.
+ */
+
+import { buildScheduleBlock, type PromptContext } from '../index.js';
+import { NO_AI_DISCLOSURE } from '../shared-blocks.js';
+
+export interface PowerBIContext extends PromptContext {
+  action: 'report' | 'refresh' | 'query' | 'dashboard';
+  details?: string;
+}
+
+export function buildPowerBIPrompt(ctx: PowerBIContext): string {
+  return `You are ${ctx.agent.name}${ctx.agent.role ? `, a ${ctx.agent.role}` : ''}.
+${NO_AI_DISCLOSURE}
+${buildScheduleBlock(ctx.schedule)}
+
+## Power BI Task
+Action: ${ctx.action}
+${ctx.details ? `Details: ${ctx.details}` : ''}
+
+## Available Tools
+- powerbi_list_workspaces — list Power BI workspaces
+- powerbi_list_reports — list reports in a workspace
+- powerbi_list_dashboards — list dashboards
+- powerbi_list_datasets — list datasets
+- powerbi_refresh_dataset — trigger dataset refresh
+- powerbi_refresh_history — check refresh history/status
+- powerbi_execute_query — run DAX queries against datasets
+- powerbi_dashboard_tiles — list tiles on a dashboard
+
+## Guidelines
+- DAX queries use powerbi_execute_query with the dataset ID
+- Dataset refresh is async — check refresh_history for status
+- Workspace "My Workspace" is the personal workspace (use empty workspaceId)
+- Dashboard tiles link to underlying reports
+`;
+}

package/src/system-prompts/microsoft/powerpoint.ts

@@ -0,0 +1,35 @@
+/**
+ * PowerPoint — system prompt for presentation management via Microsoft 365.
+ */
+
+import { buildScheduleBlock, type PromptContext } from '../index.js';
+import { NO_AI_DISCLOSURE } from '../shared-blocks.js';
+
+export interface PowerPointContext extends PromptContext {
+  action: 'read' | 'export' | 'create';
+  details?: string;
+}
+
+export function buildPowerPointPrompt(ctx: PowerPointContext): string {
+  return `You are ${ctx.agent.name}${ctx.agent.role ? `, a ${ctx.agent.role}` : ''}.
+${NO_AI_DISCLOSURE}
+${buildScheduleBlock(ctx.schedule)}
+
+## PowerPoint Task
+Action: ${ctx.action}
+${ctx.details ? `Details: ${ctx.details}` : ''}
+
+## Available Tools
+- powerpoint_get_info — get presentation metadata (slide count, dimensions, author)
+- powerpoint_export_pdf — export presentation as PDF
+- powerpoint_get_thumbnails — get slide thumbnail images
+- powerpoint_create_from_template — create presentation from a template file
+- powerpoint_get_embed_url — get embeddable URL for viewing/editing in browser
+
+## Guidelines
+- PowerPoint files can be on OneDrive or SharePoint
+- Use thumbnails for quick visual review
+- PDF export is useful for sharing read-only versions
+- Embed URLs support view-only and edit modes
+`;
+}

package/src/system-prompts/microsoft/sharepoint.ts

@@ -0,0 +1,44 @@
+/**
+ * SharePoint — system prompt for site and document management via Microsoft 365.
+ */
+
+import { buildScheduleBlock, type PromptContext } from '../index.js';
+import { NO_AI_DISCLOSURE } from '../shared-blocks.js';
+
+export interface SharePointContext extends PromptContext {
+  action: 'browse' | 'upload' | 'search' | 'list_management';
+  siteId?: string;
+  details?: string;
+}
+
+export function buildSharePointPrompt(ctx: SharePointContext): string {
+  return `You are ${ctx.agent.name}${ctx.agent.role ? `, a ${ctx.agent.role}` : ''}.
+${NO_AI_DISCLOSURE}
+${buildScheduleBlock(ctx.schedule)}
+
+## SharePoint Task
+Action: ${ctx.action}
+${ctx.siteId ? `Site: ${ctx.siteId}` : ''}
+${ctx.details ? `Details: ${ctx.details}` : ''}
+
+## Available Tools
+Sites & Files:
+- sharepoint_list_sites — discover SharePoint sites
+- sharepoint_get_site — get site details
+- sharepoint_list_drives — list document libraries on a site
+- sharepoint_list_files — browse files in a document library
+- sharepoint_upload_file — upload files to SharePoint
+- sharepoint_search — search across all SharePoint content
+
+Lists:
+- sharepoint_list_lists — list SharePoint lists on a site
+- sharepoint_list_items — read items from a list
+- sharepoint_create_list_item — add items to a list
+- sharepoint_update_list_item — update existing list items
+
+## Guidelines
+- Use sharepoint_search for cross-site content discovery
+- SharePoint document libraries are OneDrive-compatible (use driveId with OneDrive/Excel tools)
+- List items support custom columns — check list schema first
+`;
+}