crewly 1.5.17 → 1.5.19

package/dist/backend/backend/src/services/v3/task-projection.service.js

@@ -0,0 +1,378 @@
+/**
+ * Task Projection Service (V3.1)
+ *
+ * Projects agent behavior into structured TaskRecord + TaskEvent entries.
+ * The system automatically calls this — agents do not create TaskRecords directly.
+ *
+ * Responsibilities:
+ * - CRUD for TaskRecords and TaskEvents
+ * - Aggregation (per request, per agent, per skill)
+ * - Token/cost accumulation
+ * - Persistence to ~/.crewly/task-records/
+ *
+ * @module services/v3/task-projection.service
+ */
+import * as path from 'path';
+import { LoggerService } from '../core/logger.service.js';
+import { ensureDir, atomicWriteJson, safeReadJson } from '../../utils/file-io.utils.js';
+import { createTaskRecord, createTaskEvent, } from '../../types/v3/task-record.types.js';
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+const RECORDS_DIR = 'task-records';
+const RECORDS_FILE = 'records.json';
+const EVENTS_FILE = 'events.json';
+/** Keep at most this many events in memory/disk to avoid unbounded growth */
+const MAX_EVENTS = 10_000;
+// ---------------------------------------------------------------------------
+// Service
+// ---------------------------------------------------------------------------
+export class TaskProjectionService {
+    static instance = null;
+    logger;
+    recordsDir;
+    recordsFile;
+    eventsFile;
+    records = new Map();
+    events = [];
+    constructor(projectPath) {
+        this.logger = LoggerService.getInstance().createComponentLogger('TaskProjection');
+        this.recordsDir = path.join(projectPath, '.crewly', RECORDS_DIR);
+        this.recordsFile = path.join(this.recordsDir, RECORDS_FILE);
+        this.eventsFile = path.join(this.recordsDir, EVENTS_FILE);
+    }
+    static getInstance(projectPath) {
+        if (!TaskProjectionService.instance) {
+            const p = projectPath || process.env.CREWLY_PROJECT_PATH || process.cwd();
+            TaskProjectionService.instance = new TaskProjectionService(p);
+        }
+        return TaskProjectionService.instance;
+    }
+    static resetInstance() {
+        TaskProjectionService.instance = null;
+    }
+    // ---------------------------------------------------------------------------
+    // Lifecycle
+    // ---------------------------------------------------------------------------
+    async load() {
+        await ensureDir(this.recordsDir);
+        const records = await safeReadJson(this.recordsFile, []);
+        this.records.clear();
+        for (const r of records)
+            this.records.set(r.id, r);
+        this.events = await safeReadJson(this.eventsFile, []);
+        this.logger.info('TaskProjection loaded', { records: this.records.size, events: this.events.length });
+    }
+    // ---------------------------------------------------------------------------
+    // TaskRecord CRUD
+    // ---------------------------------------------------------------------------
+    /**
+     * Creates a new TaskRecord and emits a task_created event.
+     *
+     * @param input - Creation parameters
+     * @returns The created TaskRecord
+     */
+    async createRecord(input) {
+        const record = createTaskRecord(input);
+        this.records.set(record.id, record);
+        await this.appendEvent({
+            taskId: record.id,
+            eventType: 'task_created',
+            agentId: input.ownerAgent,
+            payload: { title: input.title, type: input.type, requestId: input.requestId },
+        });
+        await this.persistRecords();
+        this.logger.info('TaskRecord created', { id: record.id, type: input.type, agent: input.ownerAgent });
+        return record;
+    }
+    /**
+     * Updates a TaskRecord's status and timestamps.
+     *
+     * @param id - TaskRecord ID
+     * @param updates - Fields to update
+     * @returns Updated TaskRecord or null if not found
+     */
+    async updateRecord(id, updates) {
+        const record = this.records.get(id);
+        if (!record)
+            return null;
+        const now = new Date().toISOString();
+        // Save existing token usage before Object.assign overwrites it
+        const existingTokenUsage = record.tokenUsage;
+        Object.assign(record, updates, { updatedAt: now });
+        // Accumulate token usage (merge old + new instead of replacing)
+        if (updates.tokenUsage && existingTokenUsage) {
+            record.tokenUsage = mergeTokenUsage(existingTokenUsage, updates.tokenUsage);
+        }
+        await this.persistRecords();
+        return record;
+    }
+    /**
+     * Gets a TaskRecord by ID.
+     */
+    getRecord(id) {
+        return this.records.get(id);
+    }
+    /**
+     * Lists TaskRecords, optionally filtered by requestId, ownerAgent, status, or workItemId.
+     */
+    listRecords(filter) {
+        const all = Array.from(this.records.values());
+        if (!filter)
+            return all;
+        return all.filter((r) => {
+            if (filter.requestId && r.requestId !== filter.requestId)
+                return false;
+            if (filter.ownerAgent && r.ownerAgent !== filter.ownerAgent)
+                return false;
+            if (filter.status && r.status !== filter.status)
+                return false;
+            if (filter.workItemId && r.workItemId !== filter.workItemId)
+                return false;
+            return true;
+        });
+    }
+    // ---------------------------------------------------------------------------
+    // Convenience Status Transitions
+    // ---------------------------------------------------------------------------
+    /**
+     * Marks a task as assigned to an agent.
+     */
+    async markAssigned(taskId, agentId, assignedBy) {
+        const now = new Date().toISOString();
+        await this.updateRecord(taskId, { status: 'assigned', assignedAt: now });
+        await this.appendEvent({ taskId, eventType: 'task_assigned', agentId, payload: { assignedBy } });
+    }
+    /**
+     * Marks a task as started/running.
+     */
+    async markStarted(taskId, agentId) {
+        const now = new Date().toISOString();
+        await this.updateRecord(taskId, { status: 'running', startedAt: now });
+        await this.appendEvent({ taskId, eventType: 'task_started', agentId, payload: {} });
+    }
+    /**
+     * Marks a task as completed. Triggers async token roll-up to parent Request if applicable.
+     */
+    async markDone(taskId, agentId, tokenUsage) {
+        const now = new Date().toISOString();
+        await this.updateRecord(taskId, { status: 'done', completedAt: now, tokenUsage });
+        await this.appendEvent({ taskId, eventType: 'task_completed', agentId, payload: { tokenUsage } });
+        // Async roll-up: accumulate tokens on the parent Request (non-blocking)
+        if (tokenUsage) {
+            const record = this.records.get(taskId);
+            if (record?.requestId) {
+                this.rollUpToRequest(record.requestId, tokenUsage);
+            }
+        }
+    }
+    /**
+     * Asynchronously rolls up token usage from a completed task to its parent Request.
+     * Errors are swallowed — this must never block agent-facing operations.
+     *
+     * @param requestId - Parent Request ID
+     * @param tokenUsage - Token counts from the completed task
+     */
+    rollUpToRequest(requestId, tokenUsage) {
+        setImmediate(async () => {
+            try {
+                const { RequestService } = await import('./request.service.js');
+                const svc = RequestService.getInstance();
+                const request = await svc.getById(requestId);
+                if (!request)
+                    return;
+                await svc.update(requestId, {
+                    totalInputTokens: (request.totalInputTokens || 0) + (tokenUsage.promptTokens || 0),
+                    totalOutputTokens: (request.totalOutputTokens || 0) + (tokenUsage.completionTokens || 0),
+                    totalCost: (request.totalCost || 0) + (tokenUsage.estimatedCostUsd || 0),
+                });
+                this.logger.debug('Token roll-up to request complete', { requestId });
+                // Cascade to Mission if applicable
+                if (request.missionId && tokenUsage.estimatedCostUsd) {
+                    setImmediate(async () => {
+                        try {
+                            const { _loadMission, _saveMission } = await import('../../controllers/mission/mission-policy.controller.js');
+                            const mission = await _loadMission(request.missionId);
+                            if (!mission)
+                                return;
+                            mission.totalInputTokens = (mission.totalInputTokens || 0) + (tokenUsage.promptTokens || 0);
+                            mission.totalOutputTokens = (mission.totalOutputTokens || 0) + (tokenUsage.completionTokens || 0);
+                            mission.totalCost = (mission.totalCost || 0) + (tokenUsage.estimatedCostUsd || 0);
+                            mission.updatedAt = new Date().toISOString();
+                            await _saveMission(mission);
+                            this.logger.debug('Token roll-up to mission complete', { missionId: request.missionId });
+                        }
+                        catch (err) {
+                            this.logger.debug('Mission token roll-up failed (non-fatal)', {
+                                missionId: request.missionId,
+                                error: err instanceof Error ? err.message : String(err),
+                            });
+                        }
+                    });
+                }
+            }
+            catch (err) {
+                this.logger.debug('Request token roll-up failed (non-fatal)', {
+                    requestId,
+                    error: err instanceof Error ? err.message : String(err),
+                });
+            }
+        });
+    }
+    /**
+     * Marks a task as failed.
+     */
+    async markFailed(taskId, agentId, reason) {
+        const now = new Date().toISOString();
+        await this.updateRecord(taskId, { status: 'failed', completedAt: now, blockedReason: reason });
+        await this.appendEvent({ taskId, eventType: 'task_failed', agentId, payload: { reason } });
+    }
+    /**
+     * Marks a task as blocked.
+     */
+    async markBlocked(taskId, agentId, reason) {
+        await this.updateRecord(taskId, { status: 'blocked', blockedReason: reason });
+        await this.appendEvent({ taskId, eventType: 'task_blocked', agentId, payload: { reason } });
+    }
+    // ---------------------------------------------------------------------------
+    // Skill Execution Projection
+    // ---------------------------------------------------------------------------
+    /**
+     * Records a skill invocation (called/succeeded/failed).
+     */
+    async recordSkillCall(params) {
+        const { taskId, agentId, skillName, success, tokenUsage, durationMs, error } = params;
+        await this.appendEvent({
+            taskId,
+            eventType: 'skill_called',
+            agentId,
+            payload: { skillName, success, durationMs },
+        });
+        await this.appendEvent({
+            taskId,
+            eventType: success ? 'skill_succeeded' : 'skill_failed',
+            agentId,
+            payload: { skillName, error, tokenUsage },
+        });
+        if (tokenUsage) {
+            await this.updateRecord(taskId, { tokenUsage });
+            await this.appendEvent({
+                taskId,
+                eventType: 'token_recorded',
+                agentId,
+                payload: { skillName, tokenUsage },
+            });
+        }
+    }
+    // ---------------------------------------------------------------------------
+    // TaskEvent
+    // ---------------------------------------------------------------------------
+    /**
+     * Gets all events for a specific task.
+     */
+    getEventsForTask(taskId) {
+        return this.events.filter((e) => e.taskId === taskId);
+    }
+    /**
+     * Lists recent events, optionally filtered by taskId.
+     */
+    listEvents(filter, limit = 200) {
+        let result = this.events;
+        if (filter?.taskId)
+            result = result.filter((e) => e.taskId === filter.taskId);
+        if (filter?.eventType)
+            result = result.filter((e) => e.eventType === filter.eventType);
+        return result.slice(-limit);
+    }
+    // ---------------------------------------------------------------------------
+    // Aggregation
+    // ---------------------------------------------------------------------------
+    /**
+     * Returns token usage aggregated per request.
+     */
+    aggregateByRequest() {
+        const result = {};
+        for (const record of this.records.values()) {
+            if (!record.requestId || !record.tokenUsage)
+                continue;
+            if (!result[record.requestId]) {
+                result[record.requestId] = { promptTokens: 0, completionTokens: 0, totalTokens: 0 };
+            }
+            result[record.requestId] = mergeTokenUsage(result[record.requestId], record.tokenUsage);
+        }
+        return result;
+    }
+    /**
+     * Returns token usage aggregated per agent.
+     */
+    aggregateByAgent() {
+        const result = {};
+        for (const record of this.records.values()) {
+            if (!record.tokenUsage)
+                continue;
+            if (!result[record.ownerAgent]) {
+                result[record.ownerAgent] = { promptTokens: 0, completionTokens: 0, totalTokens: 0 };
+            }
+            result[record.ownerAgent] = mergeTokenUsage(result[record.ownerAgent], record.tokenUsage);
+        }
+        return result;
+    }
+    /**
+     * Returns a summary of task counts by status.
+     */
+    getSummary() {
+        const byStatus = {};
+        const byType = {};
+        const byAgent = {};
+        for (const r of this.records.values()) {
+            byStatus[r.status] = (byStatus[r.status] || 0) + 1;
+            byType[r.type] = (byType[r.type] || 0) + 1;
+            byAgent[r.ownerAgent] = (byAgent[r.ownerAgent] || 0) + 1;
+        }
+        return { total: this.records.size, byStatus, byType, byAgent };
+    }
+    // ---------------------------------------------------------------------------
+    // Persistence
+    // ---------------------------------------------------------------------------
+    async persistRecords() {
+        await ensureDir(this.recordsDir);
+        await atomicWriteJson(this.recordsFile, Array.from(this.records.values()));
+    }
+    async persistEvents() {
+        await ensureDir(this.recordsDir);
+        // Trim to keep max events
+        if (this.events.length > MAX_EVENTS) {
+            this.events = this.events.slice(-MAX_EVENTS);
+        }
+        await atomicWriteJson(this.eventsFile, this.events);
+    }
+    async appendEvent(input) {
+        const event = createTaskEvent(input);
+        this.events.push(event);
+        await this.persistEvents();
+    }
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+/**
+ * Merges two TokenUsage objects by summing token counts and costs.
+ * Uses the latest model name (from `b`), falling back to `a`.
+ *
+ * @param a - Existing token usage
+ * @param b - New token usage to accumulate
+ * @returns Merged token usage
+ */
+function mergeTokenUsage(a, b) {
+    const costA = a.estimatedCostUsd ?? 0;
+    const costB = b.estimatedCostUsd ?? 0;
+    const hasCost = a.estimatedCostUsd !== undefined || b.estimatedCostUsd !== undefined;
+    return {
+        promptTokens: (a.promptTokens || 0) + (b.promptTokens || 0),
+        completionTokens: (a.completionTokens || 0) + (b.completionTokens || 0),
+        totalTokens: (a.totalTokens || 0) + (b.totalTokens || 0),
+        model: b.model || a.model,
+        estimatedCostUsd: hasCost ? costA + costB : undefined,
+    };
+}
+//# sourceMappingURL=task-projection.service.js.map

package/dist/backend/backend/src/services/v3/task-projection.service.js.map

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

package/dist/backend/backend/src/services/v3/tl-auto-verify.service.d.ts

@@ -0,0 +1,63 @@
+/**
+ * TL Auto-Verify Service
+ *
+ * Automatically triggers Team Leader verification when a worker's task completes.
+ * Listens to EventBus for task:done/task:completed events, looks up the worker's
+ * TL via team hierarchy, and sends the TL a message to run verify-output with
+ * the pre-approved checklist.
+ *
+ * Only activates for hierarchical teams with a defined TL.
+ *
+ * @module services/v3/tl-auto-verify.service
+ */
+interface TeamMemberInfo {
+    id: string;
+    sessionName: string;
+    role: string;
+    parentMemberId?: string;
+    hierarchyLevel?: number;
+}
+interface TeamInfo {
+    id: string;
+    name: string;
+    hierarchical?: boolean;
+    members: TeamMemberInfo[];
+}
+export declare class TLAutoVerifyService {
+    private static instance;
+    private readonly logger;
+    private eventBusService;
+    private teamsProvider;
+    private constructor();
+    static getInstance(): TLAutoVerifyService;
+    static resetInstance(): void;
+    /**
+     * Initialize with EventBus and team data source.
+     */
+    initialize(eventBusService: {
+        on: (event: string, handler: (...args: unknown[]) => void) => void;
+    }, teamsProvider?: () => Promise<TeamInfo[]>): void;
+    /**
+     * Start listening for task completion events.
+     */
+    start(): void;
+    /**
+     * Handle a worker's task completion. Finds the worker's TL and sends
+     * a verification request.
+     *
+     * @param workerSessionName - The worker agent that completed the task
+     * @param teamId - The team ID (if available from event)
+     * @param taskId - The task ID (if available)
+     */
+    private onWorkerTaskCompleted;
+    /**
+     * Find the Team Leader for a given worker by looking up team hierarchy.
+     *
+     * @param workerSessionName - Worker's agent session name
+     * @param teamId - Optional team ID hint from the event
+     * @returns TL info or null if no hierarchical TL exists
+     */
+    private findTeamLeaderForWorker;
+}
+export {};
+//# sourceMappingURL=tl-auto-verify.service.d.ts.map

package/dist/backend/backend/src/services/v3/tl-auto-verify.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tl-auto-verify.service.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/v3/tl-auto-verify.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAQH,UAAU,cAAc;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,UAAU,QAAQ;IAChB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,OAAO,EAAE,cAAc,EAAE,CAAC;CAC3B;AAMD,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAoC;IAC3D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkB;IACzC,OAAO,CAAC,eAAe,CAAuF;IAC9G,OAAO,CAAC,aAAa,CAA4C;IAEjE,OAAO;WAIO,WAAW,IAAI,mBAAmB;WAOlC,aAAa,IAAI,IAAI;IAInC;;OAEG;IACH,UAAU,CACR,eAAe,EAAE;QAAE,EAAE,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,KAAK,IAAI,CAAA;KAAE,EACvF,aAAa,CAAC,EAAE,MAAM,OAAO,CAAC,QAAQ,EAAE,CAAC,GACxC,IAAI;IAKP;;OAEG;IACH,KAAK,IAAI,IAAI;IA2Bb;;;;;;;OAOG;YACW,qBAAqB;IA2DnC;;;;;;OAMG;YACW,uBAAuB;CA0CtC"}

package/dist/backend/backend/src/services/v3/tl-auto-verify.service.js

@@ -0,0 +1,169 @@
+/**
+ * TL Auto-Verify Service
+ *
+ * Automatically triggers Team Leader verification when a worker's task completes.
+ * Listens to EventBus for task:done/task:completed events, looks up the worker's
+ * TL via team hierarchy, and sends the TL a message to run verify-output with
+ * the pre-approved checklist.
+ *
+ * Only activates for hierarchical teams with a defined TL.
+ *
+ * @module services/v3/tl-auto-verify.service
+ */
+import { LoggerService } from '../core/logger.service.js';
+// ---------------------------------------------------------------------------
+// Service
+// ---------------------------------------------------------------------------
+export class TLAutoVerifyService {
+    static instance = null;
+    logger;
+    eventBusService = null;
+    teamsProvider = null;
+    constructor() {
+        this.logger = LoggerService.getInstance().createComponentLogger('TLAutoVerify');
+    }
+    static getInstance() {
+        if (!TLAutoVerifyService.instance) {
+            TLAutoVerifyService.instance = new TLAutoVerifyService();
+        }
+        return TLAutoVerifyService.instance;
+    }
+    static resetInstance() {
+        TLAutoVerifyService.instance = null;
+    }
+    /**
+     * Initialize with EventBus and team data source.
+     */
+    initialize(eventBusService, teamsProvider) {
+        this.eventBusService = eventBusService;
+        this.teamsProvider = teamsProvider ?? null;
+    }
+    /**
+     * Start listening for task completion events.
+     */
+    start() {
+        if (!this.eventBusService) {
+            this.logger.warn('Cannot start — EventBusService not initialized');
+            return;
+        }
+        this.eventBusService.on('event_published', (payload) => {
+            const event = payload;
+            if (!event?.eventType || !event?.sessionName)
+                return;
+            if (event.eventType === 'task:done' || event.eventType === 'task:completed') {
+                this.onWorkerTaskCompleted(event.sessionName, event.teamId, event.taskId).catch((err) => {
+                    this.logger.debug('Auto-verify trigger failed (non-fatal)', {
+                        error: err instanceof Error ? err.message : String(err),
+                    });
+                });
+            }
+        });
+        this.logger.info('TLAutoVerifyService started — worker task completions will trigger TL verification');
+    }
+    /**
+     * Handle a worker's task completion. Finds the worker's TL and sends
+     * a verification request.
+     *
+     * @param workerSessionName - The worker agent that completed the task
+     * @param teamId - The team ID (if available from event)
+     * @param taskId - The task ID (if available)
+     */
+    async onWorkerTaskCompleted(workerSessionName, teamId, taskId) {
+        // Find the worker's team and TL
+        const tlInfo = await this.findTeamLeaderForWorker(workerSessionName, teamId);
+        if (!tlInfo) {
+            this.logger.debug('No TL found for worker — skipping auto-verify', { workerSessionName });
+            return;
+        }
+        // Send verification request to TL via message queue
+        try {
+            const { MessageQueueService } = await import('../messaging/message-queue.service.js');
+            const mqService = new MessageQueueService(process.cwd());
+            const verifyInstruction = [
+                `[AUTO-VERIFY] Worker ${workerSessionName} has completed a task.`,
+                taskId ? `Task ID: ${taskId}` : '',
+                '',
+                'Please verify the output using the pre-approved checklist:',
+                '```bash',
+                `bash config/skills/team-leader/verify-output/execute.sh '${JSON.stringify({
+                    taskId: taskId || workerSessionName,
+                    workerId: workerSessionName,
+                    teamId: tlInfo.teamId,
+                    projectPath: process.cwd(),
+                })}'`,
+                '```',
+                '',
+                'If verification passes, report results via aggregate-results.',
+                'If verification fails, use handle-failure to retry or reassign.',
+            ].filter(Boolean).join('\n');
+            mqService.enqueue({
+                content: verifyInstruction,
+                conversationId: `auto-verify-${taskId || workerSessionName}-${Date.now()}`,
+                source: 'system_event',
+                sourceMetadata: {
+                    type: 'auto-verify',
+                    workerSession: workerSessionName,
+                    taskId,
+                },
+            });
+            this.logger.info('TL auto-verify triggered', {
+                workerSession: workerSessionName,
+                tlSession: tlInfo.tlSessionName,
+                teamId: tlInfo.teamId,
+                taskId,
+            });
+        }
+        catch (err) {
+            this.logger.debug('Failed to send verify request to TL (non-fatal)', {
+                error: err instanceof Error ? err.message : String(err),
+            });
+        }
+    }
+    /**
+     * Find the Team Leader for a given worker by looking up team hierarchy.
+     *
+     * @param workerSessionName - Worker's agent session name
+     * @param teamId - Optional team ID hint from the event
+     * @returns TL info or null if no hierarchical TL exists
+     */
+    async findTeamLeaderForWorker(workerSessionName, teamId) {
+        let teams = [];
+        if (this.teamsProvider) {
+            teams = await this.teamsProvider();
+        }
+        else {
+            // Fallback: load from API
+            try {
+                const axios = (await import('axios')).default;
+                const response = await axios.get('http://localhost:8787/api/teams');
+                teams = response.data?.data ?? [];
+            }
+            catch {
+                return null;
+            }
+        }
+        // Find the team containing this worker
+        for (const team of teams) {
+            if (!team.hierarchical)
+                continue;
+            if (teamId && team.id !== teamId)
+                continue;
+            const worker = team.members.find((m) => m.sessionName === workerSessionName);
+            if (!worker)
+                continue;
+            // Find the worker's parent (TL)
+            if (!worker.parentMemberId)
+                continue;
+            const tl = team.members.find((m) => m.id === worker.parentMemberId);
+            if (!tl)
+                continue;
+            return {
+                tlSessionName: tl.sessionName,
+                tlMemberId: tl.id,
+                teamId: team.id,
+            };
+        }
+        return null;
+    }
+}
+//# sourceMappingURL=tl-auto-verify.service.js.map

package/dist/backend/backend/src/services/v3/tl-auto-verify.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tl-auto-verify.service.js","sourceRoot":"","sources":["../../../../../../backend/src/services/v3/tl-auto-verify.service.ts"],"names":[],"mappings":"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"}