@petepetrash/circuit 0.1.0

package/dist/schemas/work-contract-projection.js

@@ -0,0 +1,232 @@
+import { z } from 'zod';
+import { FlowAxes } from './axes.js';
+import { EquipmentEnforcement, EquipmentToolScope } from './equipment-scope.js';
+import { CompiledFlowId, ProtocolId, SkillSlotId, StageId, StepId } from './ids.js';
+import { JsonObject } from './json.js';
+import { RecoveryRouteBindingV0 } from './recovery-route-kind.js';
+import { Ref } from './ref.js';
+import { RouteMap } from './step.js';
+export { RecoveryFailureCause, RecoveryOperatorAuthority, RecoveryRequiredRefKind, RecoveryRouteBindingV0, RecoveryRouteKind, } from './recovery-route-kind.js';
+const ReportSlot = z
+    .object({
+    step_id: StepId,
+    slot: z.string().min(1),
+    path: z.string().min(1),
+    schema: z.string().min(1),
+})
+    .strict();
+const ContractRoute = z
+    .object({
+    step_id: StepId,
+    route_id: z.string().min(1),
+    target: z.string().min(1),
+})
+    .strict();
+const ContractBlock = z
+    .object({
+    step_id: StepId,
+    title: z.string().min(1),
+    kind: z.enum(['compose', 'verification', 'checkpoint', 'relay', 'sub-run', 'fanout']),
+    executor: z.enum(['orchestrator', 'worker']),
+    protocol: ProtocolId,
+    reads: z.array(z.string()),
+    writes: JsonObject,
+    check: JsonObject,
+    routes: RouteMap,
+    route_from_report: JsonObject.optional(),
+})
+    .strict();
+const ContractSkillSlot = z
+    .object({
+    step_id: StepId,
+    slot_id: SkillSlotId,
+    description: z.string().min(1),
+})
+    .strict();
+// The tools sub-axis of equipment scope, surfaced as a legible authority grant:
+// which tools a step is scoped to, and whether that scope is enforced at the
+// write tier or merely offered as guidance (trusted). Only steps that declare a
+// non-default scope appear here.
+const ContractEquipmentScope = z
+    .object({
+    step_id: StepId,
+    tools: EquipmentToolScope,
+    enforcement: EquipmentEnforcement,
+})
+    .strict();
+const ContractRelay = z
+    .object({
+    step_id: StepId,
+    role: z.enum(['researcher', 'implementer', 'reviewer']),
+    writes: JsonObject,
+    report: ReportSlot.optional(),
+})
+    .strict();
+const ContractCheckpointChoices = z.discriminatedUnion('kind', [
+    z
+        .object({
+        kind: z.literal('static'),
+        ids: z.array(z.string().min(1)).min(1),
+    })
+        .strict(),
+    z
+        .object({
+        kind: z.literal('dynamic'),
+        source_ref: JsonObject,
+    })
+        .strict(),
+]);
+const ContractCheckpoint = z
+    .object({
+    step_id: StepId,
+    choices: ContractCheckpointChoices,
+    writes: JsonObject,
+})
+    .strict();
+const ContractSubRun = z
+    .object({
+    step_id: StepId,
+    flow_ref: JsonObject,
+    goal: z.string().min(1),
+    depth: z.string().min(1),
+    writes: JsonObject,
+})
+    .strict();
+const ContractFanout = z
+    .object({
+    step_id: StepId,
+    branches: JsonObject,
+    writes: JsonObject,
+})
+    .strict();
+const AcceptanceCriteriaInput = z
+    .object({
+    kind: z.literal('acceptance_criteria_input'),
+    step_id: StepId,
+    criteria: JsonObject,
+})
+    .strict();
+const CheckInput = z
+    .object({
+    step_id: StepId,
+    check_kind: z.string().min(1),
+    source: JsonObject,
+})
+    .strict();
+const BudgetLimit = z
+    .object({
+    step_id: StepId,
+    max_attempts: z.number().int().positive().optional(),
+    wall_clock_ms: z.number().int().positive().optional(),
+})
+    .strict();
+export const ProjectionViolation = z
+    .object({
+    path: z.string().min(1),
+    field: z.string().min(1),
+    reason: z.string().min(1),
+    source_ref: Ref,
+})
+    .strict();
+export const WorkContractProjectionV0 = z
+    .object({
+    schema_version: z.literal(0),
+    contract_ref: Ref,
+    work_contract: z
+        .object({
+        flow: z
+            .object({
+            id: CompiledFlowId,
+            version: z.string().min(1),
+            purpose: z.string().min(1),
+            axes: FlowAxes,
+            starts_at: StepId,
+        })
+            .strict(),
+        topology: z
+            .object({
+            stages: z.array(z
+                .object({
+                id: StageId,
+                title: z.string().min(1),
+                canonical: z.string().min(1).optional(),
+                steps: z.array(StepId).min(1),
+            })
+                .strict()),
+            stage_path_policy: JsonObject,
+            routes: z.array(ContractRoute),
+        })
+            .strict(),
+        blocks: z.array(ContractBlock).min(1),
+        authority: z
+            .object({
+            relays: z.array(ContractRelay),
+            checkpoints: z.array(ContractCheckpoint),
+            sub_runs: z.array(ContractSubRun),
+            fanouts: z.array(ContractFanout),
+            skill_slots: z.array(ContractSkillSlot),
+            equipment_scopes: z.array(ContractEquipmentScope),
+        })
+            .strict(),
+        proof: z
+            .object({
+            reports: z.array(ReportSlot),
+            checks: z.array(CheckInput),
+            acceptance_criteria: z.array(AcceptanceCriteriaInput),
+        })
+            .strict(),
+        recovery: z.array(RecoveryRouteBindingV0),
+        limits: z
+            .object({
+            budgets: z.array(BudgetLimit),
+        })
+            .strict(),
+    })
+        .strict(),
+    guidance_seed: z
+        .object({
+        selection_hints: z.array(Ref),
+        connector_hints: z.array(Ref),
+        skill_hints: z.array(Ref),
+        checkpoint_default_hints: z.array(Ref),
+        host_recommendations: z.array(Ref).default([]),
+    })
+        .strict(),
+    rejected_authority: z.array(ProjectionViolation),
+})
+    .strict()
+    .superRefine((projection, ctx) => {
+    const routeTargets = new Map();
+    for (const route of projection.work_contract.topology.routes) {
+        routeTargets.set(`${route.step_id}:${route.route_id}`, route.target);
+    }
+    const seenRecovery = new Set();
+    for (const [index, binding] of projection.work_contract.recovery.entries()) {
+        const key = `${binding.step_id}:${binding.route_id}`;
+        if (seenRecovery.has(key)) {
+            ctx.addIssue({
+                code: 'custom',
+                path: ['work_contract', 'recovery', index, 'route_id'],
+                message: `duplicate recovery binding for ${key}`,
+            });
+        }
+        seenRecovery.add(key);
+        const declaredTarget = routeTargets.get(key);
+        if (declaredTarget === undefined) {
+            ctx.addIssue({
+                code: 'custom',
+                path: ['work_contract', 'recovery', index, 'route_id'],
+                message: 'recovery route binding must name a declared route',
+            });
+            continue;
+        }
+        if (declaredTarget !== binding.route_target) {
+            ctx.addIssue({
+                code: 'custom',
+                path: ['work_contract', 'recovery', index, 'route_target'],
+                message: 'recovery route target must match the declared route target',
+            });
+        }
+    }
+});
+//# sourceMappingURL=work-contract-projection.js.map

package/dist/schemas/work-contract-projection.js.map

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

package/dist/selection/connector-planning.d.ts

@@ -0,0 +1,23 @@
+import type { FlowVariantModel, FlowVariantModels, LayeredConfig as LayeredConfigValue } from '../schemas/config.js';
+import type { RelayResolutionSource } from '../schemas/connector.js';
+import type { ResolvedSelection } from '../schemas/selection-policy.js';
+export interface PrototypeVariantConnectorPlan {
+    readonly variantId: FlowVariantModel['id'];
+    readonly connectorName: string;
+    readonly resolvedFrom: RelayResolutionSource;
+}
+export interface PrototypeVariantConnectorPlanner {
+    planPrototypeVariantConnector(input: {
+        readonly variant: FlowVariantModel;
+        readonly selectionConfigLayers?: readonly LayeredConfigValue[];
+    }): PrototypeVariantConnectorPlan;
+}
+export declare function configuredPrototypeVariants(layers: readonly LayeredConfigValue[] | undefined): FlowVariantModels | undefined;
+export declare function resolvedPrototypeVariantSelection(selection: FlowVariantModel['selection']): ResolvedSelection;
+export declare function planPrototypeVariantConnectorMatrix(input: {
+    readonly variants: FlowVariantModels;
+    readonly expectedCount: number;
+    readonly planner: PrototypeVariantConnectorPlanner;
+    readonly selectionConfigLayers?: readonly LayeredConfigValue[];
+}): readonly PrototypeVariantConnectorPlan[];
+//# sourceMappingURL=connector-planning.d.ts.map

package/dist/selection/connector-planning.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connector-planning.d.ts","sourceRoot":"","sources":["../../src/selection/connector-planning.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,gBAAgB,EAChB,iBAAiB,EACjB,aAAa,IAAI,kBAAkB,EACpC,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AACrE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AAExE,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,SAAS,EAAE,gBAAgB,CAAC,IAAI,CAAC,CAAC;IAC3C,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,YAAY,EAAE,qBAAqB,CAAC;CAC9C;AAED,MAAM,WAAW,gCAAgC;IAC/C,6BAA6B,CAAC,KAAK,EAAE;QACnC,QAAQ,CAAC,OAAO,EAAE,gBAAgB,CAAC;QACnC,QAAQ,CAAC,qBAAqB,CAAC,EAAE,SAAS,kBAAkB,EAAE,CAAC;KAChE,GAAG,6BAA6B,CAAC;CACnC;AAED,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,SAAS,kBAAkB,EAAE,GAAG,SAAS,GAChD,iBAAiB,GAAG,SAAS,CAW/B;AAED,wBAAgB,iCAAiC,CAC/C,SAAS,EAAE,gBAAgB,CAAC,WAAW,CAAC,GACvC,iBAAiB,CAQnB;AAED,wBAAgB,mCAAmC,CAAC,KAAK,EAAE;IACzD,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,CAAC;IACrC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,OAAO,EAAE,gCAAgC,CAAC;IACnD,QAAQ,CAAC,qBAAqB,CAAC,EAAE,SAAS,kBAAkB,EAAE,CAAC;CAChE,GAAG,SAAS,6BAA6B,EAAE,CAe3C"}

package/dist/selection/connector-planning.js

@@ -0,0 +1,31 @@
+export function configuredPrototypeVariants(layers) {
+    let variants;
+    for (const layer of layers ?? []) {
+        const flows = layer.config.flows;
+        const next = flows.prototype?.variant_models;
+        if (next !== undefined)
+            variants = next;
+    }
+    return variants;
+}
+export function resolvedPrototypeVariantSelection(selection) {
+    return {
+        ...(selection.model === undefined ? {} : { model: selection.model }),
+        ...(selection.effort === undefined ? {} : { effort: selection.effort }),
+        skills: [],
+        ...(selection.depth === undefined ? {} : { depth: selection.depth }),
+        invocation_options: selection.invocation_options,
+    };
+}
+export function planPrototypeVariantConnectorMatrix(input) {
+    if (input.variants.length !== input.expectedCount) {
+        throw new Error(`prototype.variant-options@v1 requires exactly axes.tournament_n (${input.expectedCount}) variant_models entries; found ${input.variants.length}`);
+    }
+    return input.variants.map((variant) => input.planner.planPrototypeVariantConnector({
+        variant,
+        ...(input.selectionConfigLayers === undefined
+            ? {}
+            : { selectionConfigLayers: input.selectionConfigLayers }),
+    }));
+}
+//# sourceMappingURL=connector-planning.js.map

package/dist/selection/connector-planning.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connector-planning.js","sourceRoot":"","sources":["../../src/selection/connector-planning.ts"],"names":[],"mappings":"AAqBA,MAAM,UAAU,2BAA2B,CACzC,MAAiD;IAEjD,IAAI,QAAuC,CAAC;IAC5C,KAAK,MAAM,KAAK,IAAI,MAAM,IAAI,EAAE,EAAE,CAAC;QACjC,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,KAG1B,CAAC;QACF,MAAM,IAAI,GAAG,KAAK,CAAC,SAAS,EAAE,cAAc,CAAC;QAC7C,IAAI,IAAI,KAAK,SAAS;YAAE,QAAQ,GAAG,IAAI,CAAC;IAC1C,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,iCAAiC,CAC/C,SAAwC;IAExC,OAAO;QACL,GAAG,CAAC,SAAS,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,SAAS,CAAC,KAAK,EAAE,CAAC;QACpE,GAAG,CAAC,SAAS,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,MAAM,EAAE,CAAC;QACvE,MAAM,EAAE,EAAE;QACV,GAAG,CAAC,SAAS,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,SAAS,CAAC,KAAK,EAAE,CAAC;QACpE,kBAAkB,EAAE,SAAS,CAAC,kBAAkB;KACjD,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,mCAAmC,CAAC,KAKnD;IACC,IAAI,KAAK,CAAC,QAAQ,CAAC,MAAM,KAAK,KAAK,CAAC,aAAa,EAAE,CAAC;QAClD,MAAM,IAAI,KAAK,CACb,oEAAoE,KAAK,CAAC,aAAa,mCAAmC,KAAK,CAAC,QAAQ,CAAC,MAAM,EAAE,CAClJ,CAAC;IACJ,CAAC;IAED,OAAO,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CACpC,KAAK,CAAC,OAAO,CAAC,6BAA6B,CAAC;QAC1C,OAAO;QACP,GAAG,CAAC,KAAK,CAAC,qBAAqB,KAAK,SAAS;YAC3C,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC,EAAE,qBAAqB,EAAE,KAAK,CAAC,qBAAqB,EAAE,CAAC;KAC5D,CAAC,CACH,CAAC;AACJ,CAAC"}

package/dist/selection/power-inference.d.ts

@@ -0,0 +1,20 @@
+import { type Power, PowerRecommendation } from '../schemas/power.js';
+import type { TraceEntry } from '../schemas/trace-entry.js';
+export interface ResolvedPowerInference {
+    readonly recommended: Power;
+    readonly rationale: string;
+    readonly resolved: Power;
+    readonly clamped: boolean;
+}
+export interface PowerInferenceChannel {
+    set(inference: ResolvedPowerInference): void;
+    get(): ResolvedPowerInference | undefined;
+}
+export declare function createPowerInferenceChannel(): PowerInferenceChannel;
+export declare function clampPowerToBounds(tier: Power, bounds: {
+    readonly floor: Power;
+    readonly ceiling: Power;
+}): Power;
+export declare function extractPowerRecommendation(report: unknown): PowerRecommendation | undefined;
+export declare function seedPowerInferenceFromTrace(entries: readonly TraceEntry[], channel: PowerInferenceChannel | undefined): void;
+//# sourceMappingURL=power-inference.d.ts.map

package/dist/selection/power-inference.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"power-inference.d.ts","sourceRoot":"","sources":["../../src/selection/power-inference.ts"],"names":[],"mappings":"AAqBA,OAAO,EAAE,KAAK,KAAK,EAAE,mBAAmB,EAAc,MAAM,qBAAqB,CAAC;AAClF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAE5D,MAAM,WAAW,sBAAsB;IAErC,QAAQ,CAAC,WAAW,EAAE,KAAK,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAE3B,QAAQ,CAAC,QAAQ,EAAE,KAAK,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,qBAAqB;IAGpC,GAAG,CAAC,SAAS,EAAE,sBAAsB,GAAG,IAAI,CAAC;IAE7C,GAAG,IAAI,sBAAsB,GAAG,SAAS,CAAC;CAC3C;AAED,wBAAgB,2BAA2B,IAAI,qBAAqB,CAUnE;AAED,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,KAAK,EACX,MAAM,EAAE;IAAE,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,KAAK,CAAA;CAAE,GACzD,KAAK,CAIP;AAQD,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,OAAO,GAAG,mBAAmB,GAAG,SAAS,CAM3F;AAKD,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,SAAS,UAAU,EAAE,EAC9B,OAAO,EAAE,qBAAqB,GAAG,SAAS,GACzC,IAAI,CAYN"}

package/dist/selection/power-inference.js

@@ -0,0 +1,74 @@
+// Auto-power inference — the run-scoped resolution of an `auto` dial setting.
+//
+// When the dial setting is `auto`, the run's effective power tier comes from
+// inside the run: the first accepted researcher report that carries a
+// `recommended_power` resolves it, clamped to the operator's `power_auto`
+// bounds. The resolution is set once, recorded as a `run.power-inference`
+// trace entry, and every later relay materializes against it. Before it
+// resolves (and on runs whose researcher never recommends), materialization
+// falls back to the default-on `medium` — auto never crashes a run and never
+// silently runs hotter than the ceiling.
+//
+// (Named "inference", not "auto-resolution": that term is taken by checkpoint
+// auto-resolution, an unrelated mechanism.)
+//
+// The channel mirrors the skill-hook injection channel's shape and lifecycle
+// (src/skill-hooks/injection.ts): a mutable run-scoped container on the
+// otherwise-readonly RunContext, mutated only at the post-step seam between
+// steps, read idempotently by relay planning, and reseeded from the trace on
+// checkpoint resume so a resumed run continues at the tier already resolved
+// instead of re-inferring.
+import { PowerRecommendation, powerIndex } from '../schemas/power.js';
+export function createPowerInferenceChannel() {
+    let resolved;
+    return {
+        set(inference) {
+            if (resolved === undefined)
+                resolved = inference;
+        },
+        get() {
+            return resolved;
+        },
+    };
+}
+export function clampPowerToBounds(tier, bounds) {
+    if (powerIndex(tier) < powerIndex(bounds.floor))
+        return bounds.floor;
+    if (powerIndex(tier) > powerIndex(bounds.ceiling))
+        return bounds.ceiling;
+    return tier;
+}
+// Field-tolerant read of a relay result body: a validated PowerRecommendation
+// at the top-level `recommended_power` key, or undefined for anything else
+// (absent key, malformed value, non-object body). Tolerance matters because
+// this runs against raw result JSON at the post-step seam, where the body has
+// already passed its flow schema but this module must not depend on any
+// flow's report type.
+export function extractPowerRecommendation(report) {
+    if (report === null || typeof report !== 'object')
+        return undefined;
+    const candidate = report.recommended_power;
+    if (candidate === undefined)
+        return undefined;
+    const parsed = PowerRecommendation.safeParse(candidate);
+    return parsed.success ? parsed.data : undefined;
+}
+// Checkpoint-resume reseed: replay the durable record into a fresh channel so
+// a resumed run continues at the already-resolved tier. Mirrors
+// seedSkillHookInjectionsFromTrace.
+export function seedPowerInferenceFromTrace(entries, channel) {
+    if (channel === undefined)
+        return;
+    for (const entry of entries) {
+        if (entry.kind !== 'run.power-inference')
+            continue;
+        channel.set({
+            recommended: entry.recommended,
+            rationale: entry.rationale,
+            resolved: entry.resolved,
+            clamped: entry.clamped,
+        });
+        return;
+    }
+}
+//# sourceMappingURL=power-inference.js.map

package/dist/selection/power-inference.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"power-inference.js","sourceRoot":"","sources":["../../src/selection/power-inference.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,EAAE;AACF,6EAA6E;AAC7E,sEAAsE;AACtE,0EAA0E;AAC1E,0EAA0E;AAC1E,wEAAwE;AACxE,4EAA4E;AAC5E,6EAA6E;AAC7E,yCAAyC;AACzC,EAAE;AACF,8EAA8E;AAC9E,4CAA4C;AAC5C,EAAE;AACF,6EAA6E;AAC7E,wEAAwE;AACxE,4EAA4E;AAC5E,6EAA6E;AAC7E,4EAA4E;AAC5E,2BAA2B;AAE3B,OAAO,EAAc,mBAAmB,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAoBlF,MAAM,UAAU,2BAA2B;IACzC,IAAI,QAA4C,CAAC;IACjD,OAAO;QACL,GAAG,CAAC,SAAS;YACX,IAAI,QAAQ,KAAK,SAAS;gBAAE,QAAQ,GAAG,SAAS,CAAC;QACnD,CAAC;QACD,GAAG;YACD,OAAO,QAAQ,CAAC;QAClB,CAAC;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,kBAAkB,CAChC,IAAW,EACX,MAA0D;IAE1D,IAAI,UAAU,CAAC,IAAI,CAAC,GAAG,UAAU,CAAC,MAAM,CAAC,KAAK,CAAC;QAAE,OAAO,MAAM,CAAC,KAAK,CAAC;IACrE,IAAI,UAAU,CAAC,IAAI,CAAC,GAAG,UAAU,CAAC,MAAM,CAAC,OAAO,CAAC;QAAE,OAAO,MAAM,CAAC,OAAO,CAAC;IACzE,OAAO,IAAI,CAAC;AACd,CAAC;AAED,8EAA8E;AAC9E,2EAA2E;AAC3E,4EAA4E;AAC5E,8EAA8E;AAC9E,wEAAwE;AACxE,sBAAsB;AACtB,MAAM,UAAU,0BAA0B,CAAC,MAAe;IACxD,IAAI,MAAM,KAAK,IAAI,IAAI,OAAO,MAAM,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAC;IACpE,MAAM,SAAS,GAAI,MAA0C,CAAC,iBAAiB,CAAC;IAChF,IAAI,SAAS,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC9C,MAAM,MAAM,GAAG,mBAAmB,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;IACxD,OAAO,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;AAClD,CAAC;AAED,8EAA8E;AAC9E,gEAAgE;AAChE,oCAAoC;AACpC,MAAM,UAAU,2BAA2B,CACzC,OAA8B,EAC9B,OAA0C;IAE1C,IAAI,OAAO,KAAK,SAAS;QAAE,OAAO;IAClC,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,IAAI,KAAK,CAAC,IAAI,KAAK,qBAAqB;YAAE,SAAS;QACnD,OAAO,CAAC,GAAG,CAAC;YACV,WAAW,EAAE,KAAK,CAAC,WAAW;YAC9B,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,OAAO,EAAE,KAAK,CAAC,OAAO;SACvB,CAAC,CAAC;QACH,OAAO;IACT,CAAC;AACH,CAAC"}

package/dist/selection/power-tiers.d.ts

@@ -0,0 +1,24 @@
+import type { LayeredConfig, PowerTierTable } from '../schemas/config.js';
+import { type Power } from '../schemas/power.js';
+import type { ResolvedSelection } from '../schemas/selection-policy.js';
+import type { RelayRole } from '../schemas/step.js';
+export declare const DEFAULT_POWER_TIERS: Readonly<Record<string, PowerTierTable>>;
+export type PowerDialResolution = {
+    readonly kind: 'fixed';
+    readonly value: Power;
+} | {
+    readonly kind: 'auto';
+    readonly floor: Power;
+    readonly ceiling: Power;
+};
+export declare function resolvePowerDialSetting(layers: readonly LayeredConfig[]): PowerDialResolution;
+export declare function resolvePowerDial(layers: readonly LayeredConfig[]): Power;
+export declare function materializePowerSelection(input: {
+    readonly resolved: ResolvedSelection;
+    readonly role: RelayRole;
+    readonly connectorName: string;
+    readonly attempt: number;
+    readonly configLayers?: readonly LayeredConfig[];
+    readonly inferredPower?: Power;
+}): ResolvedSelection;
+//# sourceMappingURL=power-tiers.d.ts.map

package/dist/selection/power-tiers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"power-tiers.d.ts","sourceRoot":"","sources":["../../src/selection/power-tiers.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,aAAa,EAAiB,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACzF,OAAO,EAAe,KAAK,KAAK,EAAqC,MAAM,qBAAqB,CAAC;AACjG,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AACxE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AASpD,eAAO,MAAM,mBAAmB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAWxE,CAAC;AAgCF,MAAM,MAAM,mBAAmB,GAC3B;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAA;CAAE,GACjD;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,KAAK,CAAA;CAAE,CAAC;AAE9E,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,SAAS,aAAa,EAAE,GAAG,mBAAmB,CAsB7F;AAOD,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,aAAa,EAAE,GAAG,KAAK,CAGxE;AAiBD,wBAAgB,yBAAyB,CAAC,KAAK,EAAE;IAC/C,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,CAAC;IACrC,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,YAAY,CAAC,EAAE,SAAS,aAAa,EAAE,CAAC;IAGjD,QAAQ,CAAC,aAAa,CAAC,EAAE,KAAK,CAAC;CAChC,GAAG,iBAAiB,CAsBpB"}

package/dist/selection/power-tiers.js

@@ -0,0 +1,115 @@
+import { POWER_ORDER, powerIndex } from '../schemas/power.js';
+// Shipped tier tables — release-reviewed data, never engine logic. The
+// anthropic entries use the Claude CLI's durable aliases (haiku/sonnet/opus)
+// so the table does not rot with model generations. The codex entries tier by
+// reasoning effort only — the OpenAI cost dial — and leave the model at the
+// operator's codex default, avoiding a pinned id that would rot. cursor-agent
+// and custom connectors ship no entry: the dial is inert there unless the
+// operator declares `power_tiers.<connector>` in config.
+export const DEFAULT_POWER_TIERS = {
+    'claude-code': {
+        low: { model: { provider: 'anthropic', model: 'haiku' } },
+        medium: { model: { provider: 'anthropic', model: 'sonnet' } },
+        high: { model: { provider: 'anthropic', model: 'opus' } },
+    },
+    codex: {
+        low: { effort: 'low' },
+        medium: { effort: 'medium' },
+        high: { effort: 'high' },
+    },
+};
+// Dial × role → tier. Judgment compounds, so the researcher stays on the big
+// tier at every dial position; the dial's main effect is execution (the
+// implementer), with review held one notch safer than execution at low.
+const ROLE_POWER_ALLOCATION = {
+    high: { researcher: 'high', implementer: 'high', reviewer: 'high' },
+    medium: { researcher: 'high', implementer: 'medium', reviewer: 'medium' },
+    low: { researcher: 'high', implementer: 'low', reviewer: 'medium' },
+};
+// Escalation is monotonic and capped: one tier up, never down, never past
+// the top. Attempt numbers are keyed per (step, slice), so attempt > 1 means
+// this same unit of work needed another try — slice advances restart at 1.
+function bumpOneTier(tier) {
+    return POWER_ORDER[Math.min(powerIndex(tier) + 1, POWER_ORDER.length - 1)];
+}
+// Layer precedence for dial and table reads. Same order the selection
+// resolver walks; declared here (not array order) so an out-of-order layers
+// array cannot invert precedence.
+const LAYER_PRECEDENCE = ['default', 'user-global', 'project', 'invocation'];
+function layersInPrecedenceOrder(layers) {
+    return LAYER_PRECEDENCE.flatMap((name) => layers.filter((layer) => layer.layer === name));
+}
+export function resolvePowerDialSetting(layers) {
+    let dial = 'medium';
+    for (const layer of layersInPrecedenceOrder(layers)) {
+        // Optional access: a zod-parsed Config always defaults these containers,
+        // but callers also hand layers built structurally (tests, embedders), and
+        // a missing container must read as "no opinion", not a crash.
+        const power = layer.config.defaults?.power;
+        if (power !== undefined)
+            dial = power;
+    }
+    if (dial !== 'auto')
+        return { kind: 'fixed', value: dial };
+    let floor = 'low';
+    let ceiling = 'high';
+    for (const layer of layersInPrecedenceOrder(layers)) {
+        const bounds = layer.config.power_auto;
+        if (bounds?.floor !== undefined)
+            floor = bounds.floor;
+        if (bounds?.ceiling !== undefined)
+            ceiling = bounds.ceiling;
+    }
+    // Schema validation rejects floor > ceiling inside one document, but two
+    // layers can compose into an inverted range. The ceiling is the spend cap,
+    // so it wins: the floor lowers to meet it rather than pushing spend up.
+    if (powerIndex(floor) > powerIndex(ceiling))
+        floor = ceiling;
+    return { kind: 'auto', floor, ceiling };
+}
+// The run's effective dial as a single tier, for callers with no inferred
+// tier to apply. An auto setting without an inference reads as the default-on
+// medium — never a crash, never a surprise high. (BREAKING vs the pre-flip
+// inert default: relays whose selection stack left the model unset now
+// materialize the medium-tier allocation for their role.)
+export function resolvePowerDial(layers) {
+    const setting = resolvePowerDialSetting(layers);
+    return setting.kind === 'fixed' ? setting.value : 'medium';
+}
+// Tier lookup: the highest-precedence layer that declares this connector+tier
+// wins; the shipped defaults fill anything config leaves unset.
+function tierSpec(layers, connectorName, tier) {
+    let spec = DEFAULT_POWER_TIERS[connectorName]?.[tier];
+    for (const layer of layersInPrecedenceOrder(layers)) {
+        const candidate = layer.config.power_tiers?.[connectorName]?.[tier];
+        if (candidate !== undefined)
+            spec = candidate;
+    }
+    return spec;
+}
+export function materializePowerSelection(input) {
+    // Explicit model config wins outright; the dial never overrides it.
+    if (input.resolved.model !== undefined)
+        return input.resolved;
+    const layers = input.configLayers ?? [];
+    const setting = resolvePowerDialSetting(layers);
+    // Auto before its inference resolves (the researcher's own relay, or a run
+    // whose researcher never recommended) materializes the default-on medium.
+    const dial = setting.kind === 'fixed' ? setting.value : (input.inferredPower ?? 'medium');
+    const allocated = ROLE_POWER_ALLOCATION[dial][input.role];
+    const tier = input.attempt > 1 ? bumpOneTier(allocated) : allocated;
+    const spec = tierSpec(layers, input.connectorName, tier);
+    if (spec === undefined)
+        return input.resolved;
+    return {
+        ...input.resolved,
+        ...(spec.model === undefined ? {} : { model: spec.model }),
+        ...(input.resolved.effort === undefined && spec.effort !== undefined
+            ? { effort: spec.effort }
+            : {}),
+        power: dial,
+        ...(tier === allocated ? {} : { power_escalated: true }),
+        ...(setting.kind === 'auto' ? { power_source: 'auto' } : {}),
+    };
+}
+//# sourceMappingURL=power-tiers.js.map

package/dist/selection/power-tiers.js.map

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

package/dist/selection/relay-selection.d.ts

@@ -0,0 +1,11 @@
+import { type LayeredConfig as LayeredConfigValue } from '../schemas/config.js';
+import type { CompiledDepth } from '../schemas/process.js';
+import type { ResolvedSelection } from '../schemas/selection-policy.js';
+import { type GuidanceSelectionFlow, type GuidanceSelectionStep } from './selection-resolver.js';
+type GuidanceSelectionConfig = {
+    readonly selectionConfigLayers?: readonly LayeredConfigValue[];
+    readonly bindsExecutionDepthToGuidanceSelection?: boolean;
+};
+export declare function deriveResolvedSelection(inv: GuidanceSelectionConfig, flow: GuidanceSelectionFlow, step: GuidanceSelectionStep, depth: CompiledDepth): ResolvedSelection;
+export {};
+//# sourceMappingURL=relay-selection.d.ts.map

package/dist/selection/relay-selection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"relay-selection.d.ts","sourceRoot":"","sources":["../../src/selection/relay-selection.ts"],"names":[],"mappings":"AAKA,OAAO,EAGL,KAAK,aAAa,IAAI,kBAAkB,EACzC,MAAM,sBAAsB,CAAC;AAE9B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AACxE,OAAO,EACL,KAAK,qBAAqB,EAC1B,KAAK,qBAAqB,EAE3B,MAAM,yBAAyB,CAAC;AAEjC,KAAK,uBAAuB,GAAG;IAC7B,QAAQ,CAAC,qBAAqB,CAAC,EAAE,SAAS,kBAAkB,EAAE,CAAC;IAC/D,QAAQ,CAAC,sCAAsC,CAAC,EAAE,OAAO,CAAC;CAC3D,CAAC;AAsDF,wBAAgB,uBAAuB,CACrC,GAAG,EAAE,uBAAuB,EAC5B,IAAI,EAAE,qBAAqB,EAC3B,IAAI,EAAE,qBAAqB,EAC3B,KAAK,EAAE,aAAa,GACnB,iBAAiB,CAMnB"}

package/dist/selection/relay-selection.js

@@ -0,0 +1,57 @@
+// Guidance selection derivation.
+//
+// Most flows resolve relay model and effort from config and step metadata only.
+// The runtime may pass a flow-owned flag when a run's effective depth should be
+// threaded into selection input.
+import { Config, LayeredConfig, } from '../schemas/config.js';
+import { resolveSelectionForGuidanceInput, } from './selection-resolver.js';
+function bindsExecutionDepthToGuidanceSelection(inv) {
+    return inv.bindsExecutionDepthToGuidanceSelection === true;
+}
+function guidanceSelectionConfigLayersWithExecutionDepth(inv, flow, depth) {
+    const layers = [...(inv.selectionConfigLayers ?? [])];
+    const flowId = flow.id;
+    const existingIndex = layers.findIndex((layer) => layer.layer === 'invocation');
+    const existing = existingIndex === -1 ? undefined : layers[existingIndex];
+    const baseConfig = existing?.config ?? Config.parse({ schema_version: 1 });
+    const existingCircuit = baseConfig.flows[flowId];
+    const selection = {
+        ...(existingCircuit?.selection ?? {}),
+        depth,
+    };
+    const invocationLayer = LayeredConfig.parse({
+        layer: 'invocation',
+        ...(existing?.source_path === undefined ? {} : { source_path: existing.source_path }),
+        config: {
+            ...baseConfig,
+            flows: {
+                ...baseConfig.flows,
+                [flowId]: {
+                    ...(existingCircuit ?? {}),
+                    selection,
+                },
+            },
+        },
+    });
+    if (existingIndex === -1) {
+        layers.push(invocationLayer);
+    }
+    else {
+        layers[existingIndex] = invocationLayer;
+    }
+    return layers;
+}
+function selectionConfigLayersForGuidanceInput(inv, flow, depth) {
+    if (!bindsExecutionDepthToGuidanceSelection(inv)) {
+        return inv.selectionConfigLayers ?? [];
+    }
+    return guidanceSelectionConfigLayersWithExecutionDepth(inv, flow, depth);
+}
+export function deriveResolvedSelection(inv, flow, step, depth) {
+    return resolveSelectionForGuidanceInput({
+        flow,
+        step,
+        configLayers: selectionConfigLayersForGuidanceInput(inv, flow, depth),
+    }).resolved;
+}
+//# sourceMappingURL=relay-selection.js.map