crewly 1.4.39 → 1.4.41

package/dist/backend/backend/src/services/ai/prompt-modules/communication.module.js

@@ -0,0 +1,145 @@
+/**
+ * Communication module — defines how agents communicate across channels.
+ *
+ * Consolidates message routing (Slack, Chat UI, NOTIFY markers),
+ * reply formatting, notification protocol, and thread-aware messaging
+ * into a single module. Orchestrators get the full communication spec;
+ * workers get a compact report-status-only version.
+ *
+ * Sources: orchestrator prompt.md §Chat & Slack Communication,
+ *          §Notification Protocol, §Markdown Content, §Communication Channels,
+ *          tool-registry reply_slack.
+ */
+export class CommunicationModule {
+    name = 'communication';
+    priority = 8;
+    maxTokens = 2000;
+    compactable = true;
+    /**
+     * Always included — every agent communicates.
+     */
+    shouldInclude(_config) {
+        return true;
+    }
+    /**
+     * Build the communication section.
+     * Orchestrators and TLs get full Slack/Chat/NOTIFY instructions.
+     * Workers get a compact version focused on report-status and send-message.
+     *
+     * @param config - Module configuration with agent details
+     * @returns Formatted markdown communication section
+     */
+    async build(config) {
+        const isOrchestrator = config.role === 'orchestrator';
+        const isTL = config.canDelegate === true;
+        if (isOrchestrator) {
+            return this.buildOrchestratorComms(config);
+        }
+        if (isTL) {
+            return this.buildTLComms(config);
+        }
+        return this.buildWorkerComms(config);
+    }
+    /**
+     * Full orchestrator communication spec — Slack, Chat UI, NOTIFY markers,
+     * thread management, message formatting, and notification protocol.
+     */
+    buildOrchestratorComms(config) {
+        return `## Communication Protocol
+
+### Message Channels
+You have access to multiple communication channels:
+- **Slack** — Primary external channel for user communication
+- **Chat UI** — Web-based chat interface
+- **Google Chat** — Alternative messaging platform
+- **NOTIFY markers** — Internal agent-to-orchestrator signaling
+
+### Message Routing Rules
+1. **User messages** → Reply on the same channel they used (Slack → Slack, Chat → Chat)
+2. **Agent status updates** → Process internally, do not forward to user unless requested
+3. **Error notifications** → Notify user on their active channel
+4. **Task completions** → Summarize and notify user on their active channel
+
+### Slack Communication
+- Use \`reply-slack\` skill to send messages to Slack threads
+- Always reply in the **same thread** the user messaged from
+- Format messages using Slack mrkdwn (not standard Markdown):
+  - Bold: \`*text*\` (not \`**text**\`)
+  - Italic: \`_text_\` (not \`*text*\`)
+  - Code: \`\\\`code\\\`\` (same as Markdown)
+  - Links: \`<url|text>\` (not \`[text](url)\`)
+- Keep messages concise — avoid walls of text in Slack
+
+### Chat UI Communication
+- Use \`reply-chat\` skill for Chat UI responses
+- Standard Markdown formatting is supported
+- Include structured data (tables, code blocks) when helpful
+
+### Notification Protocol
+- **[NOTIFY]** markers signal events that need orchestrator attention
+- Process NOTIFY events by evaluating priority and routing appropriately
+- Never forward raw NOTIFY markers to end users
+
+### Thread Context
+- Maintain thread continuity — always reference the active thread
+- When switching channels, summarize context for the new channel
+- Track channelId and threadTs for Slack thread replies
+
+### Communication Skills
+\`\`\`bash
+bash ${config.agentSkillsPath}/core/report-status/execute.sh '{"sessionName":"${config.sessionName}","status":"<status>","summary":"<summary>","projectPath":"${config.projectPath || config.projectRoot}"}'
+\`\`\`
+\`\`\`bash
+bash ${config.agentSkillsPath}/core/send-message/execute.sh '{"to":"<session>","message":"<msg>"}'
+\`\`\``;
+    }
+    /**
+     * TL communication — delegation-focused messaging plus basic user comms.
+     */
+    buildTLComms(config) {
+        return `## Communication Protocol
+
+### Reporting to Orchestrator
+Use \`report-status\` to keep the orchestrator informed of progress:
+\`\`\`bash
+bash ${config.agentSkillsPath}/core/report-status/execute.sh '{"sessionName":"${config.sessionName}","status":"<status>","summary":"<summary>","projectPath":"${config.projectPath || config.projectRoot}"}'
+\`\`\`
+
+### Messaging Workers
+Use \`send-message\` to communicate with your subordinates:
+\`\`\`bash
+bash ${config.agentSkillsPath}/core/send-message/execute.sh '{"to":"<worker-session>","message":"<task or feedback>"}'
+\`\`\`
+
+### Communication Rules
+1. **Report up** — Keep orchestrator informed of progress and blockers
+2. **Direct workers** — Send clear, actionable messages to subordinates
+3. **Include context** — Always include task ID and acceptance criteria in delegations
+4. **Use [TL_REPORT]** — Tag all reports to orchestrator with \`[TL_REPORT]\`
+5. **Thread continuity** — Reference previous messages when following up`;
+    }
+    /**
+     * Worker communication — compact report-status and send-message only.
+     */
+    buildWorkerComms(config) {
+        return `## Communication
+
+### Reporting Progress
+Use \`report-status\` to update your team leader on task progress:
+\`\`\`bash
+bash ${config.agentSkillsPath}/core/report-status/execute.sh '{"sessionName":"${config.sessionName}","status":"<status>","summary":"<summary>","projectPath":"${config.projectPath || config.projectRoot}"}'
+\`\`\`
+
+### Messaging
+Use \`send-message\` to communicate with other agents:
+\`\`\`bash
+bash ${config.agentSkillsPath}/core/send-message/execute.sh '{"to":"<session>","message":"<msg>"}'
+\`\`\`
+
+### Rules
+- Report progress periodically so your team leader stays informed
+- Report blockers immediately — don't wait
+- Keep messages concise and actionable`;
+    }
+}
+//# sourceMappingURL=communication.module.js.map

package/dist/backend/backend/src/services/ai/prompt-modules/communication.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"communication.module.js","sourceRoot":"","sources":["../../../../../../../backend/src/services/ai/prompt-modules/communication.module.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;GAWG;AACH,MAAM,OAAO,mBAAmB;IAC/B,IAAI,GAAG,eAAe,CAAC;IACvB,QAAQ,GAAG,CAAC,CAAC;IACb,SAAS,GAAG,IAAI,CAAC;IACjB,WAAW,GAAG,IAAI,CAAC;IAEnB;;OAEG;IACH,aAAa,CAAC,OAAqB;QAClC,OAAO,IAAI,CAAC;IACb,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,KAAK,CAAC,MAAoB;QAC/B,MAAM,cAAc,GAAG,MAAM,CAAC,IAAI,KAAK,cAAc,CAAC;QACtD,MAAM,IAAI,GAAG,MAAM,CAAC,WAAW,KAAK,IAAI,CAAC;QAEzC,IAAI,cAAc,EAAE,CAAC;YACpB,OAAO,IAAI,CAAC,sBAAsB,CAAC,MAAM,CAAC,CAAC;QAC5C,CAAC;QACD,IAAI,IAAI,EAAE,CAAC;YACV,OAAO,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;QAClC,CAAC;QACD,OAAO,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC;IACtC,CAAC;IAED;;;OAGG;IACK,sBAAsB,CAAC,MAAoB;QAClD,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA0CF,MAAM,CAAC,eAAe,mDAAmD,MAAM,CAAC,WAAW,8DAA8D,MAAM,CAAC,WAAW,IAAI,MAAM,CAAC,WAAW;;;OAGjM,MAAM,CAAC,eAAe;OACtB,CAAC;IACP,CAAC;IAED;;OAEG;IACK,YAAY,CAAC,MAAoB;QACxC,OAAO;;;;;OAKF,MAAM,CAAC,eAAe,mDAAmD,MAAM,CAAC,WAAW,8DAA8D,MAAM,CAAC,WAAW,IAAI,MAAM,CAAC,WAAW;;;;;;OAMjM,MAAM,CAAC,eAAe;;;;;;;;yEAQ4C,CAAC;IACzE,CAAC;IAED;;OAEG;IACK,gBAAgB,CAAC,MAAoB;QAC5C,OAAO;;;;;OAKF,MAAM,CAAC,eAAe,mDAAmD,MAAM,CAAC,WAAW,8DAA8D,MAAM,CAAC,WAAW,IAAI,MAAM,CAAC,WAAW;;;;;;OAMjM,MAAM,CAAC,eAAe;;;;;;uCAMU,CAAC;IACvC,CAAC;CACD"}

package/dist/backend/backend/src/services/ai/prompt-modules/context-assembly.service.d.ts

@@ -0,0 +1,129 @@
+/**
+ * Configuration for a context loader.
+ */
+export interface ContextLoaderConfig {
+    /** Agent ID (session name) */
+    agentId: string;
+    /** Agent's role */
+    role: string;
+    /** Project path */
+    projectPath?: string;
+    /** Team ID */
+    teamId?: string;
+}
+/**
+ * Result of loading a context module.
+ */
+export interface ContextLoadResult {
+    /** Context module name */
+    name: string;
+    /** Loaded content */
+    content: string;
+    /** Estimated token count */
+    estimatedTokens: number;
+    /** When this context was loaded */
+    loadedAt: Date;
+}
+/**
+ * A context loader function that retrieves dynamic data for a context module.
+ */
+export type ContextLoader = (config: ContextLoaderConfig) => Promise<string>;
+/**
+ * Service that manages runtime context assembly for agents.
+ *
+ * Unlike prompt modules (static, assembled once at startup), context modules
+ * contain dynamic data that can be refreshed mid-session. Context is compactable
+ * by F13 ContextWindowMonitor.
+ *
+ * Responsibilities:
+ * - Registers context loaders for different data sources
+ * - Loads and assembles context on demand
+ * - Supports mid-session refresh without full rebuild
+ * - Enforces context token budgets
+ * - Tracks loaded context for cache/refresh management
+ *
+ * @example
+ * ```typescript
+ * const contextService = new ContextAssemblyService();
+ *
+ * contextService.registerLoader('memory', async (config) => {
+ *   const memoryService = MemoryService.getInstance();
+ *   return memoryService.getFullContext(config.agentId, config.projectPath);
+ * });
+ *
+ * const context = await contextService.loadAll({
+ *   agentId: 'crewly-dev-001',
+ *   role: 'developer',
+ *   projectPath: '/path/to/project',
+ * });
+ * ```
+ */
+export declare class ContextAssemblyService {
+    private logger;
+    private loaders;
+    private cache;
+    private totalTokenBudget;
+    constructor(tokenBudget?: number);
+    /**
+     * Register a context loader for a named context module.
+     *
+     * @param name - Context module name (e.g., 'memory', 'team_context')
+     * @param loader - Async function that loads context data
+     */
+    registerLoader(name: string, loader: ContextLoader): void;
+    /**
+     * Remove a registered context loader.
+     *
+     * @param name - Context module name to remove
+     */
+    removeLoader(name: string): void;
+    /**
+     * Get names of all registered loaders.
+     *
+     * @returns Array of registered loader names
+     */
+    getLoaderNames(): string[];
+    /**
+     * Load a single context module by name.
+     *
+     * @param name - Context module name
+     * @param config - Loader configuration
+     * @param useCache - Whether to return cached result if available (default: false)
+     * @returns Context load result or null if loader not found
+     */
+    load(name: string, config: ContextLoaderConfig, useCache?: boolean): Promise<ContextLoadResult | null>;
+    /**
+     * Load all registered context modules and assemble into a single string.
+     *
+     * @param config - Loader configuration
+     * @returns Assembled context string
+     */
+    loadAll(config: ContextLoaderConfig): Promise<string>;
+    /**
+     * Refresh a specific context module (reload from source).
+     *
+     * @param name - Context module name to refresh
+     * @param config - Loader configuration
+     * @returns Refreshed context or null
+     */
+    refresh(name: string, config: ContextLoaderConfig): Promise<ContextLoadResult | null>;
+    /**
+     * Clear all cached context data.
+     */
+    clearCache(): void;
+    /**
+     * Get cached context by name (without reloading).
+     *
+     * @param name - Context module name
+     * @returns Cached result or null
+     */
+    getCached(name: string): ContextLoadResult | null;
+    /**
+     * Get or set the total token budget.
+     *
+     * @param budget - Optional new budget to set
+     * @returns Current token budget
+     */
+    tokenBudget(budget?: number): number;
+}
+//# sourceMappingURL=context-assembly.service.d.ts.map

package/dist/backend/backend/src/services/ai/prompt-modules/context-assembly.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-assembly.service.d.ts","sourceRoot":"","sources":["../../../../../../../backend/src/services/ai/prompt-modules/context-assembly.service.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,MAAM,WAAW,mBAAmB;IACnC,8BAA8B;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,mBAAmB;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,mBAAmB;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IACjC,0BAA0B;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,qBAAqB;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,4BAA4B;IAC5B,eAAe,EAAE,MAAM,CAAC;IACxB,mCAAmC;IACnC,QAAQ,EAAE,IAAI,CAAC;CACf;AAED;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,MAAM,EAAE,mBAAmB,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;AAO7E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,qBAAa,sBAAsB;IAClC,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,OAAO,CAAyC;IACxD,OAAO,CAAC,KAAK,CAA6C;IAC1D,OAAO,CAAC,gBAAgB,CAAS;gBAErB,WAAW,GAAE,MAA+B;IAKxD;;;;;OAKG;IACH,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,GAAG,IAAI;IAIzD;;;;OAIG;IACH,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAKhC;;;;OAIG;IACH,cAAc,IAAI,MAAM,EAAE;IAI1B;;;;;;;OAOG;IACG,IAAI,CACT,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,mBAAmB,EAC3B,QAAQ,GAAE,OAAe,GACvB,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC;IAoCpC;;;;;OAKG;IACG,OAAO,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,MAAM,CAAC;IAkD3D;;;;;;OAMG;IACG,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC;IAK3F;;OAEG;IACH,UAAU,IAAI,IAAI;IAIlB;;;;;OAKG;IACH,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,GAAG,IAAI;IAIjD;;;;;OAKG;IACH,WAAW,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM;CAMpC"}

package/dist/backend/backend/src/services/ai/prompt-modules/context-assembly.service.js

@@ -0,0 +1,202 @@
+import { LoggerService } from '../../core/logger.service.js';
+import { estimateTokens } from './prompt-module.interface.js';
+/**
+ * Default total token budget for all context modules combined.
+ */
+const DEFAULT_CONTEXT_BUDGET = 15000;
+/**
+ * Service that manages runtime context assembly for agents.
+ *
+ * Unlike prompt modules (static, assembled once at startup), context modules
+ * contain dynamic data that can be refreshed mid-session. Context is compactable
+ * by F13 ContextWindowMonitor.
+ *
+ * Responsibilities:
+ * - Registers context loaders for different data sources
+ * - Loads and assembles context on demand
+ * - Supports mid-session refresh without full rebuild
+ * - Enforces context token budgets
+ * - Tracks loaded context for cache/refresh management
+ *
+ * @example
+ * ```typescript
+ * const contextService = new ContextAssemblyService();
+ *
+ * contextService.registerLoader('memory', async (config) => {
+ *   const memoryService = MemoryService.getInstance();
+ *   return memoryService.getFullContext(config.agentId, config.projectPath);
+ * });
+ *
+ * const context = await contextService.loadAll({
+ *   agentId: 'crewly-dev-001',
+ *   role: 'developer',
+ *   projectPath: '/path/to/project',
+ * });
+ * ```
+ */
+export class ContextAssemblyService {
+    logger;
+    loaders = new Map();
+    cache = new Map();
+    totalTokenBudget;
+    constructor(tokenBudget = DEFAULT_CONTEXT_BUDGET) {
+        this.logger = LoggerService.getInstance().createComponentLogger('ContextAssemblyService');
+        this.totalTokenBudget = tokenBudget;
+    }
+    /**
+     * Register a context loader for a named context module.
+     *
+     * @param name - Context module name (e.g., 'memory', 'team_context')
+     * @param loader - Async function that loads context data
+     */
+    registerLoader(name, loader) {
+        this.loaders.set(name, loader);
+    }
+    /**
+     * Remove a registered context loader.
+     *
+     * @param name - Context module name to remove
+     */
+    removeLoader(name) {
+        this.loaders.delete(name);
+        this.cache.delete(name);
+    }
+    /**
+     * Get names of all registered loaders.
+     *
+     * @returns Array of registered loader names
+     */
+    getLoaderNames() {
+        return Array.from(this.loaders.keys());
+    }
+    /**
+     * Load a single context module by name.
+     *
+     * @param name - Context module name
+     * @param config - Loader configuration
+     * @param useCache - Whether to return cached result if available (default: false)
+     * @returns Context load result or null if loader not found
+     */
+    async load(name, config, useCache = false) {
+        if (useCache && this.cache.has(name)) {
+            return this.cache.get(name) || null;
+        }
+        const loader = this.loaders.get(name);
+        if (!loader) {
+            this.logger.warn(`No context loader registered for '${name}'`);
+            return null;
+        }
+        try {
+            const content = await loader(config);
+            const result = {
+                name,
+                content: content || '',
+                estimatedTokens: estimateTokens(content || ''),
+                loadedAt: new Date(),
+            };
+            this.cache.set(name, result);
+            this.logger.debug(`Context '${name}' loaded`, {
+                agentId: config.agentId,
+                tokens: result.estimatedTokens,
+            });
+            return result;
+        }
+        catch (error) {
+            this.logger.error(`Context loader '${name}' failed`, {
+                agentId: config.agentId,
+                error: error instanceof Error ? error.message : String(error),
+            });
+            return null;
+        }
+    }
+    /**
+     * Load all registered context modules and assemble into a single string.
+     *
+     * @param config - Loader configuration
+     * @returns Assembled context string
+     */
+    async loadAll(config) {
+        const results = [];
+        let totalTokens = 0;
+        for (const [name, loader] of this.loaders.entries()) {
+            try {
+                const content = await loader(config);
+                if (content && content.trim()) {
+                    const tokens = estimateTokens(content);
+                    // Skip if adding this context would exceed budget
+                    if (totalTokens + tokens > this.totalTokenBudget) {
+                        this.logger.info(`Context '${name}' skipped (budget exceeded)`, {
+                            agentId: config.agentId,
+                            currentTokens: totalTokens,
+                            contextTokens: tokens,
+                            budget: this.totalTokenBudget,
+                        });
+                        continue;
+                    }
+                    const result = {
+                        name,
+                        content: content.trim(),
+                        estimatedTokens: tokens,
+                        loadedAt: new Date(),
+                    };
+                    results.push(result);
+                    this.cache.set(name, result);
+                    totalTokens += tokens;
+                }
+            }
+            catch (error) {
+                this.logger.error(`Context loader '${name}' failed`, {
+                    agentId: config.agentId,
+                    error: error instanceof Error ? error.message : String(error),
+                });
+            }
+        }
+        this.logger.info('Context assembly complete', {
+            agentId: config.agentId,
+            loaderCount: results.length,
+            totalTokens,
+            budget: this.totalTokenBudget,
+            modules: results.map((r) => r.name),
+        });
+        return results.map((r) => r.content).join('\n\n---\n\n');
+    }
+    /**
+     * Refresh a specific context module (reload from source).
+     *
+     * @param name - Context module name to refresh
+     * @param config - Loader configuration
+     * @returns Refreshed context or null
+     */
+    async refresh(name, config) {
+        this.cache.delete(name);
+        return this.load(name, config, false);
+    }
+    /**
+     * Clear all cached context data.
+     */
+    clearCache() {
+        this.cache.clear();
+    }
+    /**
+     * Get cached context by name (without reloading).
+     *
+     * @param name - Context module name
+     * @returns Cached result or null
+     */
+    getCached(name) {
+        return this.cache.get(name) || null;
+    }
+    /**
+     * Get or set the total token budget.
+     *
+     * @param budget - Optional new budget to set
+     * @returns Current token budget
+     */
+    tokenBudget(budget) {
+        if (budget !== undefined) {
+            this.totalTokenBudget = budget;
+        }
+        return this.totalTokenBudget;
+    }
+}
+//# sourceMappingURL=context-assembly.service.js.map

package/dist/backend/backend/src/services/ai/prompt-modules/context-assembly.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-assembly.service.js","sourceRoot":"","sources":["../../../../../../../backend/src/services/ai/prompt-modules/context-assembly.service.ts"],"names":[],"mappings":"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"}

package/dist/backend/backend/src/services/ai/prompt-modules/identity.module.d.ts

@@ -0,0 +1,28 @@
+import { PromptModule, ModuleConfig } from './prompt-module.interface.js';
+/**
+ * Identity module — provides the agent's core identification.
+ *
+ * Assembles session name, member ID, role, team, and project path
+ * into a structured identity section. This is the highest-priority
+ * module and is never truncated.
+ *
+ * Sources: Path A Step 2+10, Path B Section 6, Path C header.
+ */
+export declare class IdentityModule implements PromptModule {
+    name: string;
+    priority: number;
+    maxTokens: number;
+    compactable: boolean;
+    /**
+     * Always included — every agent needs an identity.
+     */
+    shouldInclude(_config: ModuleConfig): boolean;
+    /**
+     * Build the identity section with all available fields.
+     *
+     * @param config - Module configuration with agent details
+     * @returns Formatted markdown identity section
+     */
+    build(config: ModuleConfig): Promise<string>;
+}
+//# sourceMappingURL=identity.module.d.ts.map

package/dist/backend/backend/src/services/ai/prompt-modules/identity.module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity.module.d.ts","sourceRoot":"","sources":["../../../../../../../backend/src/services/ai/prompt-modules/identity.module.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAE1E;;;;;;;;GAQG;AACH,qBAAa,cAAe,YAAW,YAAY;IAClD,IAAI,SAAc;IAClB,QAAQ,SAAK;IACb,SAAS,SAAO;IAChB,WAAW,UAAS;IAEpB;;OAEG;IACH,aAAa,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO;IAI7C;;;;;OAKG;IACG,KAAK,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC;CAqBlD"}

package/dist/backend/backend/src/services/ai/prompt-modules/identity.module.js

@@ -0,0 +1,47 @@
+/**
+ * Identity module — provides the agent's core identification.
+ *
+ * Assembles session name, member ID, role, team, and project path
+ * into a structured identity section. This is the highest-priority
+ * module and is never truncated.
+ *
+ * Sources: Path A Step 2+10, Path B Section 6, Path C header.
+ */
+export class IdentityModule {
+    name = 'identity';
+    priority = 1;
+    maxTokens = 150;
+    compactable = false;
+    /**
+     * Always included — every agent needs an identity.
+     */
+    shouldInclude(_config) {
+        return true;
+    }
+    /**
+     * Build the identity section with all available fields.
+     *
+     * @param config - Module configuration with agent details
+     * @returns Formatted markdown identity section
+     */
+    async build(config) {
+        const lines = ['## Your Identity'];
+        if (config.sessionName) {
+            lines.push(`- **Session Name:** ${config.sessionName}`);
+        }
+        if (config.memberId) {
+            lines.push(`- **Member ID:** ${config.memberId}`);
+        }
+        if (config.role) {
+            lines.push(`- **Role:** ${config.role}`);
+        }
+        if (config.teamId) {
+            lines.push(`- **Team:** ${config.teamId}`);
+        }
+        if (config.projectPath) {
+            lines.push(`- **Project Path:** ${config.projectPath}`);
+        }
+        return lines.join('\n');
+    }
+}
+//# sourceMappingURL=identity.module.js.map

package/dist/backend/backend/src/services/ai/prompt-modules/identity.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity.module.js","sourceRoot":"","sources":["../../../../../../../backend/src/services/ai/prompt-modules/identity.module.ts"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AACH,MAAM,OAAO,cAAc;IAC1B,IAAI,GAAG,UAAU,CAAC;IAClB,QAAQ,GAAG,CAAC,CAAC;IACb,SAAS,GAAG,GAAG,CAAC;IAChB,WAAW,GAAG,KAAK,CAAC;IAEpB;;OAEG;IACH,aAAa,CAAC,OAAqB;QAClC,OAAO,IAAI,CAAC;IACb,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,KAAK,CAAC,MAAoB;QAC/B,MAAM,KAAK,GAAa,CAAC,kBAAkB,CAAC,CAAC;QAE7C,IAAI,MAAM,CAAC,WAAW,EAAE,CAAC;YACxB,KAAK,CAAC,IAAI,CAAC,uBAAuB,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC;QACzD,CAAC;QACD,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;YACrB,KAAK,CAAC,IAAI,CAAC,oBAAoB,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC;QACnD,CAAC;QACD,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;YACjB,KAAK,CAAC,IAAI,CAAC,eAAe,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;QAC1C,CAAC;QACD,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;YACnB,KAAK,CAAC,IAAI,CAAC,eAAe,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;QAC5C,CAAC;QACD,IAAI,MAAM,CAAC,WAAW,EAAE,CAAC;YACxB,KAAK,CAAC,IAAI,CAAC,uBAAuB,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC;QACzD,CAAC;QAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACzB,CAAC;CACD"}

package/dist/backend/backend/src/services/ai/prompt-modules/index.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Prompt Modules — Modular prompt assembly system.
+ *
+ * Re-exports all prompt module interfaces, implementations,
+ * and assembly services from a single entry point.
+ */
+export { PromptModule, ModuleConfig, SubordinateInfoCompat, ModuleBuildResult, estimateTokens, } from './prompt-module.interface.js';
+export { IdentityModule } from './identity.module.js';
+export { SoulModule } from './soul.module.js';
+export { SkillsReferenceModule } from './skills-reference.module.js';
+export { MemoryReferenceModule } from './memory-reference.module.js';
+export { TeamReferenceModule } from './team-reference.module.js';
+export { ProjectReferenceModule } from './project-reference.module.js';
+export { UserProfileReferenceModule } from './user-profile-reference.module.js';
+export { LearningReferenceModule } from './learning-reference.module.js';
+export { CommunicationModule } from './communication.module.js';
+export { RecoveryModule } from './recovery.module.js';
+export { LifecycleModule } from './lifecycle.module.js';
+export { createScheduledMessagesLoader, ScheduledCheckInfo, ScheduledChecksProvider, } from './scheduled-messages.loader.js';
+export { PromptAssemblyService } from './prompt-assembly.service.js';
+export { ContextAssemblyService } from './context-assembly.service.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/backend/backend/src/services/ai/prompt-modules/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../backend/src/services/ai/prompt-modules/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EACN,YAAY,EACZ,YAAY,EACZ,qBAAqB,EACrB,iBAAiB,EACjB,cAAc,GACd,MAAM,8BAA8B,CAAC;AAGtC,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AACvE,OAAO,EAAE,0BAA0B,EAAE,MAAM,oCAAoC,CAAC;AAChF,OAAO,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AACzE,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAGxD,OAAO,EACN,6BAA6B,EAC7B,kBAAkB,EAClB,uBAAuB,GACvB,MAAM,gCAAgC,CAAC;AAGxC,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC"}

package/dist/backend/backend/src/services/ai/prompt-modules/index.js

@@ -0,0 +1,26 @@
+/**
+ * Prompt Modules — Modular prompt assembly system.
+ *
+ * Re-exports all prompt module interfaces, implementations,
+ * and assembly services from a single entry point.
+ */
+// Interface and utilities
+export { estimateTokens, } from './prompt-module.interface.js';
+// Prompt modules
+export { IdentityModule } from './identity.module.js';
+export { SoulModule } from './soul.module.js';
+export { SkillsReferenceModule } from './skills-reference.module.js';
+export { MemoryReferenceModule } from './memory-reference.module.js';
+export { TeamReferenceModule } from './team-reference.module.js';
+export { ProjectReferenceModule } from './project-reference.module.js';
+export { UserProfileReferenceModule } from './user-profile-reference.module.js';
+export { LearningReferenceModule } from './learning-reference.module.js';
+export { CommunicationModule } from './communication.module.js';
+export { RecoveryModule } from './recovery.module.js';
+export { LifecycleModule } from './lifecycle.module.js';
+// Context loaders
+export { createScheduledMessagesLoader, } from './scheduled-messages.loader.js';
+// Assembly services
+export { PromptAssemblyService } from './prompt-assembly.service.js';
+export { ContextAssemblyService } from './context-assembly.service.js';
+//# sourceMappingURL=index.js.map

package/dist/backend/backend/src/services/ai/prompt-modules/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../../backend/src/services/ai/prompt-modules/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,0BAA0B;AAC1B,OAAO,EAKN,cAAc,GACd,MAAM,8BAA8B,CAAC;AAEtC,iBAAiB;AACjB,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AACvE,OAAO,EAAE,0BAA0B,EAAE,MAAM,oCAAoC,CAAC;AAChF,OAAO,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AACzE,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAExD,kBAAkB;AAClB,OAAO,EACN,6BAA6B,GAG7B,MAAM,gCAAgC,CAAC;AAExC,oBAAoB;AACpB,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC"}

package/dist/backend/backend/src/services/ai/prompt-modules/learning-reference.module.d.ts

@@ -0,0 +1,28 @@
+import { PromptModule, ModuleConfig } from './prompt-module.interface.js';
+/**
+ * Learning reference module — tells the agent how to access and leverage past learnings.
+ *
+ * Provides instructions for using record-learning, recalling past experiences,
+ * and applying lessons learned from previous sessions.
+ *
+ * Sources: LearningAccumulationService, record-learning skill.
+ */
+export declare class LearningReferenceModule implements PromptModule {
+    name: string;
+    priority: number;
+    maxTokens: number;
+    compactable: boolean;
+    /**
+     * Always included — agents should know how to learn from experience.
+     */
+    shouldInclude(_config: ModuleConfig): boolean;
+    /**
+     * Build the learning reference section with instructions
+     * on how to record and recall past learnings.
+     *
+     * @param config - Module configuration with agent skill paths
+     * @returns Formatted markdown learning reference section
+     */
+    build(config: ModuleConfig): Promise<string>;
+}
+//# sourceMappingURL=learning-reference.module.d.ts.map