@hailer/mcp 1.0.29 → 1.1.2

package/dist/bot/services/workspace-schema-cache.js

@@ -0,0 +1,506 @@
+"use strict";
+/**
+ * Workspace Schema Cache Service
+ *
+ * Dynamically discovers and caches workflow schemas per workspace.
+ * Replaces hardcoded workflow/field IDs with runtime lookup.
+ *
+ * WORKSPACE ISOLATION: Each workspace gets its own workflow IDs.
+ * Never use hardcoded IDs - always lookup via this cache.
+ *
+ * On bot startup:
+ * 1. Check memory cache first
+ * 2. If cache miss: Query list_workflows to find AI Agent workflows by name
+ * 3. If missing, install them from marketplace
+ * 4. Query get_workflow_schema to get field IDs
+ * 5. Store in memory cache for session duration
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WorkspaceSchemaCacheService = void 0;
+/** AI Agent template ID in marketplace (HR for AI Agents) */
+const AI_AGENT_TEMPLATE_ID = "685ab3c39af7445dd5384ffd";
+/** Known workflow names from the AI Agent template (partial match, case insensitive) */
+const TEMPLATE_WORKFLOW_PATTERNS = {
+    SESSION_LOG: ["session log", "session_log"],
+    AGENT_DIRECTORY: ["agent directory", "agent_directory"],
+    POSITIONS: ["positions", "position"],
+    TEAMS: ["teams", "team"],
+    TOOL_REGISTRY: ["tool registry", "tool_registry", "mcp server"],
+    MCP_CONFIG: ["mcp config", "mcp_config", "mcp configuration"],
+};
+class WorkspaceSchemaCacheService {
+    logger;
+    callMcpTool;
+    cache = new Map();
+    constructor(logger, callMcpTool) {
+        this.logger = logger;
+        this.callMcpTool = callMcpTool;
+    }
+    /**
+     * Initialize schema cache for a workspace
+     * Call this on bot startup after connecting to Hailer
+     *
+     * Set SKIP_SCHEMA_DISCOVERY=true to skip API calls on startup.
+     * HAL can discover workflows on-demand via MCP tools when needed.
+     */
+    async initializeForWorkspace(workspaceId) {
+        // 1. Check memory cache first
+        const existing = this.cache.get(workspaceId);
+        if (existing?.initialized) {
+            this.logger.debug("Using memory-cached workspace schemas", { workspaceId });
+            return existing;
+        }
+        // 2. Check if schema discovery is disabled (saves dozens of API calls on startup)
+        if (process.env.SKIP_SCHEMA_DISCOVERY === 'true') {
+            this.logger.debug("Schema discovery skipped (SKIP_SCHEMA_DISCOVERY=true)", { workspaceId });
+            const schemas = {
+                workspaceId,
+                initialized: true,
+            };
+            this.cache.set(workspaceId, schemas);
+            return schemas;
+        }
+        // 3. Discover via API
+        this.logger.debug("Discovering workspace schemas via API", { workspaceId });
+        const schemas = {
+            workspaceId,
+            initialized: false,
+        };
+        try {
+            // Fetch all workflows in workspace
+            const workflowsResult = await this.callMcpTool("list_workflows", {
+                workspace: workspaceId,
+            });
+            const workflowsText = workflowsResult?.content?.[0]?.text;
+            if (!workflowsText) {
+                this.logger.warn("No workflows found in workspace", { workspaceId });
+                schemas.initialized = true;
+                this.cache.set(workspaceId, schemas);
+                return schemas;
+            }
+            // Parse workflows
+            const workflows = this.parseWorkflows(workflowsText);
+            this.logger.debug("Found workflows", { workspaceId, count: workflows.length });
+            // Find template workflows
+            this.mapWorkflowsToSchemas(workflows, schemas);
+            // Check if required workflows are missing
+            const missingRequired = !schemas.sessionLog || !schemas.agentDirectory;
+            if (missingRequired) {
+                this.logger.info("AI Agent workflows not found, installing from marketplace", { workspaceId });
+                const installed = await this.installAgentTemplate(workspaceId);
+                if (installed) {
+                    // Re-fetch workflows after installation
+                    const refreshResult = await this.callMcpTool("list_workflows", {
+                        workspace: workspaceId,
+                    });
+                    const refreshText = refreshResult?.content?.[0]?.text;
+                    if (refreshText) {
+                        const refreshedWorkflows = this.parseWorkflows(refreshText);
+                        this.mapWorkflowsToSchemas(refreshedWorkflows, schemas);
+                    }
+                }
+            }
+            // Load detailed schemas for found workflows
+            await this.loadDetailedSchemas(schemas);
+            schemas.initialized = true;
+            this.cache.set(workspaceId, schemas);
+            this.logger.debug("Workspace schemas cached", {
+                workspaceId,
+                hasSessionLog: !!schemas.sessionLog,
+                hasAgentDirectory: !!schemas.agentDirectory,
+                hasPositions: !!schemas.positions,
+            });
+            return schemas;
+        }
+        catch (error) {
+            this.logger.error("Failed to initialize workspace schemas", {
+                workspaceId,
+                error: error instanceof Error ? error.message : String(error),
+            });
+            schemas.initialized = true; // Mark as initialized even on error to prevent retry loops
+            this.cache.set(workspaceId, schemas);
+            return schemas;
+        }
+    }
+    /**
+     * Get cached schemas for a workspace
+     */
+    getSchemas(workspaceId) {
+        return this.cache.get(workspaceId);
+    }
+    /**
+     * Get Session Log schema for a workspace
+     */
+    getSessionLogSchema(workspaceId) {
+        return this.cache.get(workspaceId)?.sessionLog;
+    }
+    /**
+     * Get Agent Directory schema for a workspace
+     */
+    getAgentDirectorySchema(workspaceId) {
+        return this.cache.get(workspaceId)?.agentDirectory;
+    }
+    /**
+     * Get Positions schema for a workspace
+     */
+    getPositionsSchema(workspaceId) {
+        return this.cache.get(workspaceId)?.positions;
+    }
+    /**
+     * Get Teams schema for a workspace
+     */
+    getTeamsSchema(workspaceId) {
+        return this.cache.get(workspaceId)?.teams;
+    }
+    /**
+     * Get Tool Registry schema for a workspace
+     */
+    getToolRegistrySchema(workspaceId) {
+        return this.cache.get(workspaceId)?.toolRegistry;
+    }
+    /**
+     * Get MCP Config schema for a workspace
+     */
+    getMcpConfigSchema(workspaceId) {
+        return this.cache.get(workspaceId)?.mcpConfig;
+    }
+    /**
+     * Check if a workspace has the AI Agent template installed
+     */
+    hasAgentTemplate(workspaceId) {
+        const schemas = this.cache.get(workspaceId);
+        return !!(schemas?.sessionLog && schemas?.agentDirectory);
+    }
+    /**
+     * Check if workflow name matches a pattern (case insensitive, ignores emojis)
+     */
+    matchesPattern(workflowName, patterns) {
+        // Normalize: lowercase, remove emojis and extra whitespace
+        const normalized = workflowName
+            .toLowerCase()
+            .replace(/[\u{1F300}-\u{1F9FF}]/gu, "") // Remove emojis
+            .replace(/\s+/g, " ")
+            .trim();
+        return patterns.some(pattern => normalized.includes(pattern));
+    }
+    /**
+     * Map workflow list to schema slots (using pattern matching)
+     */
+    mapWorkflowsToSchemas(workflows, schemas) {
+        for (const workflow of workflows) {
+            // Filter by workspace if specified
+            if (schemas.workspaceId && workflow.workspaceId && workflow.workspaceId !== schemas.workspaceId) {
+                continue;
+            }
+            if (this.matchesPattern(workflow.name, TEMPLATE_WORKFLOW_PATTERNS.SESSION_LOG)) {
+                schemas.sessionLog = { workflowId: workflow.id, name: workflow.name, phases: {}, fields: {} };
+            }
+            else if (this.matchesPattern(workflow.name, TEMPLATE_WORKFLOW_PATTERNS.AGENT_DIRECTORY)) {
+                schemas.agentDirectory = { workflowId: workflow.id, name: workflow.name, phases: {}, fields: {} };
+            }
+            else if (this.matchesPattern(workflow.name, TEMPLATE_WORKFLOW_PATTERNS.POSITIONS)) {
+                schemas.positions = { workflowId: workflow.id, name: workflow.name, phases: {}, fields: {} };
+            }
+            else if (this.matchesPattern(workflow.name, TEMPLATE_WORKFLOW_PATTERNS.TEAMS) && workflow.name.toLowerCase().includes("team")) {
+                // Be more specific for Teams to avoid matching "Teams" workflow in sports data
+                if (workflow.name.includes("\uD83C\uDF96\uFE0F") || workflow.name.toLowerCase() === "teams") {
+                    schemas.teams = { workflowId: workflow.id, name: workflow.name, phases: {}, fields: {} };
+                }
+            }
+            else if (this.matchesPattern(workflow.name, TEMPLATE_WORKFLOW_PATTERNS.TOOL_REGISTRY)) {
+                schemas.toolRegistry = { workflowId: workflow.id, name: workflow.name, phases: {}, fields: {} };
+            }
+            else if (this.matchesPattern(workflow.name, TEMPLATE_WORKFLOW_PATTERNS.MCP_CONFIG)) {
+                schemas.mcpConfig = { workflowId: workflow.id, name: workflow.name, phases: {}, fields: {} };
+            }
+        }
+    }
+    /**
+     * Load detailed schemas (phases, fields) for all found workflows
+     */
+    async loadDetailedSchemas(schemas) {
+        const schemaProps = ['sessionLog', 'agentDirectory', 'positions', 'teams', 'toolRegistry', 'mcpConfig'];
+        for (const prop of schemaProps) {
+            if (schemas[prop]) {
+                await this.loadWorkflowSchemaDetails(schemas[prop]);
+            }
+        }
+    }
+    /**
+     * Install AI Agent template from marketplace
+     */
+    async installAgentTemplate(workspaceId) {
+        try {
+            // First try to find the template by name in marketplace
+            const templatesResult = await this.callMcpTool("list_templates", {
+                publicOnly: true,
+            });
+            let templateId = AI_AGENT_TEMPLATE_ID;
+            const templatesText = templatesResult?.content?.[0]?.text;
+            if (templatesText) {
+                try {
+                    const parsed = JSON.parse(templatesText);
+                    const templates = parsed.templates || parsed.data || parsed;
+                    if (Array.isArray(templates)) {
+                        const agentTemplate = templates.find((t) => t.name?.includes("AI Agent") || t.title?.includes("AI Agent"));
+                        if (agentTemplate?._id) {
+                            templateId = agentTemplate._id;
+                        }
+                    }
+                }
+                catch {
+                    // Use default template ID
+                }
+            }
+            this.logger.info("Installing AI Agent template", { workspaceId, templateId });
+            const installResult = await this.callMcpTool("install_template", {
+                templateId,
+                workspaceId,
+            });
+            const installText = installResult?.content?.[0]?.text || "";
+            // Check for explicit error indicators
+            const hasError = installText.toLowerCase().includes("error") ||
+                installText.toLowerCase().includes("not found") ||
+                installText.toLowerCase().includes("failed");
+            const hasSuccess = installText.toLowerCase().includes("success") ||
+                installText.toLowerCase().includes("installed") ||
+                installText.toLowerCase().includes("created");
+            const success = hasSuccess && !hasError;
+            if (success) {
+                this.logger.info("AI Agent template installed successfully", { workspaceId });
+            }
+            else {
+                this.logger.warn("Template installation failed", {
+                    workspaceId,
+                    response: installText.substring(0, 300),
+                });
+            }
+            return success;
+        }
+        catch (error) {
+            this.logger.error("Failed to install AI Agent template", {
+                workspaceId,
+                error: error instanceof Error ? error.message : String(error),
+            });
+            return false;
+        }
+    }
+    /**
+     * Parse workflows from list_workflows response
+     * Handles both raw JSON and markdown-wrapped JSON responses
+     */
+    parseWorkflows(text) {
+        const workflows = [];
+        try {
+            // First, try to extract JSON array from markdown-wrapped response
+            let jsonText = text;
+            // Try to extract JSON array from markdown
+            const jsonArrayMatch = text.match(/\[\s*\{[\s\S]*?\}\s*\]/);
+            if (jsonArrayMatch) {
+                jsonText = jsonArrayMatch[0];
+            }
+            const parsed = JSON.parse(jsonText);
+            const items = Array.isArray(parsed) ? parsed : (parsed.workflows || parsed.data || []);
+            if (Array.isArray(items)) {
+                for (const item of items) {
+                    // Support both `id` and `_id` field names
+                    const id = item.id || item._id;
+                    const name = item.name;
+                    const workspaceId = item.workspaceId;
+                    if (id && name) {
+                        workflows.push({ id, name, workspaceId });
+                    }
+                }
+            }
+        }
+        catch {
+            // Fallback: regex extraction for both id and _id patterns
+            const idMatches = text.matchAll(/"(?:id|_id)":\s*"([a-f0-9]{24})"/gi);
+            const nameMatches = text.matchAll(/"name":\s*"([^"]+)"/gi);
+            const wsMatches = text.matchAll(/"workspaceId":\s*"([a-f0-9]{24})"/gi);
+            const ids = [...idMatches].map(m => m[1]);
+            const names = [...nameMatches].map(m => m[1]);
+            const wsIds = [...wsMatches].map(m => m[1]);
+            for (let i = 0; i < Math.min(ids.length, names.length); i++) {
+                workflows.push({
+                    id: ids[i],
+                    name: names[i],
+                    workspaceId: wsIds[i],
+                });
+            }
+        }
+        this.logger.debug("Parsed workflows from response", { count: workflows.length });
+        return workflows;
+    }
+    /**
+     * Load detailed workflow schema (phases and fields) for an existing schema
+     */
+    async loadWorkflowSchemaDetails(schema) {
+        try {
+            // Get phases first
+            const phasesResult = await this.callMcpTool("list_workflow_phases", {
+                workflowId: schema.workflowId,
+            });
+            const phasesText = phasesResult?.content?.[0]?.text;
+            if (phasesText) {
+                this.parsePhases(phasesText, schema);
+            }
+            this.logger.debug("Parsed phases for workflow", {
+                workflowId: schema.workflowId,
+                workflowName: schema.name,
+                phaseCount: Object.keys(schema.phases).length,
+                phases: Object.keys(schema.phases),
+            });
+            // Get schema with fields (use first phase)
+            const firstPhaseId = Object.values(schema.phases)[0];
+            if (firstPhaseId) {
+                const schemaResult = await this.callMcpTool("get_workflow_schema", {
+                    workflowId: schema.workflowId,
+                    phaseId: firstPhaseId,
+                });
+                const schemaText = schemaResult?.content?.[0]?.text;
+                if (schemaText) {
+                    this.parseFields(schemaText, schema);
+                    this.logger.debug("Parsed fields for workflow", {
+                        workflowId: schema.workflowId,
+                        workflowName: schema.name,
+                        fieldCount: Object.keys(schema.fields).length,
+                        fieldKeys: Object.keys(schema.fields).slice(0, 10), // First 10 keys
+                    });
+                }
+                else {
+                    this.logger.warn("No schema text returned from get_workflow_schema", {
+                        workflowId: schema.workflowId,
+                    });
+                }
+            }
+            else {
+                this.logger.warn("No phase ID found - skipping field schema load", {
+                    workflowId: schema.workflowId,
+                    workflowName: schema.name,
+                });
+            }
+        }
+        catch (error) {
+            this.logger.warn("Failed to load workflow schema details", {
+                workflowId: schema.workflowId,
+                workflowName: schema.name,
+                error: error instanceof Error ? error.message : String(error),
+            });
+        }
+    }
+    /**
+     * Parse phases from list_workflow_phases response
+     * Format: 1. **PhaseName**\n   - Phase ID: `phaseId`
+     */
+    parsePhases(text, schema) {
+        this.logger.debug("Parsing phases text", {
+            workflowId: schema.workflowId,
+            textLength: text.length,
+            textPreview: text.substring(0, 500),
+        });
+        try {
+            const parsed = JSON.parse(text);
+            const phases = parsed.phases || parsed.data || parsed;
+            if (Array.isArray(phases)) {
+                for (const phase of phases) {
+                    if (phase.id && phase.name) {
+                        schema.phases[phase.name.toLowerCase()] = phase.id;
+                    }
+                    else if (phase._id && phase.name) {
+                        schema.phases[phase.name.toLowerCase()] = phase._id;
+                    }
+                }
+            }
+        }
+        catch {
+            // Markdown format: **PhaseName**\n   - Phase ID: `phaseId`
+            // Match pattern: \d+\. **Name** ... Phase ID: `id`
+            const phaseBlocks = text.split(/\d+\.\s*\*\*/).filter(Boolean);
+            for (const block of phaseBlocks) {
+                const nameMatch = block.match(/^([^*]+)\*\*/);
+                const phaseIdMatch = block.match(/Phase ID:\s*`([a-f0-9]{24})`/i);
+                if (nameMatch && phaseIdMatch) {
+                    const phaseName = nameMatch[1].trim();
+                    const phaseId = phaseIdMatch[1];
+                    schema.phases[phaseName.toLowerCase()] = phaseId;
+                }
+            }
+        }
+    }
+    /**
+     * Parse fields from get_workflow_schema response
+     * Stores fields by both label and key for flexible lookup
+     */
+    parseFields(text, schema) {
+        try {
+            const parsed = JSON.parse(text);
+            const fields = parsed.fields || parsed.data || parsed;
+            if (Array.isArray(fields)) {
+                for (const field of fields) {
+                    const fieldId = field.id || field._id || field.fieldId;
+                    const label = field.label || field.name;
+                    const key = field.key;
+                    if (fieldId && label) {
+                        schema.fields[label] = fieldId;
+                    }
+                    // Also store by key for direct lookup (e.g., "firstName" -> fieldId)
+                    if (fieldId && key) {
+                        schema.fields[key] = fieldId;
+                    }
+                }
+            }
+            else if (typeof fields === "object") {
+                // Handle object format {fieldId: {label, type, key, ...}}
+                for (const [fieldId, fieldData] of Object.entries(fields)) {
+                    const data = fieldData;
+                    const label = data.label || data.name;
+                    const key = data.key;
+                    if (label) {
+                        schema.fields[label] = fieldId;
+                    }
+                    // Also store by key
+                    if (key) {
+                        schema.fields[key] = fieldId;
+                    }
+                }
+            }
+        }
+        catch {
+            // Regex fallback for markdown format:
+            // **Label**
+            //    - Field ID: `fieldId`
+            //    - Key: `key`
+            const fieldBlocks = text.split(/\d+\.\s*\*\*/).filter(Boolean);
+            for (const block of fieldBlocks) {
+                const labelMatch = block.match(/^([^*\n]+)\*\*/);
+                const fieldIdMatch = block.match(/Field ID:\s*`([a-f0-9]{24})`/i);
+                const keyMatch = block.match(/Key:\s*`(\w+)`/i);
+                if (fieldIdMatch) {
+                    const fieldId = fieldIdMatch[1];
+                    if (labelMatch) {
+                        schema.fields[labelMatch[1].trim()] = fieldId;
+                    }
+                    if (keyMatch) {
+                        schema.fields[keyMatch[1]] = fieldId;
+                    }
+                }
+            }
+        }
+    }
+    /**
+     * Clear cache for a workspace (memory cache only)
+     */
+    clearCache(workspaceId) {
+        if (workspaceId) {
+            this.cache.delete(workspaceId);
+            this.logger.debug("Cleared memory cache", { workspaceId });
+        }
+        else {
+            this.cache.clear();
+            this.logger.debug("Cleared all memory caches");
+        }
+    }
+}
+exports.WorkspaceSchemaCacheService = WorkspaceSchemaCacheService;
+//# sourceMappingURL=workspace-schema-cache.js.map

package/dist/bot/tool-executor.d.ts

@@ -0,0 +1,28 @@
+/**
+ * ToolExecutor - Thin wrapper around ToolRegistry for direct tool execution.
+ *
+ * Replaces the old McpClientService which did HTTP POST to localhost:3030.
+ * This calls ToolRegistry.executeTool() directly - no HTTP, no JSON-RPC.
+ */
+import { ToolRegistry, ToolGroup, ToolDefinition } from '../mcp/tool-registry';
+import { UserContext } from '../mcp/UserContextCache';
+export declare class ToolExecutor {
+    private toolRegistry;
+    constructor(toolRegistry: ToolRegistry);
+    /**
+     * Execute a tool by name with the given arguments and user context.
+     */
+    execute(toolName: string, args: Record<string, unknown>, userContext: UserContext): Promise<any>;
+    /**
+     * Get tool definitions, optionally filtered by group or tool name whitelist.
+     */
+    getToolDefinitions(filter?: {
+        allowedGroups?: ToolGroup[];
+        allowedTools?: string[];
+    }): ToolDefinition[];
+    /**
+     * Get total number of registered tools.
+     */
+    getToolCount(): number;
+}
+//# sourceMappingURL=tool-executor.d.ts.map

package/dist/bot/tool-executor.js

@@ -0,0 +1,48 @@
+"use strict";
+/**
+ * ToolExecutor - Thin wrapper around ToolRegistry for direct tool execution.
+ *
+ * Replaces the old McpClientService which did HTTP POST to localhost:3030.
+ * This calls ToolRegistry.executeTool() directly - no HTTP, no JSON-RPC.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ToolExecutor = void 0;
+const logger_1 = require("../lib/logger");
+const logger = (0, logger_1.createLogger)({ component: 'tool-executor' });
+class ToolExecutor {
+    toolRegistry;
+    constructor(toolRegistry) {
+        this.toolRegistry = toolRegistry;
+    }
+    /**
+     * Execute a tool by name with the given arguments and user context.
+     */
+    async execute(toolName, args, userContext) {
+        logger.debug('Executing tool', { toolName });
+        try {
+            const result = await this.toolRegistry.executeTool(toolName, args, userContext);
+            return result;
+        }
+        catch (error) {
+            logger.error('Tool execution failed', {
+                toolName,
+                error: error instanceof Error ? error.message : String(error),
+            });
+            throw error;
+        }
+    }
+    /**
+     * Get tool definitions, optionally filtered by group or tool name whitelist.
+     */
+    getToolDefinitions(filter) {
+        return this.toolRegistry.getToolDefinitions(filter);
+    }
+    /**
+     * Get total number of registered tools.
+     */
+    getToolCount() {
+        return this.toolRegistry.getToolCount();
+    }
+}
+exports.ToolExecutor = ToolExecutor;
+//# sourceMappingURL=tool-executor.js.map

package/dist/bot/workspace-overview.d.ts

@@ -0,0 +1,12 @@
+import type { HailerV2CoreInitResponse } from '../mcp/utils/index';
+/**
+ * Generates a compact XML workspace overview for the bot's system prompt.
+ * Tiered approach - includes just enough for the LLM to know what exists:
+ * - Workflow names, IDs, activity counts, phases
+ * - NO field details (LLM uses get_workflow_schema tool on-demand)
+ * - User count only (LLM uses search_workspace_users tool on-demand)
+ * - Team names and IDs
+ * This keeps the system prompt small regardless of workspace size.
+ */
+export declare function generateWorkspaceOverview(init: HailerV2CoreInitResponse): string;
+//# sourceMappingURL=workspace-overview.d.ts.map

package/dist/bot/workspace-overview.js

@@ -0,0 +1,94 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateWorkspaceOverview = generateWorkspaceOverview;
+/**
+ * Escapes XML special characters in a string.
+ */
+function escapeXml(str) {
+    return str
+        .replace(/&/g, '&')
+        .replace(/</g, '&lt;')
+        .replace(/>/g, '&gt;')
+        .replace(/"/g, '&quot;')
+        .replace(/'/g, '&apos;');
+}
+/**
+ * Builds an XML attribute string from key-value pairs, escaping values.
+ */
+function attrs(pairs) {
+    return Object.entries(pairs)
+        .map(([k, v]) => `${k}="${escapeXml(String(v))}"`)
+        .join(' ');
+}
+/**
+ * Generates a compact XML workspace overview for the bot's system prompt.
+ * Tiered approach - includes just enough for the LLM to know what exists:
+ * - Workflow names, IDs, activity counts, phases
+ * - NO field details (LLM uses get_workflow_schema tool on-demand)
+ * - User count only (LLM uses search_workspace_users tool on-demand)
+ * - Team names and IDs
+ * This keeps the system prompt small regardless of workspace size.
+ */
+function generateWorkspaceOverview(init) {
+    const lines = [];
+    // Resolve workspace name and ID
+    const network = init.network;
+    const networks = (init.networks || {});
+    const wsId = network?._id || Object.keys(networks)[0] || 'unknown';
+    const wsName = network?.name || networks[wsId]?.name || 'Workspace';
+    const userCount = Object.keys(init.users || {}).length;
+    lines.push(`<workspace ${attrs({ name: wsName, id: wsId, users: userCount })}>`);
+    // Workflows - names, IDs, activity counts, and phases only (no fields)
+    const processes = init.processes || [];
+    if (processes.length > 0) {
+        lines.push('  <workflows>');
+        for (const proc of processes) {
+            const activityCount = proc.createdActivities ?? 0;
+            const fieldCount = proc.fieldsOrder?.length || Object.keys(proc.fields || {}).length;
+            lines.push(`    <workflow ${attrs({ name: proc.name, id: proc._id, activities: activityCount, fields: fieldCount })}>`);
+            // Phases (compact - always useful for the LLM to know)
+            const phases = proc.phases || {};
+            const phaseOrder = proc.phasesOrder || Object.keys(phases);
+            if (phaseOrder.length > 0) {
+                lines.push('      <phases>');
+                for (const phaseId of phaseOrder) {
+                    const phase = phases[phaseId];
+                    if (!phase)
+                        continue;
+                    lines.push(`        <phase ${attrs({ name: phase.name, id: phaseId })}/>`);
+                }
+                lines.push('      </phases>');
+            }
+            lines.push('    </workflow>');
+        }
+        lines.push('  </workflows>');
+    }
+    // Teams (compact - just names and IDs)
+    const teams = init.teams;
+    if (teams) {
+        const teamEntries = Array.isArray(teams)
+            ? teams
+            : Object.values(teams);
+        if (teamEntries.length > 0) {
+            lines.push('  <teams>');
+            for (const team of teamEntries) {
+                if (!team || !team.name)
+                    continue;
+                const teamAttrs = {
+                    name: team.name,
+                    id: team._id || 'unknown',
+                };
+                if (Array.isArray(team.members)) {
+                    teamAttrs.memberCount = team.members.length;
+                }
+                lines.push(`    <team ${attrs(teamAttrs)}/>`);
+            }
+            lines.push('  </teams>');
+        }
+    }
+    // No individual users listed - LLM uses search_workspace_users tool
+    // No field details listed - LLM uses get_workflow_schema tool
+    lines.push('</workspace>');
+    return lines.join('\n');
+}
+//# sourceMappingURL=workspace-overview.js.map