crewly 1.4.40 → 1.4.42

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

@@ -0,0 +1,145 @@
+/**
+ * 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;
+    /**
+     * Refresh context with a reduced budget — triggered by ContextWindowMonitorService
+     * (Feature F13) when context window usage exceeds the compaction threshold (80%).
+     *
+     * Only reloads the highest-priority loaders that fit within the reduced budget.
+     * Loaders are loaded in registration order; once budget is exhausted, remaining
+     * loaders are skipped.
+     *
+     * Integration: ContextWindowMonitorService calls this via
+     * `contextAssembly.compactRefresh(config, reducedBudget)` when usage > 80%.
+     *
+     * @param config - Loader configuration
+     * @param reducedBudget - Reduced token budget for compacted context
+     * @returns Assembled context string within reduced budget
+     */
+    compactRefresh(config: ContextLoaderConfig, reducedBudget: number): Promise<string>;
+}
+//# 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;IAOpC;;;;;;;;;;;;;;OAcG;IACG,cAAc,CACnB,MAAM,EAAE,mBAAmB,EAC3B,aAAa,EAAE,MAAM,GACnB,OAAO,CAAC,MAAM,CAAC;CAoBlB"}

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

@@ -0,0 +1,232 @@
+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;
+    }
+    /**
+     * Refresh context with a reduced budget — triggered by ContextWindowMonitorService
+     * (Feature F13) when context window usage exceeds the compaction threshold (80%).
+     *
+     * Only reloads the highest-priority loaders that fit within the reduced budget.
+     * Loaders are loaded in registration order; once budget is exhausted, remaining
+     * loaders are skipped.
+     *
+     * Integration: ContextWindowMonitorService calls this via
+     * `contextAssembly.compactRefresh(config, reducedBudget)` when usage > 80%.
+     *
+     * @param config - Loader configuration
+     * @param reducedBudget - Reduced token budget for compacted context
+     * @returns Assembled context string within reduced budget
+     */
+    async compactRefresh(config, reducedBudget) {
+        const originalBudget = this.totalTokenBudget;
+        this.totalTokenBudget = reducedBudget;
+        this.logger.info('Compact refresh triggered', {
+            agentId: config.agentId,
+            originalBudget,
+            reducedBudget,
+        });
+        // Clear cache to force fresh loads
+        this.clearCache();
+        const result = await this.loadAll(config);
+        // Restore original budget
+        this.totalTokenBudget = originalBudget;
+        return result;
+    }
+}
+//# 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, AssemblyReport, TruncatedModuleInfo, estimateTokens, loadRoleFragment, } 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,EACd,mBAAmB,EACnB,cAAc,EACd,gBAAgB,GAChB,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, loadRoleFragment, } 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,EAON,cAAc,EACd,gBAAgB,GAChB,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

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

@@ -0,0 +1 @@
+{"version":3,"file":"learning-reference.module.d.ts","sourceRoot":"","sources":["../../../../../../../backend/src/services/ai/prompt-modules/learning-reference.module.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAE1E;;;;;;;GAOG;AACH,qBAAa,uBAAwB,YAAW,YAAY;IAC3D,IAAI,SAAyB;IAC7B,QAAQ,SAAM;IACd,SAAS,SAAO;IAChB,WAAW,UAAQ;IAEnB;;OAEG;IACH,aAAa,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO;IAI7C;;;;;;OAMG;IACG,KAAK,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC;CA2BlD"}

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

@@ -0,0 +1,55 @@
+/**
+ * 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 class LearningReferenceModule {
+    name = 'learning_references';
+    priority = 10;
+    maxTokens = 250;
+    compactable = true;
+    /**
+     * Always included — agents should know how to learn from experience.
+     */
+    shouldInclude(_config) {
+        return true;
+    }
+    /**
+     * 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
+     */
+    async build(config) {
+        return `## Learning from Experience
+
+### Recording Learnings
+When you discover something worth remembering for future sessions, record it immediately:
+\`\`\`bash
+bash ${config.agentSkillsPath}/core/record-learning/execute.sh '{"agentId":"${config.sessionName}","agentRole":"${config.role}","projectPath":"${config.projectPath || ''}","learning":"<what you learned>"}'
+\`\`\`
+
+**When to record:**
+- After resolving a bug — capture the root cause and fix
+- After discovering a code pattern or convention
+- After a failed approach — capture what didn't work and why
+- After completing a task — capture key findings and gotchas
+- When you find something that contradicts your assumptions
+
+### Recalling Learnings
+Before starting a task, check what you or other agents have learned:
+\`\`\`bash
+bash ${config.agentSkillsPath}/core/recall/execute.sh '{"agentId":"${config.sessionName}","context":"learnings about <topic>","projectPath":"${config.projectPath || ''}"}'
+\`\`\`
+
+### Applying Learnings
+- Check for relevant learnings before repeating an approach that may have failed before
+- Cross-reference learnings from other agents working on the same project
+- Update or correct stale learnings when you discover they no longer apply`;
+    }
+}
+//# sourceMappingURL=learning-reference.module.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"learning-reference.module.js","sourceRoot":"","sources":["../../../../../../../backend/src/services/ai/prompt-modules/learning-reference.module.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AACH,MAAM,OAAO,uBAAuB;IACnC,IAAI,GAAG,qBAAqB,CAAC;IAC7B,QAAQ,GAAG,EAAE,CAAC;IACd,SAAS,GAAG,GAAG,CAAC;IAChB,WAAW,GAAG,IAAI,CAAC;IAEnB;;OAEG;IACH,aAAa,CAAC,OAAqB;QAClC,OAAO,IAAI,CAAC;IACb,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,KAAK,CAAC,MAAoB;QAC/B,OAAO;;;;;OAKF,MAAM,CAAC,eAAe,iDAAiD,MAAM,CAAC,WAAW,kBAAkB,MAAM,CAAC,IAAI,oBAAoB,MAAM,CAAC,WAAW,IAAI,EAAE;;;;;;;;;;;;;OAalK,MAAM,CAAC,eAAe,wCAAwC,MAAM,CAAC,WAAW,wDAAwD,MAAM,CAAC,WAAW,IAAI,EAAE;;;;;;2EAM5F,CAAC;IAC3E,CAAC;CACD"}