@iflow-mcp/jkheadley-instar 0.26.2

package/dist/scheduler/JobClaimManager.js

@@ -0,0 +1,283 @@
+/**
+ * JobClaimManager — Distributed job deduplication via AgentBus.
+ *
+ * Before executing a scheduled job, the owning machine broadcasts a
+ * `work-announcement` claim via AgentBus. Other machines see the claim
+ * and skip the job. When the job completes, a `work-complete` message
+ * signals other machines that the claim is released.
+ *
+ * Claim semantics:
+ *   - At-most-once execution with idempotency keys (claimId)
+ *   - Claims expire if no work-complete within timeout
+ *   - Partition mode: proceed independently when no peers are reachable
+ *   - Local ledger persisted to disk for crash recovery
+ *
+ * Part of Phase 4C (User-Agent Topology Spec — Gap 5).
+ */
+import crypto from 'node:crypto';
+import fs from 'node:fs';
+import path from 'node:path';
+import { EventEmitter } from 'node:events';
+// ── Constants ────────────────────────────────────────────────────────
+const DEFAULT_CLAIM_TIMEOUT_MS = 30 * 60_000; // 30 minutes
+const DEFAULT_PRUNE_INTERVAL_MS = 5 * 60_000; // 5 minutes
+const CLAIMS_FILE = 'job-claims.json';
+// ── JobClaimManager ──────────────────────────────────────────────────
+export class JobClaimManager extends EventEmitter {
+    bus;
+    machineId;
+    stateDir;
+    defaultClaimTimeoutMs;
+    pruneIntervalMs;
+    claims = new Map(); // keyed by jobSlug
+    claimsDir;
+    pruneTimer = null;
+    constructor(config) {
+        super();
+        this.bus = config.bus;
+        this.machineId = config.machineId;
+        this.stateDir = config.stateDir;
+        this.defaultClaimTimeoutMs = config.defaultClaimTimeoutMs ?? DEFAULT_CLAIM_TIMEOUT_MS;
+        this.pruneIntervalMs = config.pruneIntervalMs ?? DEFAULT_PRUNE_INTERVAL_MS;
+        this.claimsDir = path.join(config.stateDir, 'state');
+        if (!fs.existsSync(this.claimsDir)) {
+            fs.mkdirSync(this.claimsDir, { recursive: true });
+        }
+        // Load persisted claims on startup
+        this.loadClaims();
+        // Register AgentBus message handlers
+        this.registerHandlers();
+        // Start periodic claim pruning
+        this.startPruning();
+    }
+    // ── Claiming ────────────────────────────────────────────────────────
+    /**
+     * Attempt to claim a job before execution.
+     *
+     * Returns a `claimId` if the claim succeeds, or `null` if another
+     * machine already holds an active claim on this job.
+     *
+     * @param jobSlug - The job to claim.
+     * @param timeoutMs - Claim timeout (default: defaultClaimTimeoutMs).
+     */
+    async tryClaim(jobSlug, timeoutMs) {
+        // Prune expired claims first
+        this.pruneExpired();
+        // Check for active claim
+        const existing = this.claims.get(jobSlug);
+        if (existing && !existing.completed) {
+            // Someone already claimed this job and the claim is still active
+            if (existing.machineId === this.machineId) {
+                // We already claimed it — return existing claim
+                return existing.claimId;
+            }
+            // Another machine claimed it — reject
+            return null;
+        }
+        // Generate claim
+        const claimId = `claim_${crypto.randomBytes(8).toString('hex')}`;
+        const now = new Date();
+        const timeout = timeoutMs ?? this.defaultClaimTimeoutMs;
+        const expiresAt = new Date(now.getTime() + timeout).toISOString();
+        const claim = {
+            claimId,
+            jobSlug,
+            machineId: this.machineId,
+            claimedAt: now.toISOString(),
+            expiresAt,
+            completed: false,
+        };
+        // Record locally
+        this.claims.set(jobSlug, claim);
+        this.saveClaims();
+        // Broadcast via AgentBus
+        await this.bus.send({
+            type: 'work-announcement',
+            to: '*',
+            payload: {
+                claimId,
+                jobSlug,
+                machineId: this.machineId,
+                expiresAt,
+            },
+        });
+        return claimId;
+    }
+    /**
+     * Signal that a claimed job has completed.
+     *
+     * @param jobSlug - The job that completed.
+     * @param result - Success or failure.
+     */
+    async completeClaim(jobSlug, result) {
+        const claim = this.claims.get(jobSlug);
+        if (!claim || claim.machineId !== this.machineId)
+            return;
+        // Update local state
+        claim.completed = true;
+        claim.result = result;
+        claim.completedAt = new Date().toISOString();
+        this.saveClaims();
+        // Broadcast completion
+        await this.bus.send({
+            type: 'work-complete',
+            to: '*',
+            payload: {
+                claimId: claim.claimId,
+                jobSlug,
+                machineId: this.machineId,
+                result,
+            },
+        });
+    }
+    // ── Queries ─────────────────────────────────────────────────────────
+    /**
+     * Check if a job has an active (non-expired, non-completed) claim
+     * from another machine.
+     */
+    hasRemoteClaim(jobSlug) {
+        this.pruneExpired();
+        const claim = this.claims.get(jobSlug);
+        if (!claim)
+            return false;
+        if (claim.completed)
+            return false;
+        if (claim.machineId === this.machineId)
+            return false;
+        return true;
+    }
+    /**
+     * Get the active claim for a job (if any).
+     */
+    getClaim(jobSlug) {
+        this.pruneExpired();
+        return this.claims.get(jobSlug);
+    }
+    /**
+     * Get all active (non-expired, non-completed) claims.
+     */
+    getActiveClaims() {
+        this.pruneExpired();
+        return Array.from(this.claims.values()).filter(c => !c.completed);
+    }
+    /**
+     * Get all claims (including completed and expired for diagnostics).
+     */
+    getAllClaims() {
+        return Array.from(this.claims.values());
+    }
+    // ── Lifecycle ───────────────────────────────────────────────────────
+    /**
+     * Stop the claim manager (clear timers, save state).
+     */
+    destroy() {
+        if (this.pruneTimer) {
+            clearInterval(this.pruneTimer);
+            this.pruneTimer = null;
+        }
+        this.saveClaims();
+    }
+    // ── Private: Message Handlers ─────────────────────────────────────
+    registerHandlers() {
+        // Handle incoming job claims from other machines
+        this.bus.onMessage('work-announcement', (msg) => {
+            const payload = msg.payload;
+            // Only process claims with the expected shape (claimId + jobSlug)
+            if (!payload.claimId || !payload.jobSlug)
+                return;
+            const claim = {
+                claimId: payload.claimId,
+                jobSlug: payload.jobSlug,
+                machineId: payload.machineId,
+                claimedAt: msg.timestamp,
+                expiresAt: payload.expiresAt,
+                completed: false,
+            };
+            // Only accept if no existing non-expired claim from a different machine,
+            // or if the new claim supersedes (first-writer-wins by timestamp)
+            const existing = this.claims.get(payload.jobSlug);
+            if (!existing || existing.completed || this.isExpired(existing)) {
+                this.claims.set(payload.jobSlug, claim);
+                this.saveClaims();
+                this.emit('claim-received', claim);
+            }
+            // If there's an existing active claim, the first claimer wins
+        });
+        // Handle incoming job completions from other machines
+        this.bus.onMessage('work-complete', (msg) => {
+            const payload = msg.payload;
+            if (!payload.claimId || !payload.jobSlug)
+                return;
+            const claim = this.claims.get(payload.jobSlug);
+            if (claim && claim.claimId === payload.claimId) {
+                claim.completed = true;
+                claim.result = payload.result;
+                claim.completedAt = msg.timestamp;
+                this.saveClaims();
+                this.emit('complete-received', payload);
+            }
+        });
+    }
+    // ── Private: Pruning ──────────────────────────────────────────────
+    startPruning() {
+        this.pruneTimer = setInterval(() => {
+            this.pruneExpired();
+        }, this.pruneIntervalMs);
+        if (this.pruneTimer.unref) {
+            this.pruneTimer.unref();
+        }
+    }
+    /**
+     * Remove expired and completed claims from the ledger.
+     * Expired claims are claims where expiresAt has passed and no
+     * work-complete was received — the claiming machine may have crashed.
+     */
+    pruneExpired() {
+        const now = Date.now();
+        let pruned = 0;
+        for (const [slug, claim] of this.claims) {
+            if (claim.completed) {
+                // Completed claims: remove after 1 hour (for diagnostics retention)
+                const completedAt = claim.completedAt ? new Date(claim.completedAt).getTime() : now;
+                if (now - completedAt > 60 * 60_000) {
+                    this.claims.delete(slug);
+                    pruned++;
+                }
+            }
+            else if (this.isExpired(claim)) {
+                // Expired claims: remove and emit event
+                this.claims.delete(slug);
+                this.emit('claim-expired', claim);
+                pruned++;
+            }
+        }
+        if (pruned > 0) {
+            this.saveClaims();
+        }
+        return pruned;
+    }
+    isExpired(claim) {
+        return Date.now() > new Date(claim.expiresAt).getTime();
+    }
+    // ── Private: Persistence ──────────────────────────────────────────
+    loadClaims() {
+        const filePath = path.join(this.claimsDir, CLAIMS_FILE);
+        try {
+            const content = fs.readFileSync(filePath, 'utf-8');
+            const data = JSON.parse(content);
+            this.claims.clear();
+            for (const claim of data) {
+                this.claims.set(claim.jobSlug, claim);
+            }
+        }
+        catch {
+            // File may not exist yet — start with empty ledger
+        }
+    }
+    saveClaims() {
+        const filePath = path.join(this.claimsDir, CLAIMS_FILE);
+        const data = Array.from(this.claims.values());
+        fs.writeFileSync(filePath, JSON.stringify(data, null, 2) + '\n');
+    }
+}
+//# sourceMappingURL=JobClaimManager.js.map

package/dist/scheduler/JobClaimManager.js.map

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

package/dist/scheduler/JobLoader.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Job Loader — read and validate job definitions from a JSON file.
+ *
+ * Jobs define recurring work the agent should perform:
+ * email checks, health probes, content publishing, etc.
+ *
+ * Grounding-by-default: Jobs are validated for grounding configuration.
+ * Missing grounding emits warnings — nudging the practice without breaking
+ * existing jobs. Jobs that process external input WITHOUT grounding get
+ * louder warnings because they represent a security surface.
+ */
+import type { JobDefinition } from '../core/types.js';
+/**
+ * Load and validate job definitions from a JSON file.
+ * Throws on invalid structure — fail loud at startup, not at runtime.
+ */
+export declare function loadJobs(jobsFile: string): JobDefinition[];
+/**
+ * Validate a single job definition.
+ * Throws with a descriptive message on any issue.
+ */
+export declare function validateJob(job: unknown, index?: number): void;
+/**
+ * Validate commonBlockers configuration structure.
+ * CommonBlockers are Record<string, CommonBlocker> — keyed object of pre-confirmed resolutions.
+ */
+export declare function validateCommonBlockers(blockers: unknown, prefix: string): void;
+//# sourceMappingURL=JobLoader.d.ts.map

package/dist/scheduler/JobLoader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"JobLoader.d.ts","sourceRoot":"","sources":["../../src/scheduler/JobLoader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,OAAO,KAAK,EAAE,aAAa,EAA0B,MAAM,kBAAkB,CAAC;AAe9E;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,aAAa,EAAE,CAyB1D;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAkG9D;AA4CD;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAqF9E"}

package/dist/scheduler/JobLoader.js

@@ -0,0 +1,269 @@
+/**
+ * Job Loader — read and validate job definitions from a JSON file.
+ *
+ * Jobs define recurring work the agent should perform:
+ * email checks, health probes, content publishing, etc.
+ *
+ * Grounding-by-default: Jobs are validated for grounding configuration.
+ * Missing grounding emits warnings — nudging the practice without breaking
+ * existing jobs. Jobs that process external input WITHOUT grounding get
+ * louder warnings because they represent a security surface.
+ */
+import fs from 'node:fs';
+import { Cron } from 'croner';
+const VALID_PRIORITIES = ['critical', 'high', 'medium', 'low'];
+const VALID_MODELS = ['opus', 'sonnet', 'haiku'];
+/** Slugs for lightweight default jobs where grounding is unnecessary. */
+const GROUNDING_EXEMPT_SLUGS = new Set([
+    'health-check',
+    'feedback-retry',
+    'dispatch-check',
+    'update-check',
+    'project-map-refresh',
+    'git-sync',
+]);
+/**
+ * Load and validate job definitions from a JSON file.
+ * Throws on invalid structure — fail loud at startup, not at runtime.
+ */
+export function loadJobs(jobsFile) {
+    if (!fs.existsSync(jobsFile)) {
+        throw new Error(`Jobs file not found: ${jobsFile}`);
+    }
+    let raw;
+    try {
+        raw = JSON.parse(fs.readFileSync(jobsFile, 'utf-8'));
+    }
+    catch (err) {
+        throw new Error(`Failed to parse jobs file ${jobsFile}: ${err instanceof Error ? err.message : String(err)}`);
+    }
+    if (!Array.isArray(raw)) {
+        throw new Error(`Jobs file must contain a JSON array, got ${typeof raw}`);
+    }
+    const jobs = raw.map((job, index) => {
+        validateJob(job, index);
+        return job;
+    });
+    // Grounding-by-default audit — warn about jobs missing grounding config
+    auditGrounding(jobs);
+    return jobs;
+}
+/**
+ * Validate a single job definition.
+ * Throws with a descriptive message on any issue.
+ */
+export function validateJob(job, index) {
+    const prefix = index !== undefined ? `Job[${index}]` : 'Job';
+    if (!job || typeof job !== 'object') {
+        throw new Error(`${prefix}: must be an object`);
+    }
+    const j = job;
+    // Required string fields
+    for (const field of ['slug', 'name', 'description', 'schedule']) {
+        if (typeof j[field] !== 'string' || !j[field].trim()) {
+            throw new Error(`${prefix}: "${field}" is required and must be a non-empty string`);
+        }
+    }
+    // Slug format — used in file paths and URLs, must be safe
+    if (!/^[a-zA-Z0-9_-]{1,100}$/.test(j.slug)) {
+        throw new Error(`${prefix}: "slug" must contain only letters, numbers, hyphens, underscores (max 100 chars)`);
+    }
+    // Priority
+    if (!VALID_PRIORITIES.includes(j.priority)) {
+        throw new Error(`${prefix}: "priority" must be one of ${VALID_PRIORITIES.join(', ')}, got "${j.priority}"`);
+    }
+    // Model tier (optional — defaults to the agent's preferred model)
+    if (j.model !== undefined && !VALID_MODELS.includes(j.model)) {
+        throw new Error(`${prefix}: "model" must be one of ${VALID_MODELS.join(', ')}, got "${j.model}"`);
+    }
+    // Cron expression — try to parse it (validate only, don't leave running)
+    try {
+        const testCron = new Cron(j.schedule);
+        testCron.stop();
+    }
+    catch (err) {
+        throw new Error(`${prefix}: invalid cron expression "${j.schedule}": ${err}`);
+    }
+    // Enabled must be boolean
+    if (typeof j.enabled !== 'boolean') {
+        throw new Error(`${prefix}: "enabled" must be a boolean`);
+    }
+    // Execute block
+    if (!j.execute || typeof j.execute !== 'object') {
+        throw new Error(`${prefix}: "execute" must be an object with type and value`);
+    }
+    const exec = j.execute;
+    if (!['skill', 'prompt', 'script'].includes(exec.type)) {
+        throw new Error(`${prefix}: execute.type must be "skill", "prompt", or "script"`);
+    }
+    if (typeof exec.value !== 'string' || !exec.value.trim()) {
+        throw new Error(`${prefix}: execute.value is required`);
+    }
+    // Optional args must be a string if present
+    if (exec.args !== undefined && typeof exec.args !== 'string') {
+        throw new Error(`${prefix}: execute.args must be a string if provided, got ${typeof exec.args}`);
+    }
+    // Optional gate must be a string if present
+    if (j.gate !== undefined && typeof j.gate !== 'string') {
+        throw new Error(`${prefix}: "gate" must be a string (shell command) if provided, got ${typeof j.gate}`);
+    }
+    // telegramNotify — boolean or 'on-alert'
+    if (j.telegramNotify !== undefined) {
+        if (typeof j.telegramNotify !== 'boolean' && j.telegramNotify !== 'on-alert') {
+            throw new Error(`${prefix}: "telegramNotify" must be true, false, or "on-alert" if provided, got "${j.telegramNotify}"`);
+        }
+    }
+    // Machine scope — optional array of machine IDs or names
+    if (j.machines !== undefined) {
+        if (!Array.isArray(j.machines)) {
+            throw new Error(`${prefix}: "machines" must be an array of machine IDs or names if provided`);
+        }
+        for (const m of j.machines) {
+            if (typeof m !== 'string' || !m.trim()) {
+                throw new Error(`${prefix}: "machines" entries must be non-empty strings`);
+            }
+        }
+    }
+    // Grounding config — validate structure if present
+    if (j.grounding !== undefined) {
+        validateGrounding(j.grounding, prefix);
+    }
+    // CommonBlockers — validate structure if present
+    if (j.commonBlockers !== undefined) {
+        validateCommonBlockers(j.commonBlockers, prefix);
+    }
+}
+/**
+ * Validate grounding configuration structure.
+ * Throws on invalid structure — if you're going to declare grounding, do it right.
+ */
+function validateGrounding(grounding, prefix) {
+    if (!grounding || typeof grounding !== 'object') {
+        throw new Error(`${prefix}: "grounding" must be an object if provided`);
+    }
+    const g = grounding;
+    if (typeof g.requiresIdentity !== 'boolean') {
+        throw new Error(`${prefix}: grounding.requiresIdentity must be a boolean`);
+    }
+    if (g.processesExternalInput !== undefined && typeof g.processesExternalInput !== 'boolean') {
+        throw new Error(`${prefix}: grounding.processesExternalInput must be a boolean if provided`);
+    }
+    if (g.contextFiles !== undefined) {
+        if (!Array.isArray(g.contextFiles)) {
+            throw new Error(`${prefix}: grounding.contextFiles must be an array of strings if provided`);
+        }
+        for (const f of g.contextFiles) {
+            if (typeof f !== 'string' || !f.trim()) {
+                throw new Error(`${prefix}: grounding.contextFiles entries must be non-empty strings`);
+            }
+        }
+    }
+    if (g.questions !== undefined) {
+        if (!Array.isArray(g.questions)) {
+            throw new Error(`${prefix}: grounding.questions must be an array of strings if provided`);
+        }
+        for (const q of g.questions) {
+            if (typeof q !== 'string' || !q.trim()) {
+                throw new Error(`${prefix}: grounding.questions entries must be non-empty strings`);
+            }
+        }
+    }
+}
+/**
+ * Validate commonBlockers configuration structure.
+ * CommonBlockers are Record<string, CommonBlocker> — keyed object of pre-confirmed resolutions.
+ */
+export function validateCommonBlockers(blockers, prefix) {
+    if (!blockers || typeof blockers !== 'object' || Array.isArray(blockers)) {
+        throw new Error(`${prefix}: "commonBlockers" must be a plain object (Record<string, CommonBlocker>) if provided`);
+    }
+    const b = blockers;
+    const keys = Object.keys(b);
+    if (keys.length > 20) {
+        throw new Error(`${prefix}: "commonBlockers" has ${keys.length} entries, max is 20`);
+    }
+    for (const key of keys) {
+        const entry = b[key];
+        if (!entry || typeof entry !== 'object' || Array.isArray(entry)) {
+            throw new Error(`${prefix}: commonBlockers["${key}"] must be an object`);
+        }
+        const e = entry;
+        // Required fields
+        if (typeof e.description !== 'string' || !e.description.toString().trim()) {
+            throw new Error(`${prefix}: commonBlockers["${key}"] "description" is required and must be a non-empty string`);
+        }
+        if (typeof e.resolution !== 'string' || !e.resolution.toString().trim()) {
+            throw new Error(`${prefix}: commonBlockers["${key}"] "resolution" is required and must be a non-empty string`);
+        }
+        // Status (optional — defaults to 'confirmed' at runtime)
+        if (e.status !== undefined) {
+            const validStatuses = ['confirmed', 'pending', 'expired'];
+            if (typeof e.status !== 'string' || !validStatuses.includes(e.status)) {
+                throw new Error(`${prefix}: commonBlockers["${key}"] "status" must be one of ${validStatuses.join(', ')}, got "${e.status}"`);
+            }
+        }
+        // Optional fields
+        if (e.toolsNeeded !== undefined) {
+            if (!Array.isArray(e.toolsNeeded)) {
+                throw new Error(`${prefix}: commonBlockers["${key}"] "toolsNeeded" must be an array of strings if provided`);
+            }
+            for (const t of e.toolsNeeded) {
+                if (typeof t !== 'string') {
+                    throw new Error(`${prefix}: commonBlockers["${key}"] "toolsNeeded" entries must be strings`);
+                }
+            }
+        }
+        if (e.credentials !== undefined) {
+            if (typeof e.credentials !== 'string' && !Array.isArray(e.credentials)) {
+                throw new Error(`${prefix}: commonBlockers["${key}"] "credentials" must be a string or array of strings if provided`);
+            }
+            if (Array.isArray(e.credentials)) {
+                for (const c of e.credentials) {
+                    if (typeof c !== 'string') {
+                        throw new Error(`${prefix}: commonBlockers["${key}"] "credentials" entries must be strings`);
+                    }
+                }
+            }
+        }
+        if (e.addedFrom !== undefined && typeof e.addedFrom !== 'string') {
+            throw new Error(`${prefix}: commonBlockers["${key}"] "addedFrom" must be a string if provided`);
+        }
+        if (e.addedAt !== undefined && typeof e.addedAt !== 'string') {
+            throw new Error(`${prefix}: commonBlockers["${key}"] "addedAt" must be a string (ISO date) if provided`);
+        }
+        if (e.confirmedAt !== undefined && typeof e.confirmedAt !== 'string') {
+            throw new Error(`${prefix}: commonBlockers["${key}"] "confirmedAt" must be a string (ISO date) if provided`);
+        }
+        if (e.expiresAt !== undefined && typeof e.expiresAt !== 'string') {
+            throw new Error(`${prefix}: commonBlockers["${key}"] "expiresAt" must be a string (ISO date) if provided`);
+        }
+        if (e.lastUsedAt !== undefined && typeof e.lastUsedAt !== 'string') {
+            throw new Error(`${prefix}: commonBlockers["${key}"] "lastUsedAt" must be a string (ISO date) if provided`);
+        }
+        if (e.successCount !== undefined && typeof e.successCount !== 'number') {
+            throw new Error(`${prefix}: commonBlockers["${key}"] "successCount" must be a number if provided`);
+        }
+    }
+}
+/**
+ * Audit loaded jobs for grounding configuration.
+ * Emits warnings for jobs missing grounding — the "nudge" layer.
+ * Exempt jobs (health-check, dispatch-check, etc.) are skipped silently.
+ */
+function auditGrounding(jobs) {
+    const ungrounded = [];
+    for (const job of jobs) {
+        if (!job.enabled)
+            continue;
+        if (GROUNDING_EXEMPT_SLUGS.has(job.slug))
+            continue;
+        if (!job.grounding) {
+            ungrounded.push(job.slug);
+        }
+    }
+    if (ungrounded.length > 0) {
+        console.warn(`[JobLoader] Grounding audit: ${ungrounded.length} enabled job(s) lack grounding config: ${ungrounded.join(', ')}. ` +
+            `Add a "grounding" field to declare identity and security requirements.`);
+    }
+}
+//# sourceMappingURL=JobLoader.js.map

package/dist/scheduler/JobLoader.js.map

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