crewx 0.1.0 → 0.1.2

package/dist/utils/stdin-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stdin-utils.js","sourceRoot":"","sources":["../../src/utils/stdin-utils.ts"],"names":[],"mappings":"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"}

package/dist/utils/string-utils.d.ts

@@ -0,0 +1 @@
+export declare function capitalizeFirstLetter(str: string): string;

package/dist/utils/string-utils.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.capitalizeFirstLetter = capitalizeFirstLetter;
+function capitalizeFirstLetter(str) {
+    if (!str || str.length === 0) {
+        return str;
+    }
+    return str.charAt(0).toUpperCase() + str.slice(1);
+}
+//# sourceMappingURL=string-utils.js.map

package/dist/utils/string-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"string-utils.js","sourceRoot":"","sources":["../../src/utils/string-utils.ts"],"names":[],"mappings":";;AAIA,sDAKC;AALD,SAAgB,qBAAqB,CAAC,GAAW;IAC/C,IAAI,CAAC,GAAG,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC7B,OAAO,GAAG,CAAC;IACb,CAAC;IACD,OAAO,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AACpD,CAAC"}

package/dist/utils/template-processor.d.ts

@@ -0,0 +1,32 @@
+import { DocumentLoaderService } from '../services/document-loader.service';
+export interface TemplateContext {
+    env?: Record<string, string | undefined>;
+    options?: string[];
+    agent?: {
+        id: string;
+        name: string;
+        provider: string;
+        model?: string;
+        workingDirectory?: string;
+    };
+    mode?: 'query' | 'execute';
+    messages?: Array<{
+        text: string;
+        isAssistant: boolean;
+        metadata?: Record<string, any>;
+    }>;
+    platform?: 'slack' | 'cli';
+    tools?: {
+        list: Array<{
+            name: string;
+            description: string;
+            input_schema: any;
+            output_schema?: any;
+        }>;
+        json: string;
+        count: number;
+    };
+    vars?: Record<string, any>;
+}
+export declare function processDocumentTemplate(template: string, documentLoader: DocumentLoaderService, additionalContext?: TemplateContext): Promise<string>;
+export declare function hasDocumentReferences(template: string): boolean;

package/dist/utils/template-processor.js

@@ -0,0 +1,188 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.processDocumentTemplate = processDocumentTemplate;
+exports.hasDocumentReferences = hasDocumentReferences;
+const Handlebars = __importStar(require("handlebars"));
+async function processDocumentTemplate(template, documentLoader, additionalContext) {
+    if (!documentLoader.isInitialized()) {
+        if (!additionalContext) {
+            return template;
+        }
+    }
+    const context = {
+        documents: {},
+        env: additionalContext?.env || process.env,
+        options: additionalContext?.options || [],
+        agent: additionalContext?.agent || {},
+        mode: additionalContext?.mode,
+        messages: additionalContext?.messages || [],
+        platform: additionalContext?.platform,
+        tools: additionalContext?.tools,
+        vars: additionalContext?.vars || {},
+    };
+    registerHandlebarsHelpers();
+    const pattern = /{{{documents\.([^.}]+)\.([^}]+)}}}/g;
+    const matches = [...template.matchAll(pattern)];
+    if (matches.length > 0 && documentLoader.isInitialized()) {
+        const docNames = Array.from(new Set(matches.map(m => m[1]).filter((name) => !!name)));
+        for (const docName of docNames) {
+            let content = await documentLoader.getDocumentContent(docName);
+            const toc = await documentLoader.getDocumentToc(docName);
+            const summary = await documentLoader.getDocumentSummary(docName);
+            if (content) {
+                try {
+                    const docTemplate = Handlebars.compile(content, { noEscape: true });
+                    content = docTemplate(context);
+                }
+                catch (error) {
+                }
+            }
+            context.documents[docName] = {
+                content: content || '',
+                toc: toc || '',
+                summary: summary || '',
+            };
+        }
+    }
+    const compiledTemplate = Handlebars.compile(template, { noEscape: true });
+    return compiledTemplate(context);
+}
+function registerHandlebarsHelpers() {
+    if (Handlebars.helpers['eq']) {
+        return;
+    }
+    Handlebars.registerHelper('eq', function (a, b) {
+        return a === b;
+    });
+    Handlebars.registerHelper('ne', function (a, b) {
+        return a !== b;
+    });
+    Handlebars.registerHelper('contains', function (array, value) {
+        return Array.isArray(array) && array.includes(value);
+    });
+    Handlebars.registerHelper('and', function (a, b) {
+        return a && b;
+    });
+    Handlebars.registerHelper('or', function (a, b) {
+        return a || b;
+    });
+    Handlebars.registerHelper('not', function (a) {
+        return !a;
+    });
+    Handlebars.registerHelper('json', function (context) {
+        return JSON.stringify(context, null, 2);
+    });
+    Handlebars.registerHelper('truncate', function (text, maxLength) {
+        if (!text)
+            return '';
+        if (text.length <= maxLength)
+            return text;
+        const remaining = text.length - maxLength;
+        return `${text.substring(0, maxLength)} (...+${remaining} chars)`;
+    });
+    Handlebars.registerHelper('length', function (array) {
+        if (Array.isArray(array))
+            return array.length;
+        if (typeof array === 'string')
+            return array.length;
+        return 0;
+    });
+    Handlebars.registerHelper('formatConversation', function (messages, platform, options) {
+        const { Logger: NestLogger } = require('@nestjs/common');
+        const helperLogger = new NestLogger('FormatConversation');
+        const isBlockHelper = options && typeof options.fn === 'function';
+        helperLogger.log(`🔧 formatConversation helper called! Mode: ${isBlockHelper ? 'CUSTOM' : 'DEFAULT'}`);
+        helperLogger.log(`Messages type: ${typeof messages}, Is array: ${Array.isArray(messages)}, Length: ${messages?.length || 0}`);
+        helperLogger.log(`Platform: ${platform}`);
+        if (!messages || messages.length === 0) {
+            helperLogger.warn(`⚠️ formatConversation: messages empty or undefined, returning empty string`);
+            return '';
+        }
+        let content;
+        if (isBlockHelper) {
+            helperLogger.log(`📝 Using CUSTOM user template from block`);
+            content = options.fn({
+                messages,
+                platform,
+                messagesCount: messages.length
+            });
+            helperLogger.debug(`📤 Custom template rendered output length: ${content.length} characters`);
+        }
+        else {
+            helperLogger.log(`📦 Using DEFAULT template from .crewx/templates`);
+            const fs = require('fs');
+            const path = require('path');
+            const templatePath = path.join(process.cwd(), '.crewx', 'templates', 'conversation-history-default.hbs');
+            let templateContent;
+            let templateSource = 'inline-fallback';
+            try {
+                templateContent = fs.readFileSync(templatePath, 'utf8');
+                templateSource = templatePath;
+                helperLogger.debug(`✅ Loaded conversation template from: ${templatePath}`);
+                helperLogger.debug(`📏 Template content length: ${templateContent.length} characters`);
+                helperLogger.debug(`📊 Messages count: ${messages.length}, Platform: ${platform}`);
+                helperLogger.debug(`📝 First message sample: ${JSON.stringify(messages[0], null, 2)}`);
+            }
+            catch (error) {
+                helperLogger.warn(`⚠️ Failed to load template from ${templatePath}, using inline fallback`);
+                helperLogger.warn(`Error: ${error instanceof Error ? error.message : String(error)}`);
+                templateContent = `{{#if messages}}Previous conversation ({{messagesCount}} messages):
+{{#each messages}}
+{{#if isAssistant}}
+**Assistant{{#if metadata.agent_id}} (@{{metadata.agent_id}}){{/if}}**
+{{else}}
+**{{#if metadata.slack}}{{#with metadata.slack}}{{#if user_profile.display_name}}{{user_profile.display_name}}{{else if username}}{{username}}{{else if user_id}}User ({{user_id}}){{else}}User{{/if}}{{/with}}{{else}}User{{/if}}**
+{{/if}}: {{{text}}}
+{{/each}}{{/if}}`;
+            }
+            const template = Handlebars.compile(templateContent, { noEscape: true });
+            content = template({
+                messages,
+                platform,
+                messagesCount: messages.length
+            });
+            helperLogger.debug(`📤 Default template rendered output length: ${content.length} characters`);
+            helperLogger.debug(`📍 Template source: ${templateSource}`);
+        }
+        const result = `${content}`;
+        helperLogger.debug(`📄 Final output (with tags):\n${result}`);
+        return result;
+    });
+}
+function hasDocumentReferences(template) {
+    return /{{{documents\.[^}]+}}}/g.test(template);
+}
+//# sourceMappingURL=template-processor.js.map

package/dist/utils/template-processor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"template-processor.js","sourceRoot":"","sources":["../../src/utils/template-processor.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA0EA,0DAsEC;AAgKD,sDAEC;AAxSD,uDAAyC;AAgElC,KAAK,UAAU,uBAAuB,CAC3C,QAAgB,EAChB,cAAqC,EACrC,iBAAmC;IAEnC,IAAI,CAAC,cAAc,CAAC,aAAa,EAAE,EAAE,CAAC;QAEpC,IAAI,CAAC,iBAAiB,EAAE,CAAC;YACvB,OAAO,QAAQ,CAAC;QAClB,CAAC;IACH,CAAC;IAGD,MAAM,OAAO,GAAQ;QACnB,SAAS,EAAE,EAAE;QACb,GAAG,EAAE,iBAAiB,EAAE,GAAG,IAAI,OAAO,CAAC,GAAG;QAC1C,OAAO,EAAE,iBAAiB,EAAE,OAAO,IAAI,EAAE;QACzC,KAAK,EAAE,iBAAiB,EAAE,KAAK,IAAI,EAAE;QACrC,IAAI,EAAE,iBAAiB,EAAE,IAAI;QAC7B,QAAQ,EAAE,iBAAiB,EAAE,QAAQ,IAAI,EAAE;QAC3C,QAAQ,EAAE,iBAAiB,EAAE,QAAQ;QACrC,KAAK,EAAE,iBAAiB,EAAE,KAAK;QAC/B,IAAI,EAAE,iBAAiB,EAAE,IAAI,IAAI,EAAE;KACpC,CAAC;IAGF,yBAAyB,EAAE,CAAC;IAI5B,MAAM,OAAO,GAAG,qCAAqC,CAAC;IACtD,MAAM,OAAO,GAAG,CAAC,GAAG,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;IAEhD,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,cAAc,CAAC,aAAa,EAAE,EAAE,CAAC;QAEzD,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAkB,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAGtG,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;YAC/B,IAAI,OAAO,GAAG,MAAM,cAAc,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAC;YAC/D,MAAM,GAAG,GAAG,MAAM,cAAc,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;YACzD,MAAM,OAAO,GAAG,MAAM,cAAc,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAC;YAIjE,IAAI,OAAO,EAAE,CAAC;gBACZ,IAAI,CAAC;oBACH,MAAM,WAAW,GAAG,UAAU,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;oBACpE,OAAO,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC;gBACjC,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;gBAIjB,CAAC;YACH,CAAC;YAKD,OAAO,CAAC,SAAS,CAAC,OAAO,CAAC,GAAG;gBAC3B,OAAO,EAAE,OAAO,IAAI,EAAE;gBACtB,GAAG,EAAE,GAAG,IAAI,EAAE;gBACd,OAAO,EAAE,OAAO,IAAI,EAAE;aACvB,CAAC;QACJ,CAAC;IACH,CAAC;IAGD,MAAM,gBAAgB,GAAG,UAAU,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1E,OAAO,gBAAgB,CAAC,OAAO,CAAC,CAAC;AACnC,CAAC;AAKD,SAAS,yBAAyB;IAEhC,IAAI,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QAC7B,OAAO;IACT,CAAC;IAGD,UAAU,CAAC,cAAc,CAAC,IAAI,EAAE,UAAS,CAAM,EAAE,CAAM;QACrD,OAAO,CAAC,KAAK,CAAC,CAAC;IACjB,CAAC,CAAC,CAAC;IAGH,UAAU,CAAC,cAAc,CAAC,IAAI,EAAE,UAAS,CAAM,EAAE,CAAM;QACrD,OAAO,CAAC,KAAK,CAAC,CAAC;IACjB,CAAC,CAAC,CAAC;IAGH,UAAU,CAAC,cAAc,CAAC,UAAU,EAAE,UAAS,KAAY,EAAE,KAAU;QACrE,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IACvD,CAAC,CAAC,CAAC;IAGH,UAAU,CAAC,cAAc,CAAC,KAAK,EAAE,UAAS,CAAM,EAAE,CAAM;QACtD,OAAO,CAAC,IAAI,CAAC,CAAC;IAChB,CAAC,CAAC,CAAC;IAGH,UAAU,CAAC,cAAc,CAAC,IAAI,EAAE,UAAS,CAAM,EAAE,CAAM;QACrD,OAAO,CAAC,IAAI,CAAC,CAAC;IAChB,CAAC,CAAC,CAAC;IAGH,UAAU,CAAC,cAAc,CAAC,KAAK,EAAE,UAAS,CAAM;QAC9C,OAAO,CAAC,CAAC,CAAC;IACZ,CAAC,CAAC,CAAC;IAGH,UAAU,CAAC,cAAc,CAAC,MAAM,EAAE,UAAS,OAAY;QACrD,OAAO,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IAC1C,CAAC,CAAC,CAAC;IAGH,UAAU,CAAC,cAAc,CAAC,UAAU,EAAE,UAAS,IAAY,EAAE,SAAiB;QAC5E,IAAI,CAAC,IAAI;YAAE,OAAO,EAAE,CAAC;QACrB,IAAI,IAAI,CAAC,MAAM,IAAI,SAAS;YAAE,OAAO,IAAI,CAAC;QAC1C,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,GAAG,SAAS,CAAC;QAC1C,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,SAAS,CAAC,SAAS,SAAS,SAAS,CAAC;IACpE,CAAC,CAAC,CAAC;IAGH,UAAU,CAAC,cAAc,CAAC,QAAQ,EAAE,UAAS,KAAU;QACrD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;YAAE,OAAO,KAAK,CAAC,MAAM,CAAC;QAC9C,IAAI,OAAO,KAAK,KAAK,QAAQ;YAAE,OAAO,KAAK,CAAC,MAAM,CAAC;QACnD,OAAO,CAAC,CAAC;IACX,CAAC,CAAC,CAAC;IAgBH,UAAU,CAAC,cAAc,CAAC,oBAAoB,EAAE,UAAS,QAAa,EAAE,QAAa,EAAE,OAAa;QAElG,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;QACzD,MAAM,YAAY,GAAG,IAAI,UAAU,CAAC,oBAAoB,CAAC,CAAC;QAG1D,MAAM,aAAa,GAAG,OAAO,IAAI,OAAO,OAAO,CAAC,EAAE,KAAK,UAAU,CAAC;QAGlE,YAAY,CAAC,GAAG,CAAC,8CAA8C,aAAa,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC;QACvG,YAAY,CAAC,GAAG,CAAC,kBAAkB,OAAO,QAAQ,eAAe,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,aAAa,QAAQ,EAAE,MAAM,IAAI,CAAC,EAAE,CAAC,CAAC;QAC9H,YAAY,CAAC,GAAG,CAAC,aAAa,QAAQ,EAAE,CAAC,CAAC;QAE1C,IAAI,CAAC,QAAQ,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvC,YAAY,CAAC,IAAI,CAAC,4EAA4E,CAAC,CAAC;YAChG,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,IAAI,OAAe,CAAC;QAEpB,IAAI,aAAa,EAAE,CAAC;YAElB,YAAY,CAAC,GAAG,CAAC,0CAA0C,CAAC,CAAC;YAC7D,OAAO,GAAG,OAAO,CAAC,EAAE,CAAC;gBACnB,QAAQ;gBACR,QAAQ;gBACR,aAAa,EAAE,QAAQ,CAAC,MAAM;aAC/B,CAAC,CAAC;YACH,YAAY,CAAC,KAAK,CAAC,8CAA8C,OAAO,CAAC,MAAM,aAAa,CAAC,CAAC;QAChG,CAAC;aAAM,CAAC;YAEN,YAAY,CAAC,GAAG,CAAC,iDAAiD,CAAC,CAAC;YAEpE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;YACzB,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;YAE7B,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,QAAQ,EAAE,WAAW,EAAE,kCAAkC,CAAC,CAAC;YAEzG,IAAI,eAAuB,CAAC;YAC5B,IAAI,cAAc,GAAG,iBAAiB,CAAC;YACvC,IAAI,CAAC;gBACH,eAAe,GAAG,EAAE,CAAC,YAAY,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;gBACxD,cAAc,GAAG,YAAY,CAAC;gBAC9B,YAAY,CAAC,KAAK,CAAC,wCAAwC,YAAY,EAAE,CAAC,CAAC;gBAC3E,YAAY,CAAC,KAAK,CAAC,+BAA+B,eAAe,CAAC,MAAM,aAAa,CAAC,CAAC;gBACvF,YAAY,CAAC,KAAK,CAAC,sBAAsB,QAAQ,CAAC,MAAM,eAAe,QAAQ,EAAE,CAAC,CAAC;gBACnF,YAAY,CAAC,KAAK,CAAC,4BAA4B,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;YACzF,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,YAAY,CAAC,IAAI,CAAC,mCAAmC,YAAY,yBAAyB,CAAC,CAAC;gBAC5F,YAAY,CAAC,IAAI,CAAC,UAAU,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;gBAEtF,eAAe,GAAG;;;;;;;iBAOT,CAAC;YACZ,CAAC;YAID,MAAM,QAAQ,GAAG,UAAU,CAAC,OAAO,CAAC,eAAe,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;YACzE,OAAO,GAAG,QAAQ,CAAC;gBACjB,QAAQ;gBACR,QAAQ;gBACR,aAAa,EAAE,QAAQ,CAAC,MAAM;aAC/B,CAAC,CAAC;YAEH,YAAY,CAAC,KAAK,CAAC,+CAA+C,OAAO,CAAC,MAAM,aAAa,CAAC,CAAC;YAC/F,YAAY,CAAC,KAAK,CAAC,uBAAuB,cAAc,EAAE,CAAC,CAAC;QAC9D,CAAC;QAGD,MAAM,MAAM,GAAG,GAAG,OAAO,EAAE,CAAC;QAE5B,YAAY,CAAC,KAAK,CAAC,iCAAiC,MAAM,EAAE,CAAC,CAAC;QAC9D,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC,CAAC;AACL,CAAC;AAKD,SAAgB,qBAAqB,CAAC,QAAgB;IACpD,OAAO,yBAAyB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;AAClD,CAAC"}

package/docs/agent-configuration.md

@@ -0,0 +1,373 @@
+# Agent Configuration Guide
+
+Complete guide for configuring custom specialist agents in CrewX.
+
+## Quick Start
+
+Create a `crewx.yaml` file in your project:
+
+```yaml
+agents:
+  - id: "frontend_dev"
+    name: "React Expert"
+    provider: "claude"
+    working_directory: "./src"
+    inline:
+      type: "agent"
+      system_prompt: |
+        You are a senior React developer.
+        Provide detailed examples and best practices.
+```
+
+> **Note:** While `agents.yaml` is still supported for backward compatibility, `crewx.yaml` is the preferred filename. If both files exist, `crewx.yaml` takes priority.
+
+## Agent Configuration Structure
+
+```yaml
+agents:
+  - id: "agent_id"                    # Required: Unique identifier
+    name: "Human Readable Name"       # Optional: Display name
+    provider: "claude"                # Required: AI provider (string or array)
+    working_directory: "/path/to/dir" # Optional: Working directory
+    options:                          # Optional: CLI options
+      query:                          # Options for query mode
+        - "--add-dir=."
+      execute:                        # Options for execute mode
+        - "--add-dir=."
+        - "--allowedTools=Edit,Bash"
+    inline:                           # Required: Agent definition
+      type: "agent"                   # Required: Type
+      model: "opus"                   # Optional: Specific model
+      system_prompt: |                # Required: Instructions
+        Your agent's system prompt
+```
+
+## Provider Configuration
+
+### Single Provider (Fixed)
+
+Use a single string to fix the provider:
+
+```yaml
+agents:
+  - id: "claude_only"
+    provider: "claude"  # Always uses Claude, no fallback
+```
+
+### Multiple Providers (Fallback)
+
+Use an array for automatic fallback:
+
+```yaml
+agents:
+  - id: "flexible_agent"
+    provider: ["claude", "gemini", "copilot"]  # Tries in order
+```
+
+**Behavior:**
+- Tries providers in order until one is available
+- If model is specified, uses first provider without fallback
+
+### Provider-Specific Options
+
+Configure different options for each provider:
+
+```yaml
+agents:
+  - id: "multi_provider"
+    provider: ["claude", "gemini", "copilot"]
+    options:
+      execute:
+        claude:
+          - "--permission-mode=acceptEdits"
+          - "--add-dir=."
+        gemini:
+          - "--include-directories=."
+        copilot:
+          - "--add-dir=."
+```
+
+## Mode-Specific Options
+
+### Query Mode vs Execute Mode
+
+**Query Mode** (read-only):
+```yaml
+options:
+  query:
+    - "--add-dir=."
+    - "--verbose"
+    # No file modification tools
+```
+
+**Execute Mode** (file operations):
+```yaml
+options:
+  execute:
+    - "--add-dir=."
+    - "--allowedTools=Edit,Bash"
+    # Can create/modify files
+```
+
+## Model Selection
+
+Specify AI models in configuration or at runtime:
+
+### In Configuration
+```yaml
+agents:
+  - id: "opus_agent"
+    provider: "claude"
+    inline:
+      model: "opus"  # Fixed model
+      system_prompt: "You are an expert."
+```
+
+### At Runtime
+```bash
+# Override model with @agent:model syntax
+crewx query "@claude:haiku quick analysis"
+crewx execute "@gemini:gemini-2.5-flash rapid prototyping"
+```
+
+**Available Models:**
+
+**Claude:**
+- `opus` - Most capable, detailed
+- `sonnet` - Balanced performance
+- `haiku` - Fast, concise
+- `claude-sonnet-4-5`
+- `claude-sonnet-4-5-20250929`
+
+**Gemini:**
+- `gemini-2.5-pro` - High quality (default)
+- `gemini-2.5-flash` - Fast responses
+
+**Copilot:**
+- `gpt-5`
+- `claude-sonnet-4`
+- `claude-sonnet-4.5`
+
+## Working Directory
+
+Set the working directory for each agent:
+
+```yaml
+agents:
+  - id: "frontend_dev"
+    working_directory: "./src/frontend"
+
+  - id: "backend_dev"
+    working_directory: "./src/backend"
+
+  - id: "full_stack"
+    working_directory: "."  # Project root
+```
+
+## Complete Example
+
+```yaml
+agents:
+  # Frontend specialist
+  - id: "frontend_developer"
+    name: "React Expert"
+    provider: "claude"
+    working_directory: "./src/frontend"
+    options:
+      query:
+        - "--add-dir=."
+        - "--verbose"
+      execute:
+        - "--add-dir=."
+        - "--allowedTools=Edit,Bash"
+    inline:
+      type: "agent"
+      model: "sonnet"
+      system_prompt: |
+        You are a senior frontend developer specializing in React.
+
+        **Expertise:**
+        - React 18+ with TypeScript
+        - State management (Redux, Zustand)
+        - Component design patterns
+        - Performance optimization
+
+        **Guidelines:**
+        - Always use TypeScript strict mode
+        - Prefer functional components with hooks
+        - Write comprehensive PropTypes/TypeScript types
+        - Follow accessibility (a11y) best practices
+
+  # Backend specialist with fallback
+  - id: "backend_developer"
+    name: "Backend Expert"
+    provider: ["gemini", "claude", "copilot"]
+    working_directory: "./src/backend"
+    options:
+      execute:
+        gemini:
+          - "--include-directories=."
+          - "--yolo"
+        claude:
+          - "--add-dir=."
+          - "--allowedTools=Edit,Bash"
+    inline:
+      type: "agent"
+      system_prompt: |
+        You are a backend engineering expert.
+
+        **Expertise:**
+        - RESTful API design
+        - Database optimization
+        - Authentication & authorization
+        - Microservices architecture
+
+        **Focus:**
+        - Security best practices
+        - Scalable architecture
+        - Error handling and logging
+        - API documentation
+
+  # DevOps specialist
+  - id: "devops_engineer"
+    name: "DevOps Expert"
+    provider: "copilot"
+    working_directory: "."
+    options:
+      query:
+        - "--allow-tool=files"
+      execute:
+        - "--allow-tool=terminal"
+        - "--allow-tool=files"
+    inline:
+      type: "agent"
+      system_prompt: |
+        You are a DevOps engineer expert in infrastructure and deployment.
+
+        **Expertise:**
+        - Docker and Kubernetes
+        - CI/CD pipelines
+        - Infrastructure as Code
+        - Monitoring and logging
+
+        **Focus:**
+        - Deployment automation
+        - Container orchestration
+        - Security and compliance
+        - Performance monitoring
+```
+
+## CLI Options Reference
+
+### Common Options
+
+**Claude Code:**
+- `--add-dir=PATH` - Add directory to context
+- `--allowedTools=TOOLS` - Allowed tools (e.g., Edit,Bash)
+- `--permission-mode=MODE` - Permission mode (acceptEdits, etc.)
+- `--verbose` - Verbose output
+
+**Gemini CLI:**
+- `--include-directories=PATH` - Include directories
+- `--yolo` - Auto-execute without confirmation
+- `--allowed-mcp-server-names=NAME` - Allow MCP server
+
+**Copilot CLI:**
+- `--allow-tool=TOOL` - Allow specific tools (files, terminal)
+- `--add-dir=PATH` - Add directory
+
+### Query Mode vs Execute Mode
+
+**Query Mode** (read-only):
+- Safe for analysis and reviews
+- No file modifications
+- Use minimal permissions
+
+**Execute Mode** (file operations):
+- Can create/modify/delete files
+- Requires appropriate tool permissions
+- Use with caution
+
+## Creating Agents via CLI
+
+Use the `@crewx` assistant to create agents:
+
+```bash
+# Create a Python expert
+crewx execute "@crewx Create a Python expert agent. ID 'python_expert', use claude sonnet. Specializes in code review, optimization, and debugging."
+
+# Create a React specialist
+crewx execute "@crewx Create a React specialist agent with TypeScript expertise"
+
+# Create a DevOps agent
+crewx execute "@crewx Create a DevOps agent for Docker and Kubernetes"
+
+# Create a security analyst
+crewx execute "@crewx Create a security analyst agent"
+```
+
+The `@crewx` assistant understands your request and creates a complete agent configuration.
+
+## Best Practices
+
+### 1. Specialize Your Agents
+Create focused agents for specific domains:
+- Frontend, backend, DevOps
+- Testing, security, documentation
+- Language-specific (Python, TypeScript, Go)
+
+### 2. Use Appropriate Models
+- **Haiku/Flash**: Quick answers, simple tasks
+- **Sonnet/Pro**: Balanced, most use cases
+- **Opus**: Complex analysis, detailed work
+
+### 3. Set Working Directories
+Limit agent scope to relevant directories:
+```yaml
+working_directory: "./src/specific-module"
+```
+
+### 4. Configure Mode-Specific Options
+Different options for query vs execute:
+```yaml
+options:
+  query:    # Read-only analysis
+    - "--add-dir=."
+  execute:  # File modifications
+    - "--add-dir=."
+    - "--allowedTools=Edit"
+```
+
+### 5. Use Provider Fallback
+Ensure availability with multiple providers:
+```yaml
+provider: ["claude", "gemini", "copilot"]
+```
+
+### 6. Write Clear System Prompts
+Include:
+- Role and expertise
+- Specific guidelines
+- Expected output format
+- Constraints and limitations
+
+## Validation
+
+Check your configuration:
+
+```bash
+crewx doctor
+```
+
+This validates:
+- YAML syntax
+- Required fields
+- Provider availability
+- Working directory existence
+- Option compatibility
+
+## Advanced Configuration
+
+For advanced features like documents and templates, see:
+- [Template System Guide](templates.md)
+- [Tool System Guide](tools.md)