@donna-orchestrator/bridge 0.2.21

package/dist/index.js

@@ -0,0 +1,248 @@
+/**
+ * Apple Platform Bridge — entry point (#294).
+ *
+ * Library form of the bridge: connect to the orchestrator, advertise the
+ * `apple_platform: true` capability, dispatch incoming work, refuse non-Apple
+ * dispatches with `runner:scope_violation`. No CLI surface (#295), no
+ * LaunchAgent (#295), no publish setup (#296) — those layer on top.
+ *
+ * The WS connection loop mirrors `runner/native/connection.ts`:
+ *  - `Authorization: Bearer <token>` header (paired runners only, per #272).
+ *  - Indefinite reconnect with exponential backoff capped at 30s.
+ *
+ * The bridge is single-purpose: every `runner:execute` is gated by
+ * `scope-guard.isAppleStage`. Refused dispatches reply with
+ * `runner:scope_violation` and return to idle without retrying.
+ */
+import WebSocket from 'ws';
+import { executeBridgeCLI } from './executor.js';
+import { isAppleStage } from './scope-guard.js';
+const RECONNECT_CAP_MS = 30_000;
+const SCOPE_VIOLATION_MESSAGE = 'donna-bridge accepts only Apple platform projects. This dispatch was rejected.';
+export function runBridge(opts) {
+    const { config, workspace, onStateChange } = opts;
+    const WS = opts.webSocketImpl || WebSocket;
+    let ws = null;
+    let reconnectAttempts = 0;
+    let stopped = false;
+    let reconnectTimer = null;
+    function safeSend(payload) {
+        if (!ws || ws.readyState !== WebSocket.OPEN)
+            return;
+        ws.send(JSON.stringify(payload));
+    }
+    function sendScopeViolation(cardId) {
+        safeSend({
+            type: 'runner:scope_violation',
+            payload: {
+                cardId,
+                reason: 'not_apple_platform',
+                message: SCOPE_VIOLATION_MESSAGE,
+            },
+        });
+    }
+    async function handleExecute(payload) {
+        if (!isAppleStage(payload)) {
+            console.log(`🚫 Bridge ${config.runnerId}: refusing non-Apple dispatch card=${payload.cardId.slice(0, 8)} stage=${payload.stage}`);
+            sendScopeViolation(payload.cardId);
+            return;
+        }
+        const startTime = Date.now();
+        let usageData = null;
+        try {
+            const exitCode = await executeBridgeCLI({
+                payload,
+                config,
+                onOutput: (chunk, kind) => {
+                    safeSend({
+                        type: 'runner:output',
+                        payload: { cardId: payload.cardId, chunk, kind },
+                    });
+                },
+                onUsage: (usage) => {
+                    usageData = usage;
+                },
+                onRateLimit: () => {
+                    safeSend({ type: 'runner:rate_limit', payload: { cardId: payload.cardId } });
+                },
+            });
+            const duration = Date.now() - startTime;
+            safeSend({
+                type: 'runner:command_complete',
+                payload: {
+                    cardId: payload.cardId,
+                    exitCode,
+                    duration,
+                    usage: usageData || undefined,
+                },
+            });
+        }
+        catch (err) {
+            const errMsg = err instanceof Error ? err.message : String(err);
+            console.error(`❌ Bridge ${config.runnerId}: execute failed card=${payload.cardId.slice(0, 8)}: ${errMsg}`);
+            safeSend({
+                type: 'runner:command_error',
+                payload: { cardId: payload.cardId, error: errMsg },
+            });
+        }
+    }
+    async function handleSetupWorkspace(req) {
+        try {
+            const result = await workspace.setup(req);
+            if (result.ok) {
+                safeSend({
+                    type: 'runner:workspace_ready',
+                    payload: { cardId: req.cardId, workDir: result.workDir, commit: result.commit },
+                });
+            }
+            else {
+                safeSend({
+                    type: 'runner:workspace_error',
+                    payload: { cardId: req.cardId, errorClass: result.errorClass, error: result.error },
+                });
+            }
+        }
+        catch (err) {
+            const errMsg = err instanceof Error ? err.message : String(err);
+            safeSend({
+                type: 'runner:workspace_error',
+                payload: { cardId: req.cardId, errorClass: 'unknown', error: `setup threw: ${errMsg}` },
+            });
+        }
+    }
+    async function handleCleanupWorkspace(req) {
+        try {
+            await workspace.cleanup(req);
+        }
+        catch (err) {
+            console.error(`❌ Bridge ${config.runnerId}: cleanup threw for card=${req.cardId.slice(0, 8)}:`, err instanceof Error ? err.message : err);
+        }
+    }
+    function handleMessage(msg) {
+        if (msg.type !== 'runner:ping') {
+            console.log(`💬 Bridge ${config.runnerId}: received ${msg.type}`);
+        }
+        switch (msg.type) {
+            case 'runner:ping':
+                safeSend({ type: 'runner:pong' });
+                break;
+            case 'runner:health_check':
+                // Minimal health-ack — the CLI layer (#295) will re-probe Xcode and
+                // claude here. The bridge core just confirms it's alive.
+                safeSend({
+                    type: 'runner:health_check_ack',
+                    payload: {
+                        nonce: msg.payload.nonce,
+                        claudeCli: { ok: true },
+                        timestamp: new Date().toISOString(),
+                    },
+                });
+                break;
+            case 'runner:shutdown':
+                console.log(`🛑 Bridge ${config.runnerId}: orchestrator requested shutdown: ${msg.payload.reason}`);
+                stopped = true;
+                ws?.close();
+                break;
+            case 'runner:execute':
+                void handleExecute(msg.payload);
+                break;
+            case 'runner:setup_workspace':
+                void handleSetupWorkspace(msg.payload);
+                break;
+            case 'runner:cleanup_workspace':
+                void handleCleanupWorkspace(msg.payload);
+                break;
+            default: {
+                // Unknown / unsupported message — log and ignore. We deliberately do
+                // NOT acknowledge so the orchestrator's protocol-version drift is
+                // visible in its own logs.
+                const t = msg.type ?? 'unknown';
+                console.warn(`⚠️  Bridge ${config.runnerId}: ignoring unsupported message type=${t}`);
+            }
+        }
+    }
+    function connect() {
+        if (stopped)
+            return;
+        onStateChange?.('connecting');
+        console.log(`🔌 Bridge ${config.runnerId}: connecting to ${config.orchestratorUrl}`);
+        ws = new WS(config.orchestratorUrl, {
+            headers: { Authorization: `Bearer ${config.token}` },
+        });
+        ws.on('open', () => {
+            console.log(`🟢 Bridge ${config.runnerId}: connected`);
+            reconnectAttempts = 0;
+            onStateChange?.('connected');
+            // Hello payload — advertise the Apple-platform capability that #293's
+            // matcher routes on, plus the standard tool versions block.
+            safeSend({
+                type: 'runner:hello',
+                payload: {
+                    runnerId: config.runnerId,
+                    runnerType: 'native-macos',
+                    platform: 'darwin',
+                    arch: process.arch === 'arm64' ? 'arm64' : 'x86_64',
+                    capabilities: {
+                        apple_platform: true,
+                        // Top-level claude_cli flag for parity with #260's handshake check.
+                        // The CLI layer (#295) probes the binary; here we trust the config.
+                        claude_cli: true,
+                        tools: config.tools || {},
+                    },
+                    image: null,
+                },
+            });
+        });
+        ws.on('message', (data) => {
+            let msg;
+            try {
+                msg = JSON.parse(data.toString());
+            }
+            catch (err) {
+                console.error(`❌ Bridge ${config.runnerId}: failed to parse message:`, err);
+                return;
+            }
+            try {
+                handleMessage(msg);
+            }
+            catch (err) {
+                console.error(`❌ Bridge ${config.runnerId}: handler threw:`, err);
+            }
+        });
+        ws.on('close', () => {
+            console.log(`🔴 Bridge ${config.runnerId}: disconnected`);
+            onStateChange?.('disconnected');
+            ws = null;
+            attemptReconnect();
+        });
+        ws.on('error', (err) => {
+            console.error(`❌ Bridge ${config.runnerId}: WS error:`, err.message);
+        });
+    }
+    function attemptReconnect() {
+        if (stopped)
+            return;
+        const delay = Math.min(1000 * Math.pow(2, reconnectAttempts), RECONNECT_CAP_MS);
+        reconnectAttempts++;
+        console.log(`🔄 Bridge ${config.runnerId}: reconnecting in ${delay}ms (attempt ${reconnectAttempts})`);
+        reconnectTimer = setTimeout(connect, delay);
+    }
+    connect();
+    return {
+        close() {
+            stopped = true;
+            if (reconnectTimer) {
+                clearTimeout(reconnectTimer);
+                reconnectTimer = null;
+            }
+            try {
+                ws?.close();
+            }
+            catch {
+                // ignore
+            }
+            ws = null;
+        },
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/install.js

@@ -0,0 +1,194 @@
+/**
+ * `donna-bridge install` flow (#295).
+ *
+ * Six steps, per the spec:
+ *   1. Pre-flight: claude / xcodebuild / git / node ≥ 22
+ *   2. Probe Xcode + simctl + swift → write `~/.donna-bridge/tool-report.json`
+ *   3. Pair with the orchestrator (remote 6-digit code OR `--local-pair`)
+ *   4. Persist config → `~/.donna-bridge/config.json`
+ *   5. Render + install LaunchAgent plist + `launchctl bootstrap`
+ *   6. Print summary
+ *
+ * Each step has a clear error surface: pre-flight failures list every missing
+ * tool's install hint; pairing failures show the HTTP status; LaunchAgent
+ * failures surface the `launchctl` stderr.
+ */
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { defaultConfig, getConfigPath, getDefaults, saveConfig, } from './config.js';
+import { runPreflight, formatPreflightTable } from './preflight.js';
+import { runXcodeProbe } from './xcode-probe.js';
+import { pairLocally, pairWithCode } from './pair.js';
+import { installPlist, loadAgent, renderBridgePlist } from './launchd.js';
+function defaultIO() {
+    return {
+        stdout: (m) => process.stdout.write(m),
+        stderr: (m) => process.stderr.write(m),
+    };
+}
+/** Slugify the hostname to a stable runner-id (matches runner-side rules). */
+export function hostnameRunnerId(hostname = os.hostname()) {
+    let slug = hostname.toLowerCase().replace(/[^a-z0-9-]+/g, '-').replace(/^-+|-+$/g, '');
+    if (slug.length < 3)
+        slug = `bridge-${slug || 'host'}`.slice(0, 64);
+    if (slug.length > 64)
+        slug = slug.slice(0, 64);
+    slug = slug.replace(/^-+|-+$/g, '');
+    if (slug.length < 3)
+        slug = `bridge-${slug || 'host'}`.slice(0, 64);
+    return slug;
+}
+/**
+ * Pick the active Xcode bundle from a probe report. Priority:
+ *   1. The bundle whose `developerDir` matches the system `xcode-select -p`
+ *      pointer (handled at the install layer — we don't shell out here).
+ *   2. The first bundle that has a version (probe succeeded).
+ *   3. The first bundle, period.
+ *
+ * Returns `null` when no Xcode bundles are present.
+ */
+export function pickActiveXcode(report) {
+    if (report.xcodeBundles.length === 0)
+        return null;
+    const versioned = report.xcodeBundles.find((b) => b.version);
+    const pick = versioned ?? report.xcodeBundles[0];
+    return { path: pick.path, developerDir: pick.developerDir };
+}
+export async function runInstall(opts) {
+    const io = opts.io ?? defaultIO();
+    io.stdout(`\ndonna-bridge install\n`);
+    // ── 1. Pre-flight ──
+    io.stdout(`\nStep 1/5: pre-flight check\n`);
+    const preflight = await runPreflight();
+    io.stdout(formatPreflightTable(preflight));
+    if (!preflight.ok) {
+        io.stderr(`\nPre-flight failed. Install the listed tool(s) and re-run \`donna-bridge install\`.\n`);
+        return { ok: false, preflight, error: 'preflight_failed' };
+    }
+    // ── 2. Probe Xcode + simulators + Swift ──
+    io.stdout(`\nStep 2/5: probing Xcode, simulators, and Swift\n`);
+    const toolReport = await runXcodeProbe();
+    const xcodeChoice = pickActiveXcode(toolReport);
+    if (!xcodeChoice) {
+        io.stderr(`No Xcode.app bundle found in /Applications. Install Xcode from the App Store.\n`);
+        return {
+            ok: false,
+            preflight,
+            toolReport,
+            error: 'no_xcode_bundle',
+        };
+    }
+    io.stdout(`  Xcode bundles: ${toolReport.xcodeBundles.length}\n`);
+    io.stdout(`  Active Xcode: ${xcodeChoice.path}\n`);
+    io.stdout(`  Simulator runtimes: ${toolReport.simulatorRuntimes.length}\n`);
+    io.stdout(`  Report saved to ${path.join(path.dirname(getConfigPath()), 'tool-report.json')}\n`);
+    // ── 3. Pair ──
+    io.stdout(`\nStep 3/5: pairing with orchestrator at ${opts.orchestratorUrl}\n`);
+    const runnerId = opts.runnerId || hostnameRunnerId();
+    let pairResponse;
+    try {
+        if (opts.localPair) {
+            pairResponse = await pairLocally({
+                orchestratorUrl: opts.orchestratorUrl,
+                runnerId,
+                fetchImpl: opts.fetchImpl,
+            });
+        }
+        else {
+            if (!opts.pairingCode) {
+                const err = '--pairing-code is required (or pass --local-pair for loopback installs)';
+                io.stderr(`${err}\n`);
+                return { ok: false, preflight, toolReport, error: err };
+            }
+            pairResponse = await pairWithCode({
+                orchestratorUrl: opts.orchestratorUrl,
+                pairingCode: opts.pairingCode,
+                runnerId,
+                fetchImpl: opts.fetchImpl,
+            });
+        }
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        io.stderr(`Pairing failed: ${message}\n`);
+        return { ok: false, preflight, toolReport, error: message };
+    }
+    io.stdout(`  Paired as ${pairResponse.runner_id}\n`);
+    // ── 4. Persist config ──
+    const config = {
+        ...defaultConfig(opts.orchestratorUrl, pairResponse.token, pairResponse.runner_id),
+        xcodePath: xcodeChoice.developerDir,
+        simulatorDeviceSetPath: getDefaults().deviceSetPath,
+        bridgeBin: opts.bridgeBin,
+    };
+    saveConfig(config);
+    io.stdout(`  Config saved to ${getConfigPath()}\n`);
+    // Make sure the simulator device set dir exists. simctl will populate it
+    // on first use — we just create the dir with the right perms.
+    try {
+        fs.mkdirSync(config.simulatorDeviceSetPath, { recursive: true, mode: 0o700 });
+    }
+    catch {
+        /* best-effort */
+    }
+    // Same for the log dir + the projects dir.
+    const defaults = getDefaults();
+    try {
+        fs.mkdirSync(path.dirname(defaults.logPath), { recursive: true, mode: 0o755 });
+    }
+    catch {
+        /* best-effort */
+    }
+    try {
+        fs.mkdirSync(defaults.projectsDir, { recursive: true, mode: 0o755 });
+    }
+    catch {
+        /* best-effort */
+    }
+    // ── 5. LaunchAgent ──
+    io.stdout(`\nStep 4/5: installing LaunchAgent\n`);
+    if (opts.skipLaunchAgent) {
+        io.stdout(`  (skipped — --skip-launch-agent or running in test mode)\n`);
+    }
+    else {
+        const bridgeBin = opts.bridgeBin || process.execPath;
+        if (!path.isAbsolute(bridgeBin)) {
+            io.stderr(`Refusing to write a relative bridgeBin into the plist: ${bridgeBin}\n`);
+            return { ok: false, preflight, toolReport, error: 'bridge_bin_not_absolute' };
+        }
+        const plistContents = renderBridgePlist({
+            label: defaults.label,
+            program: bridgeBin,
+            args: ['start'],
+            envVars: {},
+            stdoutPath: defaults.logPath,
+            stderrPath: defaults.logPath,
+        });
+        installPlist(defaults.plistPath, plistContents);
+        io.stdout(`  Plist installed at ${defaults.plistPath}\n`);
+        try {
+            await loadAgent(defaults.plistPath, os.userInfo().uid);
+            io.stdout(`  LaunchAgent loaded (gui/${os.userInfo().uid}/${defaults.label})\n`);
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            io.stderr(`Failed to load LaunchAgent: ${message}\n`);
+            return { ok: false, preflight, toolReport, config, error: message };
+        }
+    }
+    // ── 6. Summary ──
+    io.stdout(`\nStep 5/5: summary\n`);
+    io.stdout(`  Orchestrator:           ${opts.orchestratorUrl}\n`);
+    io.stdout(`  Runner ID:              ${pairResponse.runner_id}\n`);
+    io.stdout(`  Active Xcode:           ${xcodeChoice.path}\n`);
+    io.stdout(`  DEVELOPER_DIR:          ${xcodeChoice.developerDir}\n`);
+    io.stdout(`  Simulator device set:   ${config.simulatorDeviceSetPath}\n`);
+    io.stdout(`  Logs:                   ${defaults.logPath}\n`);
+    io.stdout(`  Projects root:          ${defaults.projectsDir}\n`);
+    io.stdout(`\n  The bridge accepts ONLY Apple-platform stages. Non-Apple\n`);
+    io.stdout(`  dispatches are refused via runner:scope_violation.\n`);
+    io.stdout(`\n  Run \`donna-bridge status\` to verify the LaunchAgent is loaded.\n\n`);
+    return { ok: true, preflight, toolReport, config };
+}
+//# sourceMappingURL=install.js.map

package/dist/install.js.map

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

package/dist/launchd.js

@@ -0,0 +1,146 @@
+/**
+ * LaunchAgent lifecycle for the bridge (#295).
+ *
+ * Renders `~/Library/LaunchAgents/net.donna.bridge.plist`, loads it via
+ * `launchctl bootstrap gui/<uid>`, and tears it back down via
+ * `launchctl bootout`. Mirrors `runner/native/launchd.ts` so the two
+ * components share the same plist-rendering / `bootstrap`-vs-`bootout`
+ * conventions — but kept here so `bridge/` has no `runner/` imports.
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import { execFile } from 'node:child_process';
+import { fileURLToPath } from 'node:url';
+const EXEC_TIMEOUT_MS = 10_000;
+function execFileNoThrow(bin, args) {
+    return new Promise((resolve, reject) => {
+        execFile(bin, args, { timeout: EXEC_TIMEOUT_MS, encoding: 'utf-8' }, (err, stdout, stderr) => {
+            if (err) {
+                const code = err.code;
+                if (code === 'ENOENT' || code === 'EACCES') {
+                    reject(err);
+                    return;
+                }
+                const numericCode = err.code;
+                const exitCode = typeof numericCode === 'number' ? numericCode : 1;
+                resolve({ stdout: stdout ?? '', stderr: stderr ?? '', exitCode });
+                return;
+            }
+            resolve({ stdout: stdout ?? '', stderr: stderr ?? '', exitCode: 0 });
+        });
+    });
+}
+function execFileStrict(bin, args) {
+    return new Promise((resolve, reject) => {
+        execFile(bin, args, { timeout: EXEC_TIMEOUT_MS, encoding: 'utf-8' }, (err, stdout, stderr) => {
+            if (err) {
+                const e = err;
+                e.stdout = stdout ?? '';
+                e.stderr = stderr ?? '';
+                reject(e);
+                return;
+            }
+            resolve({ stdout: stdout ?? '', stderr: stderr ?? '', exitCode: 0 });
+        });
+    });
+}
+function findTemplatePath() {
+    const here = path.dirname(fileURLToPath(import.meta.url));
+    // Source and packaged forms — covers both `tsx`-imported source and the
+    // compiled tree under `dist/bridge/`.
+    const candidates = [
+        path.join(here, 'templates', 'launchagent-bridge.plist.template'),
+        path.join(here, '..', '..', 'bridge', 'templates', 'launchagent-bridge.plist.template'),
+    ];
+    for (const c of candidates) {
+        if (fs.existsSync(c))
+            return c;
+    }
+    throw new Error(`launchagent-bridge.plist.template not found (searched: ${candidates.join(', ')})`);
+}
+let cachedTemplate;
+function loadTemplate() {
+    if (cachedTemplate === undefined) {
+        cachedTemplate = fs.readFileSync(findTemplatePath(), 'utf-8');
+    }
+    return cachedTemplate;
+}
+function xmlEscape(s) {
+    return s
+        .replace(/&/g, '&amp;')
+        .replace(/</g, '&lt;')
+        .replace(/>/g, '&gt;')
+        .replace(/"/g, '&quot;')
+        .replace(/'/g, '&apos;');
+}
+/** Render the plist with every placeholder substituted. All inputs XML-escaped. */
+export function renderBridgePlist(spec) {
+    const tpl = loadTemplate();
+    const programArgs = spec.args
+        .map((a) => `\t\t<string>${xmlEscape(a)}</string>`)
+        .join('\n');
+    const envEntries = Object.entries(spec.envVars)
+        .map(([k, v]) => `\t\t<key>${xmlEscape(k)}</key>\n\t\t<string>${xmlEscape(v)}</string>`)
+        .join('\n');
+    return tpl
+        .replace('{{LABEL}}', xmlEscape(spec.label))
+        .replace('{{PROGRAM}}', xmlEscape(spec.program))
+        .replace('{{PROGRAM_ARGS}}', programArgs)
+        .replace('{{ENV_VARS}}', envEntries)
+        .replace('{{STDOUT_PATH}}', xmlEscape(spec.stdoutPath))
+        .replace('{{STDERR_PATH}}', xmlEscape(spec.stderrPath));
+}
+/**
+ * Write the plist contents at `plistPath` with mode 0644. The parent dir is
+ * created if missing. Idempotent — overwrites any previous plist.
+ */
+export function installPlist(plistPath, contents) {
+    fs.mkdirSync(path.dirname(plistPath), { recursive: true });
+    fs.writeFileSync(plistPath, contents, { mode: 0o644 });
+}
+/**
+ * Bootstrap the agent into the user's gui session. If the agent is already
+ * loaded, bootout first — this is the recommended way to reload a changed
+ * plist.
+ */
+export async function loadAgent(plistPath, uid) {
+    const label = readLabelFromPlistPath(plistPath);
+    if (label && (await isAgentLoaded(label, uid))) {
+        await execFileStrict('launchctl', ['bootout', `gui/${uid}/${label}`]);
+    }
+    await execFileStrict('launchctl', ['bootstrap', `gui/${uid}`, plistPath]);
+}
+/** Bootout the agent. No-op when not loaded. */
+export async function unloadAgent(plistPath, uid) {
+    const label = readLabelFromPlistPath(plistPath);
+    if (!label) {
+        throw new Error(`could not extract Label from plist at ${plistPath}`);
+    }
+    if (!(await isAgentLoaded(label, uid)))
+        return;
+    await execFileStrict('launchctl', ['bootout', `gui/${uid}/${label}`]);
+}
+/** `launchctl print gui/<uid>/<label>` → 0 when loaded, non-zero otherwise. */
+export async function isAgentLoaded(label, uid) {
+    const { exitCode } = await execFileNoThrow('launchctl', [
+        'print',
+        `gui/${uid}/${label}`,
+    ]);
+    return exitCode === 0;
+}
+function readLabelFromPlistPath(plistPath) {
+    let xml;
+    try {
+        xml = fs.readFileSync(plistPath, 'utf-8');
+    }
+    catch {
+        return null;
+    }
+    const m = xml.match(/<key>Label<\/key>\s*<string>([^<]*)<\/string>/);
+    return m ? m[1] : null;
+}
+/** For tests — clear the cached template so re-imports re-read disk. */
+export function _resetTemplateCacheForTests() {
+    cachedTemplate = undefined;
+}
+//# sourceMappingURL=launchd.js.map

package/dist/launchd.js.map

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