@bluewombat/conductor 0.8.0 → 0.10.0

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAClF,OAAO,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAWjE,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAClF,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/run/delivery.d.ts

@@ -0,0 +1,114 @@
+import type { AuthorityPort, ImplementResult, ImplementTrace, TransformerPort } from "../transformers/port.js";
+import type { ProjectRunResult } from "./results.js";
+/**
+ * Getting assembled work from where it was made to where it lands.
+ *
+ * A Ticket does it to the Feature's line and a Feature does it to the Project's
+ * final one; the steps are the same and only what they are given differs. This
+ * module is the steps. It reads nothing from the ledger and writes nothing to
+ * it: whoever uses it says where the work is (`DeliveryUnit`), how a refusal is
+ * kept (`DeliveryStore`), and what the checks are (the Transformers).
+ *
+ * The steps, in order, each a pass that may end the pass early:
+ *
+ * 1. a fix, when something refused the last round and said why;
+ * 2. the align: the line brought into the work, and a conflict sent to the fix;
+ * 3. the work's own checks again, when the align or a fix changed the code
+ *    (a Ticket has them; a Feature's are part of its review);
+ * 4. a local review, when the Project has one;
+ * — then the work is offered, which is the user's business (it is published in
+ *   different ways) — and later:
+ * 5. the judgement of what was published;
+ * 6. whether the line moved on meanwhile, and a realign if so;
+ * 7. the fold.
+ */
+/** The work to deliver, and where everything about it is. */
+export type DeliveryUnit = {
+    /** The Ticket's or the Feature's key; every Transformer id derives from it. */
+    key: string;
+    intention: string;
+    title?: string | undefined;
+    /** What it is called in what is said about it. */
+    noun: "ticket" | "feature";
+    /** Where the work is: the Transformers produce, align and check here. */
+    workspace: string;
+    /** Where the Gates read the published work: its branch is checked out here. */
+    judgeWorkspace: string;
+    /** The line it is offered to; empty when the Project names none. */
+    target: string;
+    /** The directory holding that line, merged into the work at the align. */
+    line: string;
+};
+/** What the delivery needs to know of the unit's state, read fresh at each step. */
+export type DeliveryRead = {
+    /** What refused the last round, when something did. The fresher of a parked refusal and a Submission's. */
+    sentBack?: {
+        report: string;
+        refusedBy?: string | undefined;
+    } | undefined;
+    /** Corrective rounds spent: refusals, parked refusals and realigns together. */
+    spent: number;
+    /** The Submission the work is offered under, once there is one. */
+    submission?: {
+        reference: string;
+    } | undefined;
+};
+/**
+ * How the unit keeps what the delivery decides. Each write answers `undefined`
+ * when it was done, or the result that ends the pass when it was refused.
+ */
+export type DeliveryStore = {
+    read(): Promise<DeliveryRead | undefined>;
+    /** Stop for a person. */
+    freeze(input: {
+        kind: "assembly" | "submitted";
+        report?: string;
+    }): Promise<ProjectRunResult>;
+    /** A check refused the work before it was published: keep why, for the fix. */
+    park(why: {
+        report: string;
+        refusedBy?: string | undefined;
+    }): Promise<ProjectRunResult | undefined>;
+    /** Whatever sent the work back is repaired and checked. */
+    unpark(): Promise<ProjectRunResult | undefined>;
+    /** The Authority's judgement refused the Submission: keep why, and go back to the fix. */
+    refuse(why: {
+        report: string;
+        refusedBy?: string | undefined;
+    }): Promise<ProjectRunResult | undefined>;
+    /** The line moved on under the Submission: go back to be aligned. */
+    realign(): Promise<ProjectRunResult | undefined>;
+};
+export type DeliveryOptions = {
+    transformers: TransformerPort;
+    /** Absent: the work is not offered outside, and `settle` has nothing to ask. */
+    authority?: AuthorityPort | undefined;
+    durationMs: number;
+    maxRefusals: number;
+    /** Whether the unit's own checks run again after the align (the Ticket's `builder.gates`). */
+    recheck: boolean;
+    /** Whether a local review follows. For a Feature it is also where its checks run. */
+    validate: boolean;
+    /** Whether anything can repair a refusal. Without it a refusal is for a person. */
+    fixDeclared: boolean;
+    /** One job at a time over the directories the line lives in. */
+    onLine<T>(job: () => Promise<T>): Promise<T>;
+    /** The directory of the line brought up to date with it; false when it could not be. */
+    refreshLine(target: string): Promise<boolean>;
+    isPaused(): boolean;
+};
+export type Delivery = {
+    /** Steps 1 to 4. `ready` means the work may be offered. */
+    prepare(unit: DeliveryUnit, store: DeliveryStore): Promise<"ready" | ProjectRunResult>;
+    /** The Gates' judgement of the published work; nothing is produced. */
+    judge(unit: DeliveryUnit): Promise<ImplementResult>;
+    /** Steps 5 to 7. `folded` is the one outcome that is not a pass of its own. */
+    settle(unit: DeliveryUnit, store: DeliveryStore): Promise<{
+        folded: true;
+        reference?: string | undefined;
+    } | ProjectRunResult>;
+};
+/** What the last Attempt ended on, for whoever reads the escalation. */
+export declare function reasonOfTraces(traces: ImplementTrace[]): string | undefined;
+export declare function openDelivery(options: DeliveryOptions): Delivery;
+//# sourceMappingURL=delivery.d.ts.map

package/dist/run/delivery.d.ts.map

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

package/dist/run/delivery.js

@@ -0,0 +1,278 @@
+import { foldMessageOf } from "./subject.js";
+/** What the last Attempt ended on, for whoever reads the escalation. */
+export function reasonOfTraces(traces) {
+    const last = traces.at(-1);
+    const report = last?.report?.trim();
+    if (report === undefined || report.length === 0) {
+        return undefined;
+    }
+    return last?.refusedBy === undefined ? report : `${last.refusedBy}: ${report}`;
+}
+export function openDelivery(options) {
+    const { transformers, authority, durationMs, maxRefusals } = options;
+    const refused = (code) => ({ outcome: "refused", code });
+    /**
+     * Something broke or refused the work before it was published: hand it to the
+     * fix with the reason. A human is asked only when nothing can fix it (no fix
+     * declared, a blocking refusal) or the budget is spent.
+     */
+    async function sendBack(unit, store, read, why) {
+        const canRepair = options.fixDeclared && why.blocking !== true && read.spent + 1 < maxRefusals;
+        if (!canRepair) {
+            return await store.freeze({
+                kind: "assembly",
+                report: why.refusedBy === undefined ? why.report : `${why.refusedBy}: ${why.report}`,
+            });
+        }
+        const failure = await store.park(why);
+        if (failure !== undefined) {
+            return failure;
+        }
+        // Repair is on its way: do not offer, or judge, work that is already known to
+        // need it. The next pass produces the fix, then aligns and checks again.
+        return { outcome: "paused", key: unit.key };
+    }
+    /**
+     * The line moved on under a Submission, or refused the fold: go back to be
+     * aligned with it, judged and published again. Nothing was wrong with the
+     * work, so there is no report to repair; the round still counts.
+     */
+    async function realign(unit, store, read, why) {
+        if (read.spent + 1 >= maxRefusals) {
+            return await store.freeze({
+                kind: "submitted",
+                report: `${why} This ${unit.noun} has used all its corrective rounds, so it stops here for a person.`,
+            });
+        }
+        const failure = await store.realign();
+        if (failure !== undefined) {
+            return failure;
+        }
+        return { outcome: "paused", key: unit.key };
+    }
+    async function judge(unit) {
+        return await transformers.implement({
+            id: `${unit.key}:judgement`,
+            context: unit.key,
+            stage: unit.noun,
+            produce: false,
+            intention: unit.intention,
+            workspace: unit.judgeWorkspace,
+        });
+    }
+    async function prepare(unit, store) {
+        const read = await store.read();
+        if (read === undefined) {
+            return { outcome: "refused", code: "not-found" };
+        }
+        const line = unit.target.length > 0 ? unit.target : "the work line";
+        const sentBack = read.sentBack;
+        if (sentBack !== undefined) {
+            // Something refused the last round and said why. That report is the only
+            // reason this stage has to produce: the unit is already validated.
+            //
+            // Before the Integration below, and that order is the whole point. What a
+            // producer leaves is loose in the workspace; the Integration is the only
+            // thing that takes it up. Producing after it means the repair waits for
+            // the next round to be taken up at all, and what goes out meanwhile is the
+            // state that was already refused — the same refusal comes back, and the
+            // budget empties on the delay.
+            const remade = await transformers.implement({
+                id: `${unit.key}:fix`,
+                context: unit.key,
+                stage: unit.noun,
+                produce: true,
+                intention: unit.intention,
+                workspace: unit.workspace,
+                report: sentBack.report,
+                ...(sentBack.refusedBy === undefined ? {} : { reportFrom: sentBack.refusedBy }),
+            });
+            if (remade.outcome === "interrupted") {
+                return refused("interrupted");
+            }
+            if (remade.outcome === "invalid-invocation") {
+                return refused("transformer-invalid");
+            }
+            if (remade.outcome === "escalated") {
+                // The assembled work, not the unit: naming the unit here sends a reader
+                // to look at work that did not fail.
+                const why = reasonOfTraces(remade.traces);
+                return await store.freeze({
+                    kind: "assembly",
+                    ...(why === undefined ? {} : { report: why }),
+                });
+            }
+        }
+        // The line is brought current first: aligning with a copy that is behind
+        // would leave a Submission as far behind as it was, and send it round again.
+        const aligned = await options.onLine(async () => {
+            if (!(await options.refreshLine(unit.target))) {
+                return undefined;
+            }
+            return await transformers.integrate({
+                id: `${unit.key}:align`,
+                context: unit.key,
+                parent: unit.workspace,
+                child: unit.line,
+                durationMs,
+                // What is loose in the workspace here is the work the Builder made, or a
+                // repair of it.
+                subject: sentBack === undefined
+                    ? foldMessageOf(unit.title ?? unit.intention)
+                    : "Repair after it was refused",
+                mergeSubject: `Merge ${line} into the ${unit.noun}`,
+            });
+        });
+        if (aligned === undefined) {
+            return refused("line-refresh-failed");
+        }
+        if (aligned.outcome === "interrupted") {
+            return refused("interrupted");
+        }
+        if (aligned.outcome === "conflict") {
+            // Not a place to stop: the fix is told what happened and does the merge by hand.
+            return await sendBack(unit, store, read, {
+                report: `Merging the line "${line}" into this ${unit.noun} ` +
+                    `conflicts: the ${unit.noun} and the line changed the same places. Look at what the line ` +
+                    `changed since this ${unit.noun} started, and adapt the ${unit.noun}'s changes so they sit on top ` +
+                    "of it. Keep what the line changed.",
+                refusedBy: "align",
+            });
+        }
+        if (aligned.outcome !== "integrated") {
+            return refused("transformer-invalid");
+        }
+        if (options.isPaused()) {
+            return { outcome: "paused", key: unit.key };
+        }
+        // The unit's own checks again, on what is there now. Skipped only when the
+        // code is the one they already passed: nothing was repaired this round and
+        // the line brought nothing in. `changed` absent means the fold could not
+        // say, which counts as changed.
+        const unchanged = !options.recheck || (sentBack === undefined && aligned.changed === false);
+        const rechecked = unchanged
+            ? { outcome: "validated", traces: [] }
+            : await transformers.implement({
+                id: `${unit.key}:recheck`,
+                context: unit.key,
+                stage: unit.noun,
+                produce: false,
+                recheck: true,
+                intention: unit.intention,
+                workspace: unit.workspace,
+            });
+        if (rechecked.outcome === "interrupted") {
+            return refused("interrupted");
+        }
+        if (rechecked.outcome === "invalid-invocation") {
+            return refused("transformer-invalid");
+        }
+        if (rechecked.outcome === "escalated") {
+            const last = rechecked.traces.at(-1);
+            return await sendBack(unit, store, read, {
+                report: last?.report ??
+                    `The checks failed after the ${unit.noun} was aligned with the line, with no reason given.`,
+                ...(last?.refusedBy === undefined ? {} : { refusedBy: last.refusedBy }),
+                blocking: last?.ended === "fail-blocking",
+            });
+        }
+        // Whatever sent the work back is repaired and checked: it no longer asks for a fix.
+        const settled = await store.unpark();
+        if (settled !== undefined) {
+            return settled;
+        }
+        if (options.validate) {
+            const validated = await transformers.implement({
+                id: `${unit.key}:validate`,
+                context: unit.key,
+                stage: unit.noun,
+                validate: true,
+                intention: unit.intention,
+                workspace: unit.workspace,
+            });
+            if (validated.outcome === "interrupted") {
+                return refused("interrupted");
+            }
+            if (validated.outcome === "invalid-invocation") {
+                return refused("transformer-invalid");
+            }
+            if (validated.outcome === "escalated") {
+                const last = validated.traces.at(-1);
+                return await sendBack(unit, store, read, {
+                    report: last?.report ?? `The assembled ${unit.noun} was refused, with no reason given.`,
+                    ...(last?.refusedBy === undefined ? {} : { refusedBy: last.refusedBy }),
+                    blocking: last?.ended === "fail-blocking",
+                });
+            }
+            const cleared = await store.unpark();
+            if (cleared !== undefined) {
+                return cleared;
+            }
+        }
+        return "ready";
+    }
+    async function settle(unit, store) {
+        const read = await store.read();
+        if (read === undefined) {
+            return { outcome: "refused", code: "not-found" };
+        }
+        const submission = read.submission;
+        if (authority === undefined || submission === undefined) {
+            return refused("transformer-invalid");
+        }
+        const judged = await judge(unit);
+        if (judged.outcome === "interrupted") {
+            return refused("interrupted");
+        }
+        if (judged.outcome === "invalid-invocation") {
+            return refused("transformer-invalid");
+        }
+        if (judged.outcome === "escalated") {
+            const last = judged.traces.at(-1);
+            const report = last?.report ?? "The Submission was refused, with no reason given.";
+            // A blocking refusal is not something another round repairs, and neither
+            // is one more refusal than the budget allows.
+            if (last?.ended === "fail-blocking" || read.spent + 1 >= maxRefusals) {
+                // The refusal that stopped it is never recorded as one — this is the
+                // only place it can be kept for the person who reads the escalation.
+                return await store.freeze({
+                    kind: "submitted",
+                    report: last?.refusedBy === undefined ? report : `${last.refusedBy}: ${report}`,
+                });
+            }
+            const failure = await store.refuse({ report, refusedBy: last?.refusedBy });
+            if (failure !== undefined) {
+                return failure;
+            }
+            // Back to where the work is made. The next pass produces with that report
+            // in hand and publishes to the same place.
+            return { outcome: "paused", key: unit.key };
+        }
+        // The Gates judged the work as it was published. If the line has moved on
+        // since — a person pushed to it, or later a ticket folded into it — a fold
+        // would produce something nobody judged. Go back to be aligned with the
+        // line again, then judged again, instead of folding.
+        const moved = await authority.behind?.({ reference: submission.reference });
+        if (moved?.outcome === "unavailable") {
+            return { outcome: "paused", key: unit.key };
+        }
+        if (moved?.outcome === "behind") {
+            // Back to where the work is aligned. The next pass brings the work line copy
+            // up to date, merges it into the work, checks it, judges it and publishes
+            // to the same place.
+            return await realign(unit, store, read, "The line moved on while this Submission waited to be folded, so what was judged is not what a fold would produce.");
+        }
+        const folded = await authority.fold({ reference: submission.reference });
+        if (folded.outcome === "unavailable") {
+            return { outcome: "paused", key: unit.key };
+        }
+        if (folded.outcome === "conflict") {
+            // The Authority will not fold it as it stands: go back and be aligned with the
+            // line again. If the alignment conflicts, the fix is told.
+            return await realign(unit, store, read, `The Authority refused the fold: ${folded.reason}`);
+        }
+        return { folded: true, reference: folded.reference };
+    }
+    return { prepare, judge, settle };
+}
+//# sourceMappingURL=delivery.js.map

package/dist/run/delivery.js.map

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

package/dist/run/open-conductor.d.ts

@@ -1,7 +1,9 @@
 import type { CommandResult, WorkLedger } from "@bluewombat/work-ledger";
 import type { AuthorityPort, TransformerPort } from "../transformers/port.js";
-export type ConductorRefusalCode = "stable-missing" | "root-invalid" | "persist-failed" | "interrupted" | "isolate-failed" | "warm-failed" | "align-conflict" | "transformer-invalid" | "unavailable" | "not-found" | "point-of-no-return" | "project-busy" | "illegal-transition";
-/** Prepare a Feature workspace after Isolation — install deps, and so on. */
+import type { ProjectRunResult } from "./results.js";
+export type { ConductorRefusalCode, ProjectRunResult } from "./results.js";
+export { foldMessageOf, subjectOf } from "./subject.js";
+/** Prepare a Ticket workspace after Isolation — install deps, and so on. */
 export type WarmOutcome = "warmed" | "failed" | "interrupted" | "invalid-invocation";
 export type WarmPort = {
     prepare(input: {
@@ -11,20 +13,18 @@ export type WarmPort = {
         outcome: WarmOutcome;
     }>;
 };
-export type ProjectRunResult = {
-    outcome: "idle";
-} | {
-    outcome: "done";
-    key: string;
-} | {
-    outcome: "escalated";
-    key: string;
-} | {
-    outcome: "paused";
-    key?: string;
-} | {
-    outcome: "refused";
-    code: ConductorRefusalCode;
+/**
+ * Bring the shared copy of the work line up to what the Authority holds, for
+ * the line `target` names. Conductor asks right before it reads the copy, so a
+ * ticket always starts from, and aligns with, the line as it is now.
+ */
+export type LinePort = {
+    refresh(target: string): Promise<{
+        ok: true;
+    } | {
+        ok: false;
+        detail?: string;
+    }>;
 };
 export type OpenConductorOptions = {
     ledger: WorkLedger;
@@ -33,40 +33,59 @@ export type OpenConductorOptions = {
     workspaceRoot: string;
     transformerDurationMs?: number;
     /**
-     * The outside judge of a Submission. Absent: an assembled feature is folded
+     * How many Tickets of a Project may be active at once. Default 1.
+     *
+     * Above 1 the Project needs an Authority: a Ticket folded straight into the
+     * work line would move it under the others with nobody to send them back.
+     */
+    maxParallel?: number;
+    /**
+     * Keeps the shared copy of the work line current. Absent: it is whatever its
+     * owner left, as before.
+     */
+    line?: LinePort;
+    /**
+     * The outside judge of a Submission. Absent: an assembled ticket is folded
      * into the work line directly, with nobody else asked.
      */
     authority?: AuthorityPort;
-    /** The work line a Submission is offered to. Required with an Authority. */
+    /** The work line a Submission is offered to, unless the Ticket names its own `line`. Required with an Authority. */
     workLineTarget?: string;
     /** How many times the Authority may send the work back before it escalates. */
     maxRefusals?: number;
     /**
-     * Whether a local judge decides if the assembled feature meets the
+     * Whether a local judge decides if the assembled ticket meets the
      * intention, before any Submission exists — or, without an Authority,
-     * before the final fold. Absent or `false`: `assembly.validate` is not
+     * before the final fold. Absent or `false`: `validate` is not
      * declared, and `integrating` goes straight to offer (or the local judge on
-     * `produce: false`), as before.
+     * `produce: false`).
      */
-    assemblyValidate?: boolean;
+    validate?: boolean;
     /**
-     * Whether `assembly.fix` is declared. A validate refusal with nothing to
+     * Whether the tests of a Task are written before its code. Then a pass of its
+     * own runs in the Ticket's workspace first, and what it wrote is committed as a
+     * checkpoint, so the producer's work is what comes after it. Absent or `false`:
+     * the producer makes the code and the tests together, as before.
+     */
+    tests?: boolean;
+    /**
+     * Whether a fix is declared. A validate refusal with nothing to
      * repair it escalates on the spot rather than spending the budget on a round
      * that can only repeat the same refusal.
      */
-    assemblyFixDeclared?: boolean;
+    fixDeclared?: boolean;
     /**
      * Told at the moments a pass changes what an outsider would want to know:
-     * the plan is in, a Subtask is integrated, the work is submitted. Awaited,
+     * the work is submitted. Awaited,
      * so what the caller says lands before the next step; what it throws is
      * its own problem and does not stop the run.
      */
     observe?: (moment: ConductorMoment) => Promise<void> | void;
     /**
-     * Prepare the Feature workspace once it exists, before any Subtask is
-     * isolated from it. Absent: Subtasks inherit whatever Isolation left —
-     * often a cold tree with no dependencies. Bounded by `durationMs`; retried
-     * on the next `runProject` until it returns `warmed`.
+     * Prepare the workspace once it exists, before the Builder runs in it.
+     * Absent: the Builder gets whatever Isolation left — often a cold tree with
+     * no dependencies. Bounded by `durationMs`; retried on the next `runProject`
+     * until it returns `warmed`.
      */
     warm?: WarmPort & {
         durationMs: number;
@@ -74,15 +93,6 @@ export type OpenConductorOptions = {
 };
 /** One thing that happened inside a pass, for whoever is watching from outside. */
 export type ConductorMoment = {
-    kind: "planned";
-    key: string;
-} | {
-    kind: "subtask-integrated";
-    key: string;
-    subtaskId: string;
-    integrated: number;
-    total: number;
-} | {
     kind: "submitted";
     key: string;
     reference: string;
@@ -92,23 +102,25 @@ export type Conductor = {
     pause(): void;
     resume(): void;
     runProject(project: string): Promise<ProjectRunResult>;
+    /**
+     * Take the next Ticket of the Project that may start, within its parallel
+     * limit. Nothing is run. Absent when none may: the Project is full, or
+     * nothing is ready or unblocked.
+     */
+    claimNext(project: string): Promise<{
+        key: string;
+    } | undefined>;
+    /**
+     * Drive one Ticket the Project already holds, as far as it goes. Unlike
+     * `runProject` it neither claims nor reconciles, so several can run at once.
+     */
+    runTicket(key: string): Promise<ProjectRunResult>;
     cancel(key: string): Promise<CommandResult>;
     /**
-     * Drop a held Subtask (or planning) without waiting for the bail clock.
-     * Destroys the declared Subtask directory when one was recorded.
+     * Drop a held unit without waiting for the bail clock.
+     * Destroys the declared directory when one was recorded.
      */
     release(key: string): Promise<CommandResult>;
 };
-/**
- * A fold's subject out of prose. Text written the way a commit is — a headline,
- * a blank line, the rest — gives its headline. Otherwise the first sentence,
- * cut at a word when even that runs past what one line of history shows. A
- * subject is not markdown, so the backticks prose uses for names come off; and
- * it ends on a word, not on an ellipsis — the whole text follows in the body
- * for whoever wants it.
- */
-export declare function subjectOf(text: string): string;
-/** Subject line, then the whole text when the subject did not carry it all. */
-export declare function foldMessageOf(text: string): string;
 export declare function openConductor(options: OpenConductorOptions): Conductor;
 //# sourceMappingURL=open-conductor.d.ts.map

package/dist/run/open-conductor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"open-conductor.d.ts","sourceRoot":"","sources":["../../src/run/open-conductor.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"open-conductor.d.ts","sourceRoot":"","sources":["../../src/run/open-conductor.ts"],"names":[],"mappings":"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"}