@eir-labs/coltrane 0.4.0

package/dist/src/composition.js

@@ -0,0 +1,447 @@
+import { PRIMITIVE_OUTPUT_TYPE } from "./core_types.js";
+import { AgentSchema } from "./genome_schema.js";
+export class CompositionError extends Error {
+}
+// A definition that is structurally parseable but INCOMPLETE against the current schema —
+// e.g. an agent missing its now-required behavioral representation. Distinct from
+// CompositionError (a malformed/illegal definition): an incomplete genome must be UPGRADED
+// (fill in the missing features), so the loader HARD-fails on this rather than soft-skipping
+// the file. Underdeveloped is not the same as broken.
+export class GenomeIncompleteError extends Error {
+}
+const ROOT_PRIMITIVES = new Set(["SENSE"]);
+const NEEDS_UPSTREAM_REASONING = new Set(["CREATE"]);
+const NEEDS_TARGET = new Set(["VERIFY"]);
+const REASONING = new Set(["INTERPRET", "PLAN", "SENSE"]);
+export function defineAgent(def) {
+    const prims = def.primitives;
+    // A string passes `.length === 0`, so a wrong-type `primitives` (e.g. "SENSE")
+    // would otherwise load a broken agent silently. Reject non-arrays by field name.
+    if (!Array.isArray(prims)) {
+        throw new CompositionError(`agent ${def.slug}: "primitives" must be an array, got ${typeof prims}`);
+    }
+    if (prims.length === 0) {
+        throw new CompositionError(`agent ${def.slug} has no primitives`);
+    }
+    // Per-agent sanity: when multiple primitives are bundled in a single agent
+    // (e.g. [PLAN, CREATE]), an inner CREATE position needs an inner PLAN or
+    // INTERPRET upstream of it. Standalone CREATE/[CREATE] is admitted at this
+    // layer; the cross-phase §3 gate enforces "upstream reasoning" across phases
+    // in composeStandard. This split lets a CREATE-only agent compose into a
+    // standard where the upstream phase supplies the reasoning.
+    for (let i = 1; i < prims.length; i++) {
+        const p = prims[i];
+        if (NEEDS_UPSTREAM_REASONING.has(p)) {
+            const upstream = prims.slice(0, i);
+            const hasReasoning = upstream.some((u) => u === "INTERPRET" || u === "PLAN");
+            if (!hasReasoning) {
+                throw new CompositionError(`agent ${def.slug}: CREATE at position ${i} has no upstream INTERPRET or PLAN`);
+            }
+        }
+        if (NEEDS_TARGET.has(p)) {
+            const upstream = prims.slice(0, i);
+            if (upstream.length === 0) {
+                throw new CompositionError(`agent ${def.slug}: VERIFY has no upstream target`);
+            }
+        }
+    }
+    // Behavioral representation is mandatory — checked AFTER the structural (primitive)
+    // validation so a malformed agent reports its structural defect first. Missing behavioral
+    // representation is INCOMPLETE (a schema-migration gap, distinct from malformed): like any
+    // invalid agent it HARD-fails the load — a genome must load cleanly to run, never hollow.
+    if (typeof def.identity !== "string" || def.identity.trim() === "") {
+        throw new GenomeIncompleteError(`agent ${def.slug}: identity is required (who the agent is) — fill it in to upgrade the genome`);
+    }
+    if (typeof def.method !== "string" || def.method.trim() === "") {
+        throw new GenomeIncompleteError(`agent ${def.slug}: method is required (how the agent works) — fill it in to upgrade the genome`);
+    }
+    // Widen past the compile-time 2-tuple: the JSON-authored path reaches here as `any`, so the
+    // disposition's arity is only really known at runtime — these guards protect that path.
+    const bp = def.behavioral_primitives;
+    if (!Array.isArray(bp) || bp.length === 0) {
+        throw new GenomeIncompleteError(`agent ${def.slug}: behavioral_primitives (disposition) is required — fill it in to upgrade the genome`);
+    }
+    // The disposition is a PAIRING: exactly two roles in tension. One role is a single voice;
+    // three+ dilute the tension. A genome carrying a non-pair is malformed against the contract,
+    // so it hard-fails the load rather than rendering a confused Disposition layer.
+    if (bp.length !== 2) {
+        throw new GenomeIncompleteError(`agent ${def.slug}: behavioral_primitives must be exactly two roles in tension, got ${bp.length} — a disposition is a pairing`);
+    }
+    if (!Array.isArray(def.constraints)) {
+        throw new GenomeIncompleteError(`agent ${def.slug}: constraints is required (use [] for none) — fill it in to upgrade the genome`);
+    }
+    // LOSS-FREE projection via the single-source schema (genome_schema.ts AgentSchema): parse
+    // PRESERVES every field the schema declares (browser_grant, the cage grants, …) and applies
+    // defaults — no hand-enumerated literal to silently drop a sealed field (the bug this whole change
+    // closes). The structural + behavioral checks above already threw the precise error types; if the
+    // schema rejects a shape those missed, surface it as a load-hard GenomeIncompleteError.
+    let parsed;
+    try {
+        parsed = AgentSchema.parse(def);
+    }
+    catch (e) {
+        throw new GenomeIncompleteError(`agent ${def.slug}: ${e instanceof Error ? e.message : String(e)}`);
+    }
+    // output_types derives from the last primitive's output type when not declared (stays here, not
+    // in the schema, because the default depends on another field). The cage arrays fill to [] to
+    // match the prior runtime shape (deny-by-default = an empty grant, never undefined).
+    const output_types = parsed.output_types.length > 0
+        ? parsed.output_types
+        : prims.map((p) => PRIMITIVE_OUTPUT_TYPE[p]).slice(-1);
+    return {
+        ...parsed,
+        output_types,
+        allowed_tools: parsed.allowed_tools ?? [],
+        disallowed_tools: parsed.disallowed_tools ?? [],
+        skill_slugs: parsed.skill_slugs ?? [],
+    };
+}
+export function composeStandard(def) {
+    const agentBySlug = new Map(def.agents.map((a) => [a.slug, a]));
+    // Reject legacy {name, agent} phase shape at the boundary. Chairs is the only
+    // supported shape; the legacy field never reaches the runtime.
+    for (const p of def.phases) {
+        const legacy = p;
+        if (legacy.agent !== undefined) {
+            throw new CompositionError(`standard ${def.slug}: phase ${legacy.name} uses legacy phase.agent — not supported; declare chairs[] instead`);
+        }
+        if (legacy.chairs === undefined) {
+            throw new CompositionError(`standard ${def.slug}: phase ${legacy.name} missing chairs[] (chairs required on every phase)`);
+        }
+    }
+    // #187 — optional chair array fields default to [] (the loader already tolerates omitted
+    // fields; composeStandard must not be stricter than the loader it feeds). A chair that omits
+    // required_skills / depends_on / input_contract / output_contract is treated as empty, not a
+    // raw "ch.<field> is not iterable" TypeError.
+    const phases = def.phases.map((p) => ({
+        name: p.name,
+        chairs: p.chairs.map((ch) => ({
+            ...ch,
+            role: ch.role ?? "",
+            agent_slug: ch.agent_slug ?? "",
+            depends_on: ch.depends_on ?? [],
+            input_contract: ch.input_contract ?? [],
+            output_contract: ch.output_contract ?? [],
+            required_skills: ch.required_skills ?? [],
+        })),
+    }));
+    // ── Chair-level validation ─────────────────────────────────────────────────
+    // (a) every phase has at least one chair
+    // (b) role uniqueness — within phase + across phases of this standard
+    // (c) every chair's agent_slug resolves to an agent in this standard
+    // (d) every chair's required_skills are declared on its bound agent
+    // (e) every chair's output_contract is non-empty
+    const seenRoles = new Map(); // role → phase name
+    for (const ph of phases) {
+        if (ph.chairs.length === 0) {
+            throw new CompositionError(`standard ${def.slug}: phase ${ph.name} has empty chairs array (every phase needs ≥1 chair)`);
+        }
+        const phaseRoles = new Set();
+        for (const ch of ph.chairs) {
+            if (phaseRoles.has(ch.role)) {
+                throw new CompositionError(`standard ${def.slug}: duplicate role "${ch.role}" within phase ${ph.name}`);
+            }
+            phaseRoles.add(ch.role);
+            if (seenRoles.has(ch.role)) {
+                throw new CompositionError(`standard ${def.slug}: duplicate role "${ch.role}" across phases (also in ${seenRoles.get(ch.role)})`);
+            }
+            seenRoles.set(ch.role, ph.name);
+            // A skill-backed chair (skill_slug set, no agent_slug) runs the skill's deterministic
+            // code half instead of an agent — skip the agent/required-skills checks for it. The
+            // type-flow (input/output_contract) below still applies.
+            const isSkillChair = !!ch.skill_slug && (ch.agent_slug ?? "") === "";
+            if (!isSkillChair) {
+                const ag = agentBySlug.get(ch.agent_slug);
+                if (!ag) {
+                    throw new CompositionError(`standard ${def.slug}: chair "${ch.role}" references unknown agent "${ch.agent_slug}" (not in standard's agents list)`);
+                }
+                const declared = new Set(ag.skill_slugs ?? []);
+                for (const sk of ch.required_skills) {
+                    if (!declared.has(sk)) {
+                        throw new CompositionError(`standard ${def.slug}: chair "${ch.role}" requires skill "${sk}" which agent "${ag.slug}" does not declare`);
+                    }
+                }
+            }
+            if (ch.output_contract.length === 0) {
+                throw new CompositionError(`standard ${def.slug}: chair "${ch.role}" has empty output_contract (every chair must declare ≥1 output type)`);
+            }
+            // #243 — an optional_outputs entry naming nothing in the contract silently WIDENS the
+            // floor it was meant to narrow: the typo'd name excuses nothing, and the type the author
+            // meant to mark optional stays required while they believe otherwise. That is the exact
+            // class of bug the floor exists to close, so it is caught where the genome is authored
+            // rather than mid-run.
+            for (const opt of ch.optional_outputs ?? []) {
+                if (!ch.output_contract.includes(opt)) {
+                    throw new CompositionError(`standard ${def.slug}: chair "${ch.role}" marks "${opt}" optional but does not promise it — ` +
+                        `optional_outputs must be a subset of output_contract [${ch.output_contract.join(", ")}]`);
+                }
+            }
+            // #243 — a skill-backed chair seals exactly ONE output: its deterministic code half
+            // returns a single blob, and `prepareChair` takes `output_contract[0]` and discards the
+            // rest. So a multi-entry contract on a skill chair is a promise the runtime structurally
+            // cannot keep — and, worse, cannot even REPORT breaking, because the floor is computed
+            // over the one spec that was built. Silent since the skill path was added. Reject it
+            // here, where the author can see it, rather than letting entries 2..N evaporate.
+            if (ch.skill_slug && (ch.agent_slug ?? "") === "" && ch.output_contract.length > 1) {
+                throw new CompositionError(`standard ${def.slug}: skill-backed chair "${ch.role}" promises ${ch.output_contract.length} output types ` +
+                    `[${ch.output_contract.join(", ")}] but a skill seals exactly one. Only "${ch.output_contract[0]}" would ` +
+                    `ever be produced and the rest would be silently dropped — split the work across chairs, or back this ` +
+                    `chair with an agent.`);
+            }
+        }
+    }
+    // ── depends_on validation: walk roles in phase-then-chair order ────────────
+    // (f) self-reference is a cycle
+    // (g) forward reference (depends_on a role declared in a later phase) is rejected
+    // (h) unknown role in depends_on is rejected
+    // (i) cycle detection across the full role graph
+    const rolePhaseIndex = new Map(); // role → phase index
+    for (let i = 0; i < phases.length; i++) {
+        for (const ch of phases[i].chairs) {
+            rolePhaseIndex.set(ch.role, i);
+        }
+    }
+    for (let i = 0; i < phases.length; i++) {
+        for (const ch of phases[i].chairs) {
+            for (const dep of ch.depends_on) {
+                if (dep === ch.role) {
+                    throw new CompositionError(`standard ${def.slug}: chair "${ch.role}" depends_on itself (self-cycle)`);
+                }
+                const depPhase = rolePhaseIndex.get(dep);
+                if (depPhase === undefined) {
+                    throw new CompositionError(`standard ${def.slug}: chair "${ch.role}" depends_on unknown role "${dep}" (undeclared in this standard)`);
+                }
+                if (depPhase > i) {
+                    throw new CompositionError(`standard ${def.slug}: chair "${ch.role}" (phase ${phases[i].name}) has forward reference to "${dep}" (phase ${phases[depPhase].name}); depends_on must point to an earlier or same-phase role`);
+                }
+            }
+        }
+    }
+    // Cycle detection across the full role graph (DFS with grey/black coloring).
+    // Self-cycles are already caught above; this finds longer cycles like A→B→A.
+    const adj = new Map();
+    for (const ph of phases) {
+        for (const ch of ph.chairs) {
+            adj.set(ch.role, ch.depends_on);
+        }
+    }
+    const WHITE = 0, GREY = 1, BLACK = 2;
+    const color = new Map();
+    for (const role of adj.keys())
+        color.set(role, WHITE);
+    function dfs(role) {
+        color.set(role, GREY);
+        for (const dep of adj.get(role) ?? []) {
+            const c = color.get(dep);
+            if (c === GREY) {
+                throw new CompositionError(`standard ${def.slug}: cycle in depends_on graph involving role "${role}" → "${dep}"`);
+            }
+            if (c === WHITE)
+                dfs(dep);
+        }
+        color.set(role, BLACK);
+    }
+    for (const role of adj.keys()) {
+        if (color.get(role) === WHITE)
+            dfs(role);
+    }
+    // ── input_contract satisfaction ───────────────────────────────────────────
+    // Each chair's declared input_contract must be covered by the union of its
+    // depends_on chairs' output_contracts — OR by the standard's declared gig inputs
+    // (#156: an ENTRY chair, depends_on [], reads its typed input_contract from gigInput;
+    // that contract IS the typed gig seed, validated against gigInput at start-of-run by runGig).
+    const gigInputs = new Set(def.input_types ?? []);
+    const chairByRole = new Map();
+    for (const ph of phases) {
+        for (const ch of ph.chairs)
+            chairByRole.set(ch.role, ch);
+    }
+    for (const ph of phases) {
+        for (const ch of ph.chairs) {
+            if (ch.input_contract.length === 0)
+                continue;
+            const produced = new Set(gigInputs); // gig inputs are available to any chair
+            for (const dep of ch.depends_on) {
+                const upstream = chairByRole.get(dep);
+                if (!upstream)
+                    continue; // already reported above
+                for (const t of upstream.output_contract)
+                    produced.add(t);
+            }
+            for (const need of ch.input_contract) {
+                if (!produced.has(need)) {
+                    throw new CompositionError(`standard ${def.slug}: chair "${ch.role}" input_contract requires "${need}" not produced by any upstream chair (depends_on=[${ch.depends_on.join(",")}])`);
+                }
+            }
+        }
+    }
+    // ── Legacy primitive-graph + domain checks (operate on normalized phases) ──
+    // These predate chairs; they enforce SENSE/CREATE/VERIFY positional rules
+    // across the agents bound by each phase's chairs. For multi-chair phases we
+    // treat the chair set as the phase's agents (order: declaration order).
+    for (const ph of phases) {
+        for (const ch of ph.chairs) {
+            if (ch.skill_slug && !ch.agent_slug)
+                continue; // skill-backed chair: no agent to domain-check
+            const ag = agentBySlug.get(ch.agent_slug); // existence verified above
+            // Rob #134: agents with no explicit domain (null OR undefined) are
+            // domain-agnostic — compatible with any standard. Only reject when the
+            // agent declares an explicit domain that conflicts with the standard's.
+            if (ag.domain != null && ag.domain !== def.domain) {
+                throw new CompositionError(`standard ${def.slug}: agent ${ag.slug}.domain=${ag.domain} ≠ standard.domain=${def.domain}`);
+            }
+        }
+    }
+    // The gig contract (#177): types entering from outside the standard count as available
+    // upstream for the agent-level gates — a faithful agent consuming a cross-standard/gig input
+    // is not "input from nowhere", and such an input can be a standalone-CREATE's reasoner.
+    const standardInputs = new Set(def.input_types ?? []);
+    const upstreamOutputs = new Set(standardInputs);
+    const upstreamPhasePrimitives = new Set();
+    for (let i = 0; i < phases.length; i++) {
+        const ph = phases[i];
+        // For the legacy primitive-graph check we consider each chair in turn,
+        // treating prior chairs (same phase or earlier) as the upstream bag.
+        for (const ch of ph.chairs) {
+            if (ch.skill_slug && !ch.agent_slug)
+                continue; // skill-backed chair: not in the primitive graph
+            const ag = agentBySlug.get(ch.agent_slug);
+            if (i > 0) {
+                // #188: check what THIS PLACEMENT actually consumes, not the agent's GLOBAL input_types
+                // (its capability envelope across all roles) — so an agent reused across chairs isn't
+                // blocked at an early, lean placement by a type only a later chair needs. Mirror the
+                // runtime's own input resolution (prepareChair): a chair that declares an input_contract
+                // (or a depends_on) is in the faithful path — check its input_contract; a chair that
+                // declares neither falls back to the agent's input_types (the legacy all-prior-outputs
+                // filter the runtime uses for it). Checked against upstream-produced ∪ standard.input_types.
+                const consumed = ch.input_contract.length > 0
+                    ? ch.input_contract
+                    : ch.depends_on.length === 0 ? ag.input_types : [];
+                for (const it of consumed) {
+                    if (it && !upstreamOutputs.has(it)) {
+                        throw new CompositionError(`standard ${def.slug}: phase ${ph.name} input ${it} not produced upstream`);
+                    }
+                }
+            }
+            const firstPrim = ag.primitives[0];
+            if (firstPrim && NEEDS_UPSTREAM_REASONING.has(firstPrim)) {
+                const agentSelfHasReasoning = ag.primitives.slice(1).some((u) => u === "INTERPRET" || u === "PLAN");
+                const phaseUpstreamHasReasoning = upstreamPhasePrimitives.has("INTERPRET") || upstreamPhasePrimitives.has("PLAN");
+                // #177: a standalone CREATE whose input arrives as a gig/cross-standard input has its
+                // reasoner supplied from outside the standard — the in-standard upstream isn't the only
+                // valid source of reasoning.
+                const gigSuppliesReasoning = ag.input_types.some((it) => standardInputs.has(it));
+                if (!agentSelfHasReasoning && !phaseUpstreamHasReasoning && !gigSuppliesReasoning) {
+                    throw new CompositionError(`standard ${def.slug}: phase ${ph.name} (${ag.slug}) starts with CREATE but no upstream phase supplies INTERPRET or PLAN`);
+                }
+            }
+            if (firstPrim && NEEDS_TARGET.has(firstPrim)) {
+                if (upstreamPhasePrimitives.size === 0 && ag.primitives.length === 1) {
+                    throw new CompositionError(`standard ${def.slug}: phase ${ph.name} (${ag.slug}) starts with VERIFY but no upstream phase target`);
+                }
+            }
+        }
+        // After processing all chairs in this phase, fold their primitives + outputs
+        // into the upstream bag for subsequent phases.
+        for (const ch of ph.chairs) {
+            if (ch.skill_slug && !ch.agent_slug) {
+                // a skill-backed chair produces its declared output_contract types — fold those into
+                // the upstream bag so a downstream agent chair can consume them.
+                for (const ot of ch.output_contract)
+                    upstreamOutputs.add(ot);
+                continue;
+            }
+            const ag = agentBySlug.get(ch.agent_slug);
+            for (const p of ag.primitives)
+                upstreamPhasePrimitives.add(p);
+            for (const ot of ag.output_types)
+                upstreamOutputs.add(ot);
+        }
+    }
+    // #181 — the legacy agent-to-agent producer/consumer cycle check below reasons over
+    // agent-GLOBAL input_types/output_types. That collapses a multi-chair agent (one chair
+    // producing T, a later one consuming T via depends_on) into a single node and false-flags it as
+    // a self-cycle. The authoritative dataflow is the chair depends_on graph — already validated
+    // acyclic above (`dfs`). So defer to it: a type T that is produced AND consumed in-standard is a
+    // legal PIPELINE (not a cycle) when every chair consuming T transitively depends on a chair
+    // producing T. Only when that ordering is absent (the legacy no-depends_on shape, or a genuine
+    // loop the role DAG didn't already reject) does the coarser agent-global check still apply.
+    const transitiveDeps = new Map();
+    function depsOf(role) {
+        const cached = transitiveDeps.get(role);
+        if (cached)
+            return cached;
+        const acc = new Set();
+        transitiveDeps.set(role, acc); // set before recursion; the graph is already proven acyclic
+        for (const d of adj.get(role) ?? []) {
+            acc.add(d);
+            for (const x of depsOf(d))
+                acc.add(x);
+        }
+        return acc;
+    }
+    const producerRoles = new Map();
+    const consumerRoles = new Map();
+    for (const ph of phases) {
+        for (const ch of ph.chairs) {
+            for (const t of ch.output_contract)
+                producerRoles.set(t, [...(producerRoles.get(t) ?? []), ch.role]);
+            for (const t of ch.input_contract)
+                consumerRoles.set(t, [...(consumerRoles.get(t) ?? []), ch.role]);
+        }
+    }
+    // T is a clean in-standard pipeline iff a chair produces it AND every chair consuming it
+    // transitively depends_on a chair that produces it (producer precedes consumer, role-scoped).
+    const pipelineOrdered = (t) => {
+        const producers = producerRoles.get(t) ?? [];
+        if (producers.length === 0)
+            return false;
+        const consumers = consumerRoles.get(t) ?? [];
+        return consumers.every((c) => producers.some((p) => depsOf(c).has(p)));
+    };
+    const produces = new Map();
+    for (const ag of def.agents) {
+        for (const ot of ag.output_types) {
+            if (produces.has(ot))
+                continue;
+            produces.set(ot, ag.slug);
+        }
+    }
+    for (const ag of def.agents) {
+        for (const it of ag.input_types) {
+            if (produces.has(it)) {
+                // #183: the TRIGGER must be chair-scoped too, not just the #181 exoneration. `produces`
+                // and the loop above read agent-GLOBAL output_types/input_types — a capability envelope.
+                // A type the agent can globally read+write but which no chair in THIS standard realizes is
+                // not this standard's dataflow and cannot form a cycle here. Only a type a chair both
+                // produces AND consumes in-standard is a candidate; everything else is "not my problem".
+                const chairProduces = (producerRoles.get(it)?.length ?? 0) > 0;
+                const chairConsumes = (consumerRoles.get(it)?.length ?? 0) > 0;
+                if (!chairProduces || !chairConsumes)
+                    continue;
+                // #181: the chair graph orders this type's producer before its consumer → legal pipeline.
+                if (pipelineOrdered(it))
+                    continue;
+                const producer = produces.get(it);
+                const producerAgent = agentBySlug.get(producer);
+                if (producerAgent) {
+                    for (const pIn of producerAgent.input_types) {
+                        for (const myOut of ag.output_types) {
+                            if (pIn === myOut) {
+                                throw new CompositionError(`standard ${def.slug}: cycle detected between ${ag.slug} and ${producer}`);
+                            }
+                        }
+                    }
+                }
+            }
+        }
+    }
+    // LOSS-FREE: spread the whole def, then override the two transform outputs — `phases` (the
+    // validated PhaseDef) and `input_types` (the deduped standard-input set). Every other declared
+    // field (eval_slugs / output_types / max_examine_rounds / description + anything added later to
+    // StandardSchema) rides through automatically, so composition can't silently drop a sealed field —
+    // the bug this whole change closes. The engine doesn't yet ENFORCE max_examine_rounds (separate task).
+    const std = { ...def, phases, input_types: [...standardInputs] };
+    return std;
+}
+//# sourceMappingURL=composition.js.map

package/dist/src/composition.js.map

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

package/dist/src/core_types.d.ts

@@ -0,0 +1,6 @@
+export type CoreType = "Signal" | "Interpretation" | "Judgment" | "Plan" | "Artifact" | "Verdict";
+export type Primitive = "SENSE" | "INTERPRET" | "JUDGE" | "PLAN" | "CREATE" | "VERIFY";
+export type ReferenceType = "derived_from" | "validates" | "challenges" | "refines" | "triggers" | "contains";
+export declare const CORE_TYPES: readonly CoreType[];
+export declare const REFERENCE_TYPES: readonly ReferenceType[];
+export declare const PRIMITIVE_OUTPUT_TYPE: Readonly<Record<Primitive, CoreType>>;

package/dist/src/core_types.js

@@ -0,0 +1,25 @@
+export const CORE_TYPES = [
+    "Signal",
+    "Interpretation",
+    "Judgment",
+    "Plan",
+    "Artifact",
+    "Verdict",
+];
+export const REFERENCE_TYPES = [
+    "derived_from",
+    "validates",
+    "challenges",
+    "refines",
+    "triggers",
+    "contains",
+];
+export const PRIMITIVE_OUTPUT_TYPE = {
+    SENSE: "Signal",
+    INTERPRET: "Interpretation",
+    JUDGE: "Judgment",
+    PLAN: "Plan",
+    CREATE: "Artifact",
+    VERIFY: "Verdict",
+};
+//# sourceMappingURL=core_types.js.map

package/dist/src/core_types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"core_types.js","sourceRoot":"","sources":["../../src/core_types.ts"],"names":[],"mappings":"AAwBA,MAAM,CAAC,MAAM,UAAU,GAAwB;IAC7C,QAAQ;IACR,gBAAgB;IAChB,UAAU;IACV,MAAM;IACN,UAAU;IACV,SAAS;CACV,CAAC;AAEF,MAAM,CAAC,MAAM,eAAe,GAA6B;IACvD,cAAc;IACd,WAAW;IACX,YAAY;IACZ,SAAS;IACT,UAAU;IACV,UAAU;CACX,CAAC;AAEF,MAAM,CAAC,MAAM,qBAAqB,GAA0C;IAC1E,KAAK,EAAE,QAAQ;IACf,SAAS,EAAE,gBAAgB;IAC3B,KAAK,EAAE,UAAU;IACjB,IAAI,EAAE,MAAM;IACZ,MAAM,EAAE,UAAU;IAClB,MAAM,EAAE,SAAS;CAClB,CAAC"}

package/dist/src/document_factory.d.ts

@@ -0,0 +1,89 @@
+export interface InferenceRequest {
+    dataset: Record<string, unknown>;
+    instruction: string;
+    response_type: ResponseShape;
+    constraints: readonly string[];
+}
+export interface ResponseShape {
+    fields: Record<string, "string" | "number" | "boolean">;
+    maxLength?: Record<string, number>;
+}
+export type InferenceResponse = Record<string, unknown>;
+export type Inferer = (req: InferenceRequest) => InferenceResponse;
+export declare class FactoryError extends Error {
+}
+/** Validate a response against its shape. Returns null if ok, else the reason. */
+export declare function checkShape(resp: InferenceResponse, shape: ResponseShape): string | null;
+/** Run one inference call under the contract: validate the typed return; on a miss,
+ *  retry ONCE with the error fed back into constraints; then fail loud. Never
+ *  silently passes a non-conforming response (the T3 discipline). */
+export declare function runInference(req: InferenceRequest, infer: Inferer): InferenceResponse;
+/** Build the prompt for one inference call. PURE — same request, same prompt.
+ *  The dataset is the ONLY material; constraints are hard prohibitions; the
+ *  response shape is stated as the exact JSON contract the model must return. */
+export declare function buildInfererPrompt(req: InferenceRequest): string;
+export interface ClaudeInfererOptions {
+    bin?: string | undefined;
+    model?: string | undefined;
+    /**
+     * #225 — wall-clock bound on the inference spawn. This call is SYNCHRONOUS, so an
+     * unbounded child wedges the whole process; a tool-granted child has no inherent
+     * terminus. Defaults to the same bound the chair invoker uses.
+     */
+    timeout_ms?: number | undefined;
+    run?: ((bin: string, args: string[]) => string) | undefined;
+}
+/** The production Inferer. Spawns `claude -p <prompt>` and parses the JSON it
+ *  returns (reusing extractJson — tolerant of fences/prose). The CLI spawn is the
+ *  one non-deterministic seam; inject `run` to test the prompt-build + parse path. */
+export declare function makeClaudeInferer(opts?: ClaudeInfererOptions): Inferer;
+export type Fact = string;
+export interface IntentProfile {
+    doc_type: string;
+    classification: string;
+    supplied_context: Record<string, Fact[]>;
+}
+export interface Skeleton {
+    sections: string[];
+    density_targets: Record<string, number>;
+}
+export interface Slot {
+    id: string;
+    facts: Fact[];
+    constraints: readonly string[];
+    response_type: ResponseShape;
+    target_length: number;
+}
+export interface Phrasing {
+    slot_id: string;
+    text: string;
+}
+export interface CoherentDraft {
+    audience: string;
+    doc_type: string;
+    body: string;
+}
+export declare const GOVERNING_RULES: readonly string[];
+export interface DocSchema {
+    sections: string[];
+    density_targets?: Record<string, number>;
+}
+export type SchemaPack = Record<string, DocSchema>;
+export declare const SCHEMA_PACK: SchemaPack;
+/** Load a schema-pack from a genome JSON file (eir_document_schemas.json). Validates
+ *  each entry has a non-empty sections[] and a "default" exists — fails loud, so a
+ *  malformed genome can never silently degrade to the bootstrap pack. */
+export declare function loadSchemaPack(path: string): SchemaPack;
+export declare function selectSkeleton(intent: IntentProfile, pack?: SchemaPack): Skeleton;
+export declare function bindSlots(skeleton: Skeleton, intent: IntentProfile): Slot[];
+export declare function composePhrasings(slots: readonly Slot[], infer: Inferer): Phrasing[];
+export declare function smoothCoherence(phrasings: readonly Phrasing[], intent: IntentProfile, infer: Inferer): CoherentDraft;
+export declare function render(draft: CoherentDraft): string;
+export interface FactoryResult {
+    skeleton: Skeleton;
+    slots: Slot[];
+    dropped: string[];
+    phrasings: Phrasing[];
+    artifact: string;
+}
+export declare function runFactory(intent: IntentProfile, infer: Inferer, pack?: SchemaPack): FactoryResult;