crewly 1.4.40 → 1.4.42

package/dist/backend/backend/src/services/ai/prompt-modules/scheduled-messages.loader.d.ts

@@ -0,0 +1,55 @@
+import { ContextLoaderConfig } from './context-assembly.service.js';
+/**
+ * Scheduled messages context loader — loads agent's scheduled checks/messages state.
+ *
+ * This is a context module (dynamic data), registered with ContextAssemblyService
+ * rather than PromptAssemblyService. It loads the current scheduled checks and
+ * messages for the agent so they have awareness of pending/recurring tasks.
+ *
+ * Token budget: 0-500
+ *
+ * Sources: SchedulerService recurring/one-time checks.
+ */
+/**
+ * Scheduled check data shape for the loader (minimal subset of ScheduledCheck).
+ */
+export interface ScheduledCheckInfo {
+    /** Unique check ID */
+    id: string;
+    /** Target session name */
+    targetSession: string;
+    /** Message content */
+    message: string;
+    /** Next scheduled execution time (ISO string) */
+    scheduledFor: string;
+    /** Interval in minutes for recurring checks */
+    intervalMinutes?: number;
+    /** Whether this check repeats */
+    isRecurring: boolean;
+    /** Human-readable label */
+    label?: string;
+}
+/**
+ * Provider function type that retrieves scheduled checks for an agent.
+ * This allows the loader to be decoupled from the SchedulerService directly.
+ */
+export type ScheduledChecksProvider = (agentId: string) => ScheduledCheckInfo[];
+/**
+ * Create a scheduled messages context loader function.
+ *
+ * The loader is created with a provider function that retrieves the current
+ * scheduled checks. This allows dependency injection and easy testing.
+ *
+ * @param getChecks - Provider function that returns scheduled checks for an agent
+ * @returns Context loader function compatible with ContextAssemblyService
+ *
+ * @example
+ * ```typescript
+ * const loader = createScheduledMessagesLoader((agentId) => {
+ *   return schedulerService.getChecksForAgent(agentId);
+ * });
+ * contextAssembly.registerLoader('scheduled_messages', loader);
+ * ```
+ */
+export declare function createScheduledMessagesLoader(getChecks: ScheduledChecksProvider): (config: ContextLoaderConfig) => Promise<string>;
+//# sourceMappingURL=scheduled-messages.loader.d.ts.map

package/dist/backend/backend/src/services/ai/prompt-modules/scheduled-messages.loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheduled-messages.loader.d.ts","sourceRoot":"","sources":["../../../../../../../backend/src/services/ai/prompt-modules/scheduled-messages.loader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AAEpE;;;;;;;;;;GAUG;AAEH;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAClC,sBAAsB;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,0BAA0B;IAC1B,aAAa,EAAE,MAAM,CAAC;IACtB,sBAAsB;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,iDAAiD;IACjD,YAAY,EAAE,MAAM,CAAC;IACrB,+CAA+C;IAC/C,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,iCAAiC;IACjC,WAAW,EAAE,OAAO,CAAC;IACrB,2BAA2B;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;GAGG;AACH,MAAM,MAAM,uBAAuB,GAAG,CAAC,OAAO,EAAE,MAAM,KAAK,kBAAkB,EAAE,CAAC;AAEhF;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,6BAA6B,CAC5C,SAAS,EAAE,uBAAuB,GAChC,CAAC,MAAM,EAAE,mBAAmB,KAAK,OAAO,CAAC,MAAM,CAAC,CA6ClD"}

package/dist/backend/backend/src/services/ai/prompt-modules/scheduled-messages.loader.js

@@ -0,0 +1,96 @@
+/**
+ * Create a scheduled messages context loader function.
+ *
+ * The loader is created with a provider function that retrieves the current
+ * scheduled checks. This allows dependency injection and easy testing.
+ *
+ * @param getChecks - Provider function that returns scheduled checks for an agent
+ * @returns Context loader function compatible with ContextAssemblyService
+ *
+ * @example
+ * ```typescript
+ * const loader = createScheduledMessagesLoader((agentId) => {
+ *   return schedulerService.getChecksForAgent(agentId);
+ * });
+ * contextAssembly.registerLoader('scheduled_messages', loader);
+ * ```
+ */
+export function createScheduledMessagesLoader(getChecks) {
+    return async (config) => {
+        const checks = getChecks(config.agentId);
+        if (!checks || checks.length === 0) {
+            return '';
+        }
+        const recurring = checks.filter((c) => c.isRecurring);
+        const oneTime = checks.filter((c) => !c.isRecurring);
+        const lines = ['## Scheduled Messages'];
+        if (recurring.length > 0) {
+            lines.push('');
+            lines.push('### Recurring Checks');
+            lines.push('| Label | Interval | Next Run | Message |');
+            lines.push('|-------|----------|----------|---------|');
+            for (const check of recurring) {
+                const label = check.label || check.id;
+                const interval = check.intervalMinutes ? `${check.intervalMinutes}m` : 'N/A';
+                const nextRun = formatTime(check.scheduledFor);
+                const message = truncateMessage(check.message);
+                lines.push(`| ${label} | ${interval} | ${nextRun} | ${message} |`);
+            }
+        }
+        if (oneTime.length > 0) {
+            lines.push('');
+            lines.push('### One-Time Checks');
+            lines.push('| Label | Scheduled For | Message |');
+            lines.push('|-------|---------------|---------|');
+            for (const check of oneTime) {
+                const label = check.label || check.id;
+                const scheduledFor = formatTime(check.scheduledFor);
+                const message = truncateMessage(check.message);
+                lines.push(`| ${label} | ${scheduledFor} | ${message} |`);
+            }
+        }
+        lines.push('');
+        lines.push(`_Total: ${checks.length} scheduled (${recurring.length} recurring, ${oneTime.length} one-time)_`);
+        return lines.join('\n');
+    };
+}
+/**
+ * Format an ISO timestamp to a short human-readable time.
+ *
+ * @param isoString - ISO 8601 timestamp
+ * @returns Formatted time string (e.g., "14:30" or "Mar 19 14:30")
+ */
+function formatTime(isoString) {
+    try {
+        const date = new Date(isoString);
+        const now = new Date();
+        const isToday = date.getFullYear() === now.getFullYear() &&
+            date.getMonth() === now.getMonth() &&
+            date.getDate() === now.getDate();
+        if (isToday) {
+            return date.toLocaleTimeString('en-US', { hour: '2-digit', minute: '2-digit', hour12: false });
+        }
+        return date.toLocaleDateString('en-US', { month: 'short', day: 'numeric' }) +
+            ' ' +
+            date.toLocaleTimeString('en-US', { hour: '2-digit', minute: '2-digit', hour12: false });
+    }
+    catch {
+        return isoString;
+    }
+}
+/**
+ * Truncate a message for table display.
+ *
+ * @param message - Full message string
+ * @param maxLength - Maximum length before truncation
+ * @returns Truncated message
+ */
+function truncateMessage(message, maxLength = 60) {
+    if (!message)
+        return '';
+    const singleLine = message.replace(/\n/g, ' ').trim();
+    if (singleLine.length <= maxLength)
+        return singleLine;
+    return singleLine.substring(0, maxLength - 3) + '...';
+}
+//# sourceMappingURL=scheduled-messages.loader.js.map

package/dist/backend/backend/src/services/ai/prompt-modules/scheduled-messages.loader.js.map

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

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

@@ -0,0 +1,28 @@
+import { PromptModule, ModuleConfig } from './prompt-module.interface.js';
+/**
+ * Skills reference module — tells the agent how to discover and use skills.
+ *
+ * Consolidates skill authorization, communication skill references,
+ * and catalog location into a single module.
+ *
+ * Sources: Path A Step 1+6, Path B Section 8, Path C skill instructions.
+ */
+export declare class SkillsReferenceModule implements PromptModule {
+    name: string;
+    priority: number;
+    maxTokens: number;
+    compactable: boolean;
+    /**
+     * Always included — agents need to know how to use skills.
+     */
+    shouldInclude(_config: ModuleConfig): boolean;
+    /**
+     * Build the skills reference section with catalog location,
+     * commonly-used skills, and memory tool instructions.
+     *
+     * @param config - Module configuration with skill paths
+     * @returns Formatted markdown skills reference section
+     */
+    build(config: ModuleConfig): Promise<string>;
+}
+//# sourceMappingURL=skills-reference.module.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"skills-reference.module.d.ts","sourceRoot":"","sources":["../../../../../../../backend/src/services/ai/prompt-modules/skills-reference.module.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAE1E;;;;;;;GAOG;AACH,qBAAa,qBAAsB,YAAW,YAAY;IACzD,IAAI,SAAuB;IAC3B,QAAQ,SAAK;IACb,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;CAqClD"}

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

@@ -0,0 +1,65 @@
+/**
+ * Skills reference module — tells the agent how to discover and use skills.
+ *
+ * Consolidates skill authorization, communication skill references,
+ * and catalog location into a single module.
+ *
+ * Sources: Path A Step 1+6, Path B Section 8, Path C skill instructions.
+ */
+export class SkillsReferenceModule {
+    name = 'skills_references';
+    priority = 5;
+    maxTokens = 500;
+    compactable = true;
+    /**
+     * Always included — agents need to know how to use skills.
+     */
+    shouldInclude(_config) {
+        return true;
+    }
+    /**
+     * Build the skills reference section with catalog location,
+     * commonly-used skills, and memory tool instructions.
+     *
+     * @param config - Module configuration with skill paths
+     * @returns Formatted markdown skills reference section
+     */
+    async build(config) {
+        return `## Available Skills
+
+Bash skills at \`${config.agentSkillsPath}/\`:
+- \`core/recall\` — retrieve relevant knowledge from memory
+- \`core/remember\` — store knowledge for future reference
+- \`core/record-learning\` — record learnings while working
+- \`core/report-status\` — report status to orchestrator
+- \`core/send-message\` — communicate with other agents
+- \`core/get-sops\` — request relevant SOPs for current situation
+
+Skills catalog: \`~/.crewly/skills/AGENT_SKILLS_CATALOG.md\`
+
+## Authorized Operations
+
+The following operations are pre-approved for this session:
+- Execute bash scripts in \`${config.agentSkillsPath}/\` and \`${config.tlSkillsPath}/\`
+- Read and write files within the project directory
+- Use browser automation skills when available (e.g., remote-browser)
+
+## Communication
+
+Use bash skills at \`${config.agentSkillsPath}/\` for all team communication. Read \`~/.crewly/skills/AGENT_SKILLS_CATALOG.md\` for a full reference.
+- \`send-message\` to communicate with other agents
+- \`report-progress\` to update on task status
+- \`remember\` to store important learnings (always pass your \`agentId\` and \`projectPath\`)
+- \`recall\` to retrieve relevant knowledge (always pass your \`agentId\` and \`projectPath\`)
+- \`record-learning\` to record learnings (always pass your \`agentId\` and \`projectPath\`)
+- \`get-sops\` to request relevant SOPs for your current situation
+
+**IMPORTANT for memory tools:** When calling \`remember\`, \`recall\`, or \`record-learning\`, you MUST pass:
+- \`agentId\`: Your **Session Name** from the Identity section above
+- \`projectPath\`: Your **Project Path** from the Identity section above
+This ensures your knowledge is stored under your identity and in the correct project.
+
+**IMPORTANT for recall:** Before answering questions about the project, deployment, architecture, or past decisions, ALWAYS call \`recall\` first to check your stored knowledge.`;
+    }
+}
+//# sourceMappingURL=skills-reference.module.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"skills-reference.module.js","sourceRoot":"","sources":["../../../../../../../backend/src/services/ai/prompt-modules/skills-reference.module.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AACH,MAAM,OAAO,qBAAqB;IACjC,IAAI,GAAG,mBAAmB,CAAC;IAC3B,QAAQ,GAAG,CAAC,CAAC;IACb,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;;mBAEU,MAAM,CAAC,eAAe;;;;;;;;;;;;;8BAaX,MAAM,CAAC,eAAe,aAAa,MAAM,CAAC,YAAY;;;;;;uBAM7D,MAAM,CAAC,eAAe;;;;;;;;;;;;;kLAaqI,CAAC;IAClL,CAAC;CACD"}

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

@@ -0,0 +1,70 @@
+import { PromptModule, ModuleConfig } from './prompt-module.interface.js';
+/**
+ * Soul module — provides the agent's personality, tone, and working style.
+ *
+ * Loads the agent's "soul" from the resolution chain:
+ * 1. Per-member soul (~/.crewly/teams/{teamId}/members/{memberId}/soul.md)
+ * 2. Role default soul (config/roles/{role}/soul.md)
+ * 3. Reusable archetype (config/souls/{archetype}.md)
+ * 4. Hardcoded minimal fallback
+ *
+ * Sources: Path A Step 5, Path B Section 9, Soul System Design (Section 6).
+ */
+export declare class SoulModule implements PromptModule {
+    name: string;
+    priority: number;
+    maxTokens: number;
+    compactable: boolean;
+    /**
+     * Always included — every agent benefits from personality definition.
+     */
+    shouldInclude(_config: ModuleConfig): boolean;
+    /**
+     * Build the soul section by resolving the soul file from the resolution chain.
+     * If self-improvement data exists, appends a Self-Awareness section.
+     *
+     * @param config - Module configuration with role and project details
+     * @returns Formatted markdown soul section
+     */
+    build(config: ModuleConfig): Promise<string>;
+    /**
+     * Resolve the soul content by checking each level of the resolution chain.
+     *
+     * @param config - Module configuration
+     * @returns Soul content string
+     */
+    private resolveSoul;
+    /**
+     * Get the path to a member's personal soul file.
+     *
+     * @param teamId - Team ID
+     * @param memberId - Member ID
+     * @returns Absolute path to the member soul file
+     */
+    private getMemberSoulPath;
+    /**
+     * Read a file if it exists, returning its content or null.
+     *
+     * @param filePath - Path to the file
+     * @returns File content string or null if not found
+     */
+    private readFileIfExists;
+    /**
+     * Format the soul content with a source annotation.
+     *
+     * @param content - Raw soul file content
+     * @param source - Where the soul was resolved from
+     * @returns Formatted soul section
+     */
+    private formatSoul;
+    /**
+     * Build the Self-Awareness section from self-improvement data.
+     * Reads growth areas, self-model (blind spots), and prediction calibration.
+     * Kept under ~200 tokens.
+     *
+     * @param sessionName - Agent session name
+     * @returns Self-awareness markdown section, or null if no data exists
+     */
+    private buildSelfAwareness;
+}
+//# sourceMappingURL=soul.module.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"soul.module.d.ts","sourceRoot":"","sources":["../../../../../../../backend/src/services/ai/prompt-modules/soul.module.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAS1E;;;;;;;;;;GAUG;AACH,qBAAa,UAAW,YAAW,YAAY;IAC9C,IAAI,SAAU;IACd,QAAQ,SAAK;IACb,SAAS,SAAO;IAChB,WAAW,UAAS;IAEpB;;OAEG;IACH,aAAa,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO;IAI7C;;;;;;OAMG;IACG,KAAK,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC;IAMlD;;;;;OAKG;YACW,WAAW;IAgCzB;;;;;;OAMG;IACH,OAAO,CAAC,iBAAiB;IAKzB;;;;;OAKG;IACH,OAAO,CAAC,gBAAgB;IAQxB;;;;;;OAMG;IACH,OAAO,CAAC,UAAU;IAKlB;;;;;;;OAOG;IACH,OAAO,CAAC,kBAAkB;CA+C1B"}

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

@@ -0,0 +1,166 @@
+import * as fs from 'fs';
+import * as path from 'path';
+/**
+ * Default minimal soul fallback when no soul file is found.
+ */
+const DEFAULT_SOUL = `## Your Soul
+
+You are a professional, reliable team member. Communicate clearly, ask when uncertain, and report blockers promptly.`;
+/**
+ * Soul module — provides the agent's personality, tone, and working style.
+ *
+ * Loads the agent's "soul" from the resolution chain:
+ * 1. Per-member soul (~/.crewly/teams/{teamId}/members/{memberId}/soul.md)
+ * 2. Role default soul (config/roles/{role}/soul.md)
+ * 3. Reusable archetype (config/souls/{archetype}.md)
+ * 4. Hardcoded minimal fallback
+ *
+ * Sources: Path A Step 5, Path B Section 9, Soul System Design (Section 6).
+ */
+export class SoulModule {
+    name = 'soul';
+    priority = 2;
+    maxTokens = 830;
+    compactable = false;
+    /**
+     * Always included — every agent benefits from personality definition.
+     */
+    shouldInclude(_config) {
+        return true;
+    }
+    /**
+     * Build the soul section by resolving the soul file from the resolution chain.
+     * If self-improvement data exists, appends a Self-Awareness section.
+     *
+     * @param config - Module configuration with role and project details
+     * @returns Formatted markdown soul section
+     */
+    async build(config) {
+        const soul = await this.resolveSoul(config);
+        const selfAwareness = this.buildSelfAwareness(config.sessionName);
+        return selfAwareness ? `${soul}\n\n${selfAwareness}` : soul;
+    }
+    /**
+     * Resolve the soul content by checking each level of the resolution chain.
+     *
+     * @param config - Module configuration
+     * @returns Soul content string
+     */
+    async resolveSoul(config) {
+        // 1. Per-member soul
+        if (config.teamId && config.memberId) {
+            const memberSoulPath = this.getMemberSoulPath(config.teamId, config.memberId);
+            const content = this.readFileIfExists(memberSoulPath);
+            if (content) {
+                return this.formatSoul(content, 'member');
+            }
+        }
+        // 2. Role default soul (config/roles/{role}/soul.md)
+        if (config.role) {
+            const roleSoulPath = path.join(config.projectRoot, 'config', 'roles', config.role, 'soul.md');
+            const content = this.readFileIfExists(roleSoulPath);
+            if (content) {
+                return this.formatSoul(content, 'role');
+            }
+        }
+        // 3. Reusable archetype (config/souls/{role}.md as fallback archetype)
+        if (config.role) {
+            const archetypePath = path.join(config.projectRoot, 'config', 'souls', `${config.role}.md`);
+            const content = this.readFileIfExists(archetypePath);
+            if (content) {
+                return this.formatSoul(content, 'archetype');
+            }
+        }
+        // 4. Hardcoded minimal fallback
+        return DEFAULT_SOUL;
+    }
+    /**
+     * Get the path to a member's personal soul file.
+     *
+     * @param teamId - Team ID
+     * @param memberId - Member ID
+     * @returns Absolute path to the member soul file
+     */
+    getMemberSoulPath(teamId, memberId) {
+        const homeDir = process.env.HOME || process.env.USERPROFILE || '/tmp';
+        return path.join(homeDir, '.crewly', 'teams', teamId, 'members', memberId, 'soul.md');
+    }
+    /**
+     * Read a file if it exists, returning its content or null.
+     *
+     * @param filePath - Path to the file
+     * @returns File content string or null if not found
+     */
+    readFileIfExists(filePath) {
+        try {
+            return fs.readFileSync(filePath, 'utf-8').trim();
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * Format the soul content with a source annotation.
+     *
+     * @param content - Raw soul file content
+     * @param source - Where the soul was resolved from
+     * @returns Formatted soul section
+     */
+    formatSoul(content, source) {
+        const sourceLabel = source === 'member' ? 'personal' : source === 'role' ? 'role default' : 'archetype';
+        return `## Your Soul\n_Source: ${sourceLabel}_\n\n${content}`;
+    }
+    /**
+     * Build the Self-Awareness section from self-improvement data.
+     * Reads growth areas, self-model (blind spots), and prediction calibration.
+     * Kept under ~200 tokens.
+     *
+     * @param sessionName - Agent session name
+     * @returns Self-awareness markdown section, or null if no data exists
+     */
+    buildSelfAwareness(sessionName) {
+        const homeDir = process.env.HOME || process.env.USERPROFILE || '/tmp';
+        const agentDir = path.join(homeDir, '.crewly', 'agents', sessionName);
+        const lines = [];
+        // Growth areas — top 3
+        try {
+            const raw = fs.readFileSync(path.join(agentDir, 'growth-areas.json'), 'utf-8');
+            const data = JSON.parse(raw);
+            if (data.areas && data.areas.length > 0) {
+                const top3 = data.areas.slice(0, 3);
+                lines.push('**Growth Areas:**');
+                for (const area of top3) {
+                    lines.push(`- ${area.area} (${area.progress})`);
+                }
+            }
+        }
+        catch { /* no growth areas data */ }
+        // Blind spots — top 2
+        try {
+            const raw = fs.readFileSync(path.join(agentDir, 'self-model.json'), 'utf-8');
+            const data = JSON.parse(raw);
+            if (data.blindSpots && data.blindSpots.length > 0) {
+                const top2 = data.blindSpots.slice(0, 2);
+                lines.push('**Blind Spots:**');
+                for (const spot of top2) {
+                    lines.push(`- ${spot.description}`);
+                }
+            }
+        }
+        catch { /* no self-model data */ }
+        // Prediction calibration score
+        try {
+            const raw = fs.readFileSync(path.join(agentDir, 'predictions.json'), 'utf-8');
+            const data = JSON.parse(raw);
+            if (data.calibrationScore > 0) {
+                lines.push(`**Prediction Calibration:** ${Math.round(data.calibrationScore * 100)}%`);
+            }
+        }
+        catch { /* no predictions data */ }
+        if (lines.length === 0) {
+            return null;
+        }
+        return `## Self-Awareness\n${lines.join('\n')}`;
+    }
+}
+//# sourceMappingURL=soul.module.js.map

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

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

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

@@ -0,0 +1,54 @@
+import { PromptModule, ModuleConfig } from './prompt-module.interface.js';
+/**
+ * Team reference module — provides team hierarchy, TL duties, and norms references.
+ *
+ * Wraps the existing `buildTeamLeadSection` and `buildTeamNormsSection` logic
+ * from PromptBuilderService. The TL addon is conditionally loaded only when
+ * the agent has `canDelegate=true` and subordinates.
+ *
+ * Sources: Path A Step 7, Path B Sections 4+5.
+ */
+export declare class TeamReferenceModule implements PromptModule {
+    name: string;
+    priority: number;
+    maxTokens: number;
+    compactable: boolean;
+    /**
+     * Include when agent has a team (teamId set) or has subordinates.
+     */
+    shouldInclude(config: ModuleConfig): boolean;
+    /**
+     * Build team reference section. Includes TL addon if agent can delegate,
+     * and team norms if available.
+     *
+     * @param config - Module configuration with team and subordinate details
+     * @returns Formatted markdown team reference section
+     */
+    build(config: ModuleConfig): Promise<string>;
+    /**
+     * Build Team Lead section by loading tl-addon.md and resolving variables.
+     * Falls back to inline section if addon file not found.
+     *
+     * @param config - Module configuration with subordinate details
+     * @returns Formatted TL section or empty string
+     */
+    private buildTeamLeadSection;
+    /**
+     * Build minimal inline TL section as fallback when tl-addon.md is not found.
+     *
+     * @param workerList - Pre-formatted worker list
+     * @param subordinateCount - Number of subordinates
+     * @returns Formatted inline TL section
+     */
+    private buildInlineTeamLeadSection;
+    /**
+     * Build team norms section by loading norms files from team directory.
+     * Only includes norms whose role list matches the agent's role or '*'.
+     *
+     * @param teamId - Team ID to load norms for
+     * @param role - Agent's role for filtering
+     * @returns Formatted norms markdown or empty string
+     */
+    private buildTeamNormsSection;
+}
+//# sourceMappingURL=team-reference.module.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"team-reference.module.d.ts","sourceRoot":"","sources":["../../../../../../../backend/src/services/ai/prompt-modules/team-reference.module.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAE1E;;;;;;;;GAQG;AACH,qBAAa,mBAAoB,YAAW,YAAY;IACvD,IAAI,SAAqB;IACzB,QAAQ,SAAK;IACb,SAAS,SAAQ;IACjB,WAAW,UAAS;IAEpB;;OAEG;IACH,aAAa,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO;IAI5C;;;;;;OAMG;IACG,KAAK,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC;IAsBlD;;;;;;OAMG;YACW,oBAAoB;IAoClC;;;;;;OAMG;IACH,OAAO,CAAC,0BAA0B;IAgBlC;;;;;;;OAOG;YACW,qBAAqB;CAmCnC"}