@owlmeans/agent-common 0.1.18-rc.7 → 0.1.18

package/build/models/pipeline-spec/types.d.ts

@@ -0,0 +1,57 @@
+import type { PipelineSpec, PipelineStepSpec } from '../../types.js';
+/** One step a step transitively waits on, with the fewest `after` edges between the two. */
+export interface PipelineStepDepth {
+    step: string;
+    depth: number;
+}
+/** The rules of one pipeline declaration: its validity, its order and the graph of its steps. */
+export interface PipelineSpecModel {
+    readonly record: PipelineSpec;
+    /**
+     * Every fault in one message, or nothing.
+     *
+     * Total and IO-free, so a spec can be checked by a test in microseconds and by the runner at build
+     * time. It reports EVERY fault it finds rather than the first, because a spec is authored once and
+     * a build that names one fault per run turns a five-minute edit into five builds.
+     *
+     * @throws {PipelineSpecError}
+     */
+    validate: () => void;
+    /**
+     * The steps in an order that respects every `after`, with declaration order as the tie-break.
+     *
+     * Deterministic on purpose: the order decides what a progress report calls "step 3 of 16" and what
+     * a resume considers already behind it, and an order that depends on a `Set`'s iteration would make
+     * both drift between processes.
+     *
+     * @throws {PipelineSpecError} on a cycle or an unknown `after`.
+     */
+    orderSteps: () => string[];
+    /**
+     * `step` and everything that transitively waits on it.
+     *
+     * What a resume has to re-run when an operator names a step: re-entering a step without re-entering
+     * what read its output leaves the run describing a state that no longer follows from itself.
+     *
+     * @throws {PipelineUnknownStepError} when the spec does not declare `step`.
+     */
+    descendants: (step: string) => string[];
+    /**
+     * Every step `step` transitively waits on, with its DEPTH — the fewest `after` edges between the
+     * two — in topological order.
+     *
+     * The mirror of {@link PipelineSpecModel.descendants}, with one deliberate asymmetry: the named step
+     * itself is NOT included. A re-run re-enters the step it names, so the descendants include it;
+     * nothing is its own predecessor, so the ancestors do not. The depth is what a consumer uses to
+     * decide how much of a predecessor's output it needs to be told — a direct predecessor is depth 1
+     * however far apart the two sit in the topological order.
+     *
+     * @throws {PipelineUnknownStepError} when the spec does not declare `step`.
+     */
+    ancestry: (step: string) => PipelineStepDepth[];
+    /** The names from {@link PipelineSpecModel.ancestry}: what must finish before `step` may start, in order. */
+    ancestors: (step: string) => string[];
+    /** The declaration of one step, by name. `null` when the spec does not declare it. */
+    stepOf: (step: string) => PipelineStepSpec | null;
+}
+//# sourceMappingURL=types.d.ts.map

package/build/models/pipeline-spec/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/models/pipeline-spec/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AAEpE,4FAA4F;AAC5F,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;CACd;AAED,iGAAiG;AACjG,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAA;IAC7B;;;;;;;;OAQG;IACH,QAAQ,EAAE,MAAM,IAAI,CAAA;IACpB;;;;;;;;OAQG;IACH,UAAU,EAAE,MAAM,MAAM,EAAE,CAAA;IAC1B;;;;;;;OAOG;IACH,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,EAAE,CAAA;IACvC;;;;;;;;;;;OAWG;IACH,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,iBAAiB,EAAE,CAAA;IAC/C,6GAA6G;IAC7G,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,EAAE,CAAA;IACrC,sFAAsF;IACtF,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,gBAAgB,GAAG,IAAI,CAAA;CAClD"}

package/build/models/pipeline-spec/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/build/models/pipeline-spec/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/models/pipeline-spec/types.ts"],"names":[],"mappings":""}

package/build/models/pipeline-spec.d.ts

@@ -0,0 +1,4 @@
+import type { PipelineSpec } from '../types.js';
+import type { PipelineSpecModel } from './pipeline-spec/types.js';
+export declare const makePipelineSpecModel: (spec: PipelineSpec) => PipelineSpecModel;
+//# sourceMappingURL=pipeline-spec.d.ts.map

package/build/models/pipeline-spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline-spec.d.ts","sourceRoot":"","sources":["../../src/models/pipeline-spec.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAoB,MAAM,aAAa,CAAA;AACjE,OAAO,KAAK,EAAE,iBAAiB,EAAqB,MAAM,0BAA0B,CAAA;AAEpF,eAAO,MAAM,qBAAqB,SAAU,YAAY,KAAG,iBAoM1D,CAAA"}

package/build/models/pipeline-spec.js

@@ -0,0 +1,171 @@
+import { DEFAULT_STEP_ATTEMPTS } from '../consts.js';
+import { PipelineSpecError, PipelineUnknownStepError } from '../errors.js';
+export const makePipelineSpecModel = (spec) => {
+    const fault = (faults, message) => {
+        faults.push(message);
+    };
+    const validate = () => {
+        const faults = [];
+        if (spec.alias == null || spec.alias.trim() === '') {
+            fault(faults, 'alias is empty');
+        }
+        if (!Number.isInteger(spec.version) || spec.version < 1) {
+            fault(faults, `version must be a positive integer, got ${String(spec.version)}`);
+        }
+        if (!Array.isArray(spec.steps) || spec.steps.length === 0) {
+            fault(faults, 'no steps declared');
+            throw new PipelineSpecError(`${spec.alias ?? '?'}: ${faults.join('; ')}`);
+        }
+        const seen = new Set();
+        for (const step of spec.steps) {
+            if (step.step == null || step.step.trim() === '') {
+                fault(faults, 'a step has an empty name');
+                continue;
+            }
+            if (seen.has(step.step)) {
+                fault(faults, `duplicate step "${step.step}"`);
+            }
+            seen.add(step.step);
+        }
+        for (const step of spec.steps) {
+            for (const dependency of step.after ?? []) {
+                if (dependency === step.step) {
+                    fault(faults, `step "${step.step}" declares itself in \`after\``);
+                }
+                else if (!seen.has(dependency)) {
+                    fault(faults, `step "${step.step}" waits on unknown step "${dependency}"`);
+                }
+            }
+            const attempts = step.attempts ?? DEFAULT_STEP_ATTEMPTS;
+            if (!Number.isInteger(attempts) || attempts < 1) {
+                fault(faults, `step "${step.step}" declares attempts ${String(step.attempts)}`);
+            }
+            if (step.nonIdempotent === true && attempts > 1) {
+                fault(faults, `step "${step.step}" is nonIdempotent and declares attempts ${attempts} — an automatic `
+                    + 'retry is exactly what that flag says must not happen');
+            }
+            if (step.timeout != null && (!Number.isFinite(step.timeout) || step.timeout <= 0)) {
+                fault(faults, `step "${step.step}" declares timeout ${String(step.timeout)}`);
+            }
+        }
+        // A cycle is reported here rather than left to the sort, so one message carries every fault.
+        if (faults.every(entry => !entry.includes('unknown step'))) {
+            const cycle = detectCycle();
+            if (cycle != null) {
+                fault(faults, `cycle: ${cycle.join(' → ')}`);
+            }
+        }
+        if (faults.length > 0) {
+            throw new PipelineSpecError(`${spec.alias}: ${faults.join('; ')}`);
+        }
+    };
+    const detectCycle = () => {
+        const after = new Map(spec.steps.map(step => [step.step, step.after ?? []]));
+        const state = new Map();
+        const path = [];
+        const walk = (name) => {
+            const mark = state.get(name);
+            if (mark === 2)
+                return null;
+            if (mark === 1)
+                return [...path.slice(path.indexOf(name)), name];
+            state.set(name, 1);
+            path.push(name);
+            for (const dependency of after.get(name) ?? []) {
+                const found = walk(dependency);
+                if (found != null)
+                    return found;
+            }
+            path.pop();
+            state.set(name, 2);
+            return null;
+        };
+        for (const step of spec.steps) {
+            const found = walk(step.step);
+            if (found != null)
+                return found.reverse();
+        }
+        return null;
+    };
+    const orderSteps = () => {
+        const names = spec.steps.map(step => step.step);
+        const known = new Set(names);
+        const pending = new Map();
+        const dependents = new Map();
+        for (const step of spec.steps) {
+            const dependencies = new Set();
+            for (const dependency of step.after ?? []) {
+                if (!known.has(dependency)) {
+                    throw new PipelineSpecError(`${spec.alias}: step "${step.step}" waits on unknown step "${dependency}"`);
+                }
+                dependencies.add(dependency);
+                dependents.set(dependency, [...(dependents.get(dependency) ?? []), step.step]);
+            }
+            pending.set(step.step, dependencies);
+        }
+        const ordered = [];
+        const emitted = new Set();
+        while (ordered.length < names.length) {
+            // Declaration order among everything currently ready — never a set's own order.
+            const ready = names.filter(name => !emitted.has(name) && (pending.get(name)?.size ?? 0) === 0);
+            if (ready.length === 0) {
+                const cycle = detectCycle();
+                throw new PipelineSpecError(`${spec.alias}: cycle: ${(cycle ?? names.filter(name => !emitted.has(name))).join(' → ')}`);
+            }
+            for (const name of ready) {
+                ordered.push(name);
+                emitted.add(name);
+                for (const dependent of dependents.get(name) ?? []) {
+                    pending.get(dependent)?.delete(name);
+                }
+            }
+        }
+        return ordered;
+    };
+    const descendants = (step) => {
+        if (!spec.steps.some(entry => entry.step === step)) {
+            throw new PipelineUnknownStepError(`${spec.alias}:${step}`);
+        }
+        const reached = new Set([step]);
+        let grew = true;
+        while (grew) {
+            grew = false;
+            for (const entry of spec.steps) {
+                if (reached.has(entry.step))
+                    continue;
+                if ((entry.after ?? []).some(dependency => reached.has(dependency))) {
+                    reached.add(entry.step);
+                    grew = true;
+                }
+            }
+        }
+        return orderSteps().filter(name => reached.has(name));
+    };
+    const ancestry = (step) => {
+        if (!spec.steps.some(entry => entry.step === step)) {
+            throw new PipelineUnknownStepError(`${spec.alias}:${step}`);
+        }
+        const after = new Map(spec.steps.map(entry => [entry.step, entry.after ?? []]));
+        const depths = new Map();
+        let frontier = [step];
+        for (let depth = 1; frontier.length > 0; ++depth) {
+            const next = [];
+            for (const name of frontier) {
+                for (const dependency of after.get(name) ?? []) {
+                    if (dependency !== step && !depths.has(dependency)) {
+                        depths.set(dependency, depth);
+                        next.push(dependency);
+                    }
+                }
+            }
+            frontier = next;
+        }
+        return orderSteps()
+            .filter(name => depths.has(name))
+            .map(name => ({ step: name, depth: depths.get(name) }));
+    };
+    const ancestors = (step) => ancestry(step).map(entry => entry.step);
+    const stepOf = (step) => spec.steps.find(entry => entry.step === step) ?? null;
+    return { record: spec, validate, orderSteps, descendants, ancestry, ancestors, stepOf };
+};
+//# sourceMappingURL=pipeline-spec.js.map

package/build/models/pipeline-spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline-spec.js","sourceRoot":"","sources":["../../src/models/pipeline-spec.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAA;AACpD,OAAO,EAAE,iBAAiB,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAA;AAI1E,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,IAAkB,EAAqB,EAAE;IAC7E,MAAM,KAAK,GAAG,CAAC,MAAgB,EAAE,OAAe,EAAQ,EAAE;QACxD,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;IACtB,CAAC,CAAA;IAED,MAAM,QAAQ,GAAG,GAAS,EAAE;QAC1B,MAAM,MAAM,GAAa,EAAE,CAAA;QAE3B,IAAI,IAAI,CAAC,KAAK,IAAI,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;YACnD,KAAK,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAA;QACjC,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,OAAO,GAAG,CAAC,EAAE,CAAC;YACxD,KAAK,CAAC,MAAM,EAAE,2CAA2C,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,CAAA;QAClF,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC1D,KAAK,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAA;YAClC,MAAM,IAAI,iBAAiB,CAAC,GAAG,IAAI,CAAC,KAAK,IAAI,GAAG,KAAK,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;QAC3E,CAAC;QAED,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAA;QAC9B,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YAC9B,IAAI,IAAI,CAAC,IAAI,IAAI,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;gBACjD,KAAK,CAAC,MAAM,EAAE,0BAA0B,CAAC,CAAA;gBACzC,SAAQ;YACV,CAAC;YACD,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;gBACxB,KAAK,CAAC,MAAM,EAAE,mBAAmB,IAAI,CAAC,IAAI,GAAG,CAAC,CAAA;YAChD,CAAC;YACD,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QACrB,CAAC;QAED,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YAC9B,KAAK,MAAM,UAAU,IAAI,IAAI,CAAC,KAAK,IAAI,EAAE,EAAE,CAAC;gBAC1C,IAAI,UAAU,KAAK,IAAI,CAAC,IAAI,EAAE,CAAC;oBAC7B,KAAK,CAAC,MAAM,EAAE,SAAS,IAAI,CAAC,IAAI,gCAAgC,CAAC,CAAA;gBACnE,CAAC;qBAAM,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC;oBACjC,KAAK,CAAC,MAAM,EAAE,SAAS,IAAI,CAAC,IAAI,4BAA4B,UAAU,GAAG,CAAC,CAAA;gBAC5E,CAAC;YACH,CAAC;YACD,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,IAAI,qBAAqB,CAAA;YACvD,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,QAAQ,GAAG,CAAC,EAAE,CAAC;gBAChD,KAAK,CAAC,MAAM,EAAE,SAAS,IAAI,CAAC,IAAI,uBAAuB,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAA;YACjF,CAAC;YACD,IAAI,IAAI,CAAC,aAAa,KAAK,IAAI,IAAI,QAAQ,GAAG,CAAC,EAAE,CAAC;gBAChD,KAAK,CACH,MAAM,EACN,SAAS,IAAI,CAAC,IAAI,4CAA4C,QAAQ,kBAAkB;sBACtF,sDAAsD,CACzD,CAAA;YACH,CAAC;YACD,IAAI,IAAI,CAAC,OAAO,IAAI,IAAI,IAAI,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,OAAO,IAAI,CAAC,CAAC,EAAE,CAAC;gBAClF,KAAK,CAAC,MAAM,EAAE,SAAS,IAAI,CAAC,IAAI,sBAAsB,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,CAAA;YAC/E,CAAC;QACH,CAAC;QAED,6FAA6F;QAC7F,IAAI,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC,EAAE,CAAC;YAC3D,MAAM,KAAK,GAAG,WAAW,EAAE,CAAA;YAC3B,IAAI,KAAK,IAAI,IAAI,EAAE,CAAC;gBAClB,KAAK,CAAC,MAAM,EAAE,UAAU,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;YAC9C,CAAC;QACH,CAAC;QAED,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACtB,MAAM,IAAI,iBAAiB,CAAC,GAAG,IAAI,CAAC,KAAK,KAAK,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;QACpE,CAAC;IACH,CAAC,CAAA;IAED,MAAM,WAAW,GAAG,GAAoB,EAAE;QACxC,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,CAAC,CAAA;QAC5E,MAAM,KAAK,GAAG,IAAI,GAAG,EAAqB,CAAA;QAC1C,MAAM,IAAI,GAAa,EAAE,CAAA;QAEzB,MAAM,IAAI,GAAG,CAAC,IAAY,EAAmB,EAAE;YAC7C,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;YAC5B,IAAI,IAAI,KAAK,CAAC;gBAAE,OAAO,IAAI,CAAA;YAC3B,IAAI,IAAI,KAAK,CAAC;gBAAE,OAAO,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,EAAE,IAAI,CAAC,CAAA;YAEhE,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,CAAA;YAClB,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;YACf,KAAK,MAAM,UAAU,IAAI,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;gBAC/C,MAAM,KAAK,GAAG,IAAI,CAAC,UAAU,CAAC,CAAA;gBAC9B,IAAI,KAAK,IAAI,IAAI;oBAAE,OAAO,KAAK,CAAA;YACjC,CAAC;YACD,IAAI,CAAC,GAAG,EAAE,CAAA;YACV,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,CAAA;YAElB,OAAO,IAAI,CAAA;QACb,CAAC,CAAA;QAED,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YAC9B,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;YAC7B,IAAI,KAAK,IAAI,IAAI;gBAAE,OAAO,KAAK,CAAC,OAAO,EAAE,CAAA;QAC3C,CAAC;QAED,OAAO,IAAI,CAAA;IACb,CAAC,CAAA;IAED,MAAM,UAAU,GAAG,GAAa,EAAE;QAChC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAC/C,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,CAAA;QAC5B,MAAM,OAAO,GAAG,IAAI,GAAG,EAAuB,CAAA;QAC9C,MAAM,UAAU,GAAG,IAAI,GAAG,EAAoB,CAAA;QAE9C,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YAC9B,MAAM,YAAY,GAAG,IAAI,GAAG,EAAU,CAAA;YACtC,KAAK,MAAM,UAAU,IAAI,IAAI,CAAC,KAAK,IAAI,EAAE,EAAE,CAAC;gBAC1C,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC;oBAC3B,MAAM,IAAI,iBAAiB,CACzB,GAAG,IAAI,CAAC,KAAK,WAAW,IAAI,CAAC,IAAI,4BAA4B,UAAU,GAAG,CAC3E,CAAA;gBACH,CAAC;gBACD,YAAY,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;gBAC5B,UAAU,CAAC,GAAG,CAAC,UAAU,EAAE,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,CAAA;YAChF,CAAC;YACD,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,YAAY,CAAC,CAAA;QACtC,CAAC;QAED,MAAM,OAAO,GAAa,EAAE,CAAA;QAC5B,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAA;QAEjC,OAAO,OAAO,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC;YACrC,gFAAgF;YAChF,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,CAAA;YAC9F,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACvB,MAAM,KAAK,GAAG,WAAW,EAAE,CAAA;gBAC3B,MAAM,IAAI,iBAAiB,CACzB,GAAG,IAAI,CAAC,KAAK,YAAY,CAAC,KAAK,IAAI,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAC3F,CAAA;YACH,CAAC;YACD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;gBACzB,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;gBAClB,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;gBACjB,KAAK,MAAM,SAAS,IAAI,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;oBACnD,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC,IAAI,CAAC,CAAA;gBACtC,CAAC;YACH,CAAC;QACH,CAAC;QAED,OAAO,OAAO,CAAA;IAChB,CAAC,CAAA;IAED,MAAM,WAAW,GAAG,CAAC,IAAY,EAAY,EAAE;QAC7C,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;YACnD,MAAM,IAAI,wBAAwB,CAAC,GAAG,IAAI,CAAC,KAAK,IAAI,IAAI,EAAE,CAAC,CAAA;QAC7D,CAAC;QAED,MAAM,OAAO,GAAG,IAAI,GAAG,CAAS,CAAC,IAAI,CAAC,CAAC,CAAA;QACvC,IAAI,IAAI,GAAG,IAAI,CAAA;QACf,OAAO,IAAI,EAAE,CAAC;YACZ,IAAI,GAAG,KAAK,CAAA;YACZ,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;gBAC/B,IAAI,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC;oBAAE,SAAQ;gBACrC,IAAI,CAAC,KAAK,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC;oBACpE,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;oBACvB,IAAI,GAAG,IAAI,CAAA;gBACb,CAAC;YACH,CAAC;QACH,CAAC;QAED,OAAO,UAAU,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAA;IACvD,CAAC,CAAA;IAED,MAAM,QAAQ,GAAG,CAAC,IAAY,EAAuB,EAAE;QACrD,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;YACnD,MAAM,IAAI,wBAAwB,CAAC,GAAG,IAAI,CAAC,KAAK,IAAI,IAAI,EAAE,CAAC,CAAA;QAC7D,CAAC;QAED,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,CAAC,CAAA;QAC/E,MAAM,MAAM,GAAG,IAAI,GAAG,EAAkB,CAAA;QACxC,IAAI,QAAQ,GAAG,CAAC,IAAI,CAAC,CAAA;QACrB,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,EAAE,KAAK,EAAE,CAAC;YACjD,MAAM,IAAI,GAAa,EAAE,CAAA;YACzB,KAAK,MAAM,IAAI,IAAI,QAAQ,EAAE,CAAC;gBAC5B,KAAK,MAAM,UAAU,IAAI,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;oBAC/C,IAAI,UAAU,KAAK,IAAI,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC;wBACnD,MAAM,CAAC,GAAG,CAAC,UAAU,EAAE,KAAK,CAAC,CAAA;wBAC7B,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,CAAA;oBACvB,CAAC;gBACH,CAAC;YACH,CAAC;YACD,QAAQ,GAAG,IAAI,CAAA;QACjB,CAAC;QAED,OAAO,UAAU,EAAE;aAChB,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;aAChC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC,IAAI,CAAE,EAAE,CAAC,CAAC,CAAA;IAC5D,CAAC,CAAA;IAED,MAAM,SAAS,GAAG,CAAC,IAAY,EAAY,EAAE,CAC3C,QAAQ,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;IAEzC,MAAM,MAAM,GAAG,CAAC,IAAY,EAA2B,EAAE,CACvD,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,IAAI,CAAA;IAEvD,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,WAAW,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,CAAA;AACzF,CAAC,CAAA"}

package/build/pipeline.d.ts

@@ -0,0 +1,10 @@
+import type { PipelineSpec, PipelineStepSpec } from './types.js';
+/** @deprecated compat:factory-refactor — use `makePipelineSpecModel(spec).validate()` */
+export declare const validatePipelineSpec: (spec: PipelineSpec) => void;
+/** @deprecated compat:factory-refactor — use `makePipelineSpecModel(spec).orderSteps()` */
+export declare const orderPipelineSteps: (spec: PipelineSpec) => string[];
+/** @deprecated compat:factory-refactor — use `makePipelineSpecModel(spec).descendants(…)` */
+export declare const pipelineDescendants: (spec: PipelineSpec, step: string) => string[];
+/** @deprecated compat:factory-refactor — use `makePipelineSpecModel(spec).stepOf(…)` */
+export declare const pipelineStep: (spec: PipelineSpec, step: string) => PipelineStepSpec | null;
+//# sourceMappingURL=pipeline.d.ts.map

package/build/pipeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline.d.ts","sourceRoot":"","sources":["../src/pipeline.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA;AAEhE,yFAAyF;AACzF,eAAO,MAAM,oBAAoB,SAAU,YAAY,KAAG,IAA8C,CAAA;AAExG,2FAA2F;AAC3F,eAAO,MAAM,kBAAkB,SAAU,YAAY,KAAG,MAAM,EAA8C,CAAA;AAE5G,6FAA6F;AAC7F,eAAO,MAAM,mBAAmB,SAAU,YAAY,QAAQ,MAAM,KAAG,MAAM,EAC9B,CAAA;AAE/C,wFAAwF;AACxF,eAAO,MAAM,YAAY,SAAU,YAAY,QAAQ,MAAM,KAAG,gBAAgB,GAAG,IACzC,CAAA"}

package/build/pipeline.js

@@ -0,0 +1,10 @@
+import { makePipelineSpecModel } from './models/pipeline-spec.js';
+/** @deprecated compat:factory-refactor — use `makePipelineSpecModel(spec).validate()` */
+export const validatePipelineSpec = (spec) => makePipelineSpecModel(spec).validate();
+/** @deprecated compat:factory-refactor — use `makePipelineSpecModel(spec).orderSteps()` */
+export const orderPipelineSteps = (spec) => makePipelineSpecModel(spec).orderSteps();
+/** @deprecated compat:factory-refactor — use `makePipelineSpecModel(spec).descendants(…)` */
+export const pipelineDescendants = (spec, step) => makePipelineSpecModel(spec).descendants(step);
+/** @deprecated compat:factory-refactor — use `makePipelineSpecModel(spec).stepOf(…)` */
+export const pipelineStep = (spec, step) => makePipelineSpecModel(spec).stepOf(step);
+//# sourceMappingURL=pipeline.js.map

package/build/pipeline.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline.js","sourceRoot":"","sources":["../src/pipeline.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAA;AAGjE,yFAAyF;AACzF,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,IAAkB,EAAQ,EAAE,CAAC,qBAAqB,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,CAAA;AAExG,2FAA2F;AAC3F,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,IAAkB,EAAY,EAAE,CAAC,qBAAqB,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,CAAA;AAE5G,6FAA6F;AAC7F,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,IAAkB,EAAE,IAAY,EAAY,EAAE,CAChF,qBAAqB,CAAC,IAAI,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC,CAAA;AAE/C,wFAAwF;AACxF,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,IAAkB,EAAE,IAAY,EAA2B,EAAE,CACxF,qBAAqB,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA"}

package/build/results/types.d.ts

@@ -0,0 +1,211 @@
+import type { ResourceRecord } from '@owlmeans/resource';
+import { RESULTS_EVERY_STEP, CumulativeResultSource } from '../consts.js';
+/**
+ * ONE authoritative fact about what a step produced, small enough to be one line of a prompt.
+ *
+ * Every field is optional past `kind` and `name`, because facts differ in what matters about them:
+ * a type has a shape and an import specifier, an endpoint an alias, a method, a path and a guard, a
+ * resource a table and an accessor, a file only its path. Put scalars that have no field of their
+ * own into `attrs`.
+ */
+export interface CumulativeResultFact {
+    /** What the fact is about — see {@link CumulativeFactKind}. */
+    kind: string;
+    /** The name to use VERBATIM. */
+    name: string;
+    /** The file it lives in, relative to the project root. */
+    path?: string;
+    /** The module specifier it is imported from. */
+    specifier?: string;
+    /** Its shape or signature, on one line. */
+    signature?: string;
+    /** Fields, parameters or columns, when there is no signature to say it. */
+    members?: string[];
+    /** Another fact's name this one points at — a returned type, a mapped table. */
+    ref?: string;
+    /** Scalars without a field of their own — `method`, `path`, `guard`, `table`. */
+    attrs?: Record<string, string>;
+}
+/**
+ * One step's contribution to a ledger.
+ *
+ * Keyed by `(ledger, runId, step)`. `order` places it in the ledger: the topological index of the
+ * step in its own pipeline, preceded by the index path of every step it was composed under, so a
+ * run composed as a step of another sorts inside that step, ahead of the composing step's own
+ * entry. A single number cannot say that: two pipelines' indexes are not comparable.
+ *
+ * `full` and `compact` are rendered once, when the entry is written, and never contain a timestamp,
+ * a run id or anything else a model would copy without meaning to.
+ */
+export interface CumulativeResultEntry extends ResourceRecord {
+    /** What entries can see each other — by default the root run of the composition. */
+    ledger: string;
+    pipeline: string;
+    runId: string;
+    step: string;
+    /** How the entry is headed in a prompt: the step, behind the path of the steps it runs under. */
+    label: string;
+    order: number[];
+    /** Bumped every time the entry is re-extracted after a later step rewrote one of its files. */
+    revision: number;
+    source: CumulativeResultSource;
+    /** An `optional` step that failed: whatever it left behind, and a heading that says so. */
+    partial?: boolean;
+    facts: CumulativeResultFact[];
+    /** The files the facts were read from — what a later rewrite is matched against. */
+    files: string[];
+    /** A model's summary, rendered and capped. NOT verified, and always labelled so. */
+    summary?: string;
+    full: string;
+    compact: string;
+    /** Consumers that always get the full entry, by step name, or every later step. */
+    fullFor?: string[] | typeof RESULTS_EVERY_STEP;
+    /** Consumers that never see the entry in their prompt. */
+    omitFor?: string[];
+    /** How many edges back the entry is still rendered in full by default. */
+    window?: number;
+    updatedAt: string;
+}
+/**
+ * The optional model-written summary of a step. OFF unless a step declares one.
+ *
+ * Facts are the product; a summary is for what code cannot extract — an intent, a decision taken.
+ * It is bounded by `maxChars` in code after the model answers, rendered deterministically from the
+ * schema-shaped answer, and always labelled as unverified wherever it is shown.
+ */
+export interface ResultSummarySpec {
+    /** Which model — interpreted by the caller's summarize callback (a model role, typically). */
+    role?: string;
+    instructions: string;
+    /** JSON schema of the answer. Absent means `{ summary: string }`. */
+    schema?: Record<string, unknown>;
+    /** Defaults to `DEFAULT_RESULT_SUMMARY_CHARS`. */
+    maxChars?: number;
+}
+/**
+ * What one step contributes, and to whom. JSON-safe, so a declaration can live in data.
+ *
+ * Extractors are named, never inlined: a declaration names what runs, and the runtime holds the
+ * code. A consumer not named in `full` or `omit` gets the full entry within `window` edges and the
+ * names only beyond it.
+ */
+export interface StepResultsSpec {
+    /** Named deterministic extractors, run in this order. */
+    extractors?: string[];
+    /** Later steps that get the FULL entry wherever they sit, or `'*'` for all of them. */
+    full?: string[] | typeof RESULTS_EVERY_STEP;
+    /** Later steps that are never shown the entry. */
+    omit?: string[];
+    /** Overrides {@link CumulativeResultsSpec.window} for this entry. */
+    window?: number;
+    /** Cap on the full rendering; facts are dropped whole, never cut. */
+    maxChars?: number;
+    /** Cap on the names-only rendering. */
+    maxCompactChars?: number;
+    /** Re-extract this entry when a later step rewrites one of its files. Defaults to the spec's. */
+    refresh?: boolean;
+    summary?: ResultSummarySpec;
+}
+/** The pipeline-level declaration — merged from a pipeline's own and any overlay with {@link CumulativeResultsHelper.mergeResultsSpecs}. */
+export interface CumulativeResultsSpec {
+    /** Per step, by step name. A step with no entry contributes only what it records itself. */
+    steps?: Record<string, StepResultsSpec>;
+    /** Default {@link DEFAULT_RESULTS_WINDOW}. */
+    window?: number;
+    /** Total characters of one view. Default `DEFAULT_RESULTS_MAX_CHARS`. */
+    maxChars?: number;
+    /** Default cap of one full entry. Default {@link DEFAULT_RESULT_ENTRY_CHARS}. */
+    maxEntryChars?: number;
+    /** Default cap of one names-only entry. Default {@link DEFAULT_RESULT_COMPACT_CHARS}. */
+    maxCompactChars?: number;
+    /** Default for {@link StepResultsSpec.refresh}. Defaults to `true`. */
+    refresh?: boolean;
+}
+/** What a facts query may narrow by. Every field is an exact match. */
+export interface ResultFactQuery {
+    kind?: string;
+    name?: string;
+    /** A producing step, by its name or by its label. */
+    step?: string;
+}
+/** What {@link CumulativeResultsHelper.renderResultEntry} needs of an entry. */
+export interface RenderableResultEntry extends Pick<CumulativeResultEntry, 'label' | 'source' | 'partial' | 'facts' | 'summary'> {
+}
+export interface ResultRenderCaps {
+    /** Cap on the full rendering. Default {@link DEFAULT_RESULT_ENTRY_CHARS}. */
+    maxChars?: number;
+    /** Cap on the names-only rendering. Default {@link DEFAULT_RESULT_COMPACT_CHARS}. */
+    maxCompactChars?: number;
+}
+/** An entry's two renderings. */
+export interface RenderedResultEntry {
+    full: string;
+    compact: string;
+}
+/**
+ * CUMULATIVE PIPELINE RESULTS — the contracts.
+ *
+ * After a step of a pipeline finishes, code reads what it produced — a type's shape, a file, an
+ * endpoint's method, path and parameters, a resource's table — into a small list of FACTS, and the
+ * later steps are told those facts instead of re-deriving them from the files. A later step that is
+ * handed the authoritative names does not invent a second spelling of them, and that is the whole
+ * point: it removes the class of errors that live BETWEEN steps.
+ *
+ * Everything here is data and pure functions. The runtime that extracts, stores and cuts the views
+ * is `@owlmeans/agent`'s `cumulativeResultsPlugin`; the prompt block it lands in is
+ * `@owlmeans/llm`'s. A backend or a browser bundle reads an entry without either.
+ */
+export interface CumulativeResultsHelper {
+    /**
+     * The identity of a fact inside a ledger: what it is, what it is called and where it comes from.
+     * Two facts with one key are one fact, owned by whichever entry produced it first.
+     */
+    factKey: (fact: CumulativeResultFact) => string;
+    /**
+     * Facts in the one order they are ever rendered in: by kind (file facts last), name and location,
+     * with a code-unit comparison so every host sorts them alike.
+     */
+    sortFacts: (facts: readonly CumulativeResultFact[]) => CumulativeResultFact[];
+    /** One fact as one prompt line: kind and name, shape, scalars, pointer, and where it comes from. */
+    renderResultFact: (fact: CumulativeResultFact) => string;
+    /**
+     * An entry's two renderings — in full, and as names only — or two empty strings when it has
+     * nothing to say.
+     *
+     * Deterministic and free of anything that varies between two renderings of the same facts: no
+     * timestamp, no run id, no revision. Over its cap an entry DROPS whole facts, in render order, and
+     * says how many it dropped; it never cuts one fact's line, because half a signature is a wrong
+     * signature. An empty entry that is not partial renders to nothing, so it costs a view nothing.
+     */
+    renderResultEntry: (entry: RenderableResultEntry, caps?: ResultRenderCaps) => RenderedResultEntry;
+    /**
+     * Ledger order: element by element, and where one key is a prefix of the other, the LONGER one
+     * first — an entry of a run composed under a step sorts ahead of that step's own entry, which is
+     * written only once the composed run has finished.
+     */
+    compareResultOrder: (a: readonly number[], b: readonly number[]) => number;
+    /** The root run of a composition — what a composed run's id (`<parent>/<step>`) starts with. */
+    rootRunOf: (runId: string) => string;
+    /**
+     * How an entry is headed: the step, behind the path of composing steps between the ledger's root
+     * run and the run that produced it. A root-run step is headed by its bare name.
+     */
+    resultLabel: (ledger: string, runId: string, step: string) => string;
+    /**
+     * A model's schema-shaped summary as one capped line, the same bytes for the same answer.
+     *
+     * An object renders as `key: value` pairs in key order; one with a single key renders as that
+     * value alone, so the default `{ summary }` answer reads as prose. The cap is applied here, after
+     * the model answered — a cap in a prompt is a request.
+     */
+    renderResultSummary: (answer: unknown, maxChars?: number) => string;
+    /**
+     * Several declarations as one — a pipeline's own, then any overlay (a variant, a deployment).
+     *
+     * Later declarations win field by field, except the lists: extractors, `full` consumers and `omit`
+     * consumers ACCUMULATE, the way skills do down an execution chain, because an overlay that adds an
+     * extractor is not asking to lose the ones the pipeline declared. `'*'` in `full` absorbs names.
+     */
+    mergeResultsSpecs: (...specs: Array<CumulativeResultsSpec | null | undefined>) => CumulativeResultsSpec;
+}
+//# sourceMappingURL=types.d.ts.map

package/build/results/types.d.ts.map

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

package/build/results/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/build/results/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/results/types.ts"],"names":[],"mappings":""}

package/build/results.d.ts

@@ -0,0 +1,4 @@
+import type { CumulativeResultsHelper } from './results/types.js';
+export declare const createCumulativeResultsHelper: () => CumulativeResultsHelper;
+export declare const cumulativeResultsHelper: CumulativeResultsHelper;
+//# sourceMappingURL=results.d.ts.map

package/build/results.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"results.d.ts","sourceRoot":"","sources":["../src/results.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACY,uBAAuB,EAE9C,MAAM,oBAAoB,CAAA;AAE3B,eAAO,MAAM,6BAA6B,QAAO,uBAmQhD,CAAA;AAED,eAAO,MAAM,uBAAuB,yBAAkC,CAAA"}