agentic-engineering-harness 0.8.6 → 0.8.8

package/dist/current

@@ -1 +1 @@
-release-1790879543582-15028-5511fea8
+release-1790896196283-15710-31ca87e8

package/dist/releases/release-1790896171560-15571-736bf3d2/agents/plannerWorkGraphCorrection.d.ts

@@ -0,0 +1,21 @@
+import type { TaskContract } from "../core/types.js";
+import { type WorkGraphV1 } from "../architecture/workGraph.js";
+import { type PlannerOutput } from "./outputContracts.js";
+export declare class PlannerWorkGraphCorrectionError extends Error {
+    readonly validationIssues: string[];
+    readonly correctionAttempts: 0 | 1;
+    constructor(message: string, validationIssues: string[], correctionAttempts: 0 | 1);
+}
+export declare function compilePlannerWorkGraph(contract: TaskContract, plan: PlannerOutput): WorkGraphV1;
+/** Validate a model Planner result at the WorkGraph boundary and permit one compact correction. */
+export declare function compilePlannerWorkGraphWithOneCorrection(input: {
+    contract: TaskContract;
+    plan: PlannerOutput;
+    requestCorrection?: (prompt: string) => Promise<unknown>;
+}): Promise<{
+    plan: PlannerOutput;
+    graph: WorkGraphV1;
+    correctionAttempts: 0 | 1;
+}>;
+export declare function plannerWorkGraphValidationIssues(error: unknown, plan: PlannerOutput): string[];
+export declare function buildPlannerWorkGraphCorrectionPrompt(plan: PlannerOutput, issues: readonly string[]): string;

package/dist/releases/release-1790896171560-15571-736bf3d2/agents/plannerWorkGraphCorrection.js

@@ -0,0 +1,90 @@
+import { createWorkGraph } from "../architecture/workGraph.js";
+import { plannerOutputSchema } from "./outputContracts.js";
+const MAX_CORRECTION_PAYLOAD_BYTES = 24_000;
+export class PlannerWorkGraphCorrectionError extends Error {
+    validationIssues;
+    correctionAttempts;
+    constructor(message, validationIssues, correctionAttempts) {
+        super(message);
+        this.validationIssues = validationIssues;
+        this.correctionAttempts = correctionAttempts;
+        this.name = "PlannerWorkGraphCorrectionError";
+    }
+}
+export function compilePlannerWorkGraph(contract, plan) {
+    return createWorkGraph({
+        taskId: contract.task.id,
+        objective: contract.task.title,
+        route: contract.routing?.route ?? "DELEGATED",
+        assurance: contract.routing?.assurance ?? "STANDARD",
+        requirementRefs: (contract.requirements ?? []).map((item) => item.id),
+        acceptanceRefs: plan.workUnits.flatMap((unit) => unit.acceptanceRefs),
+        units: plan.workUnits.map((unit) => ({ ...unit, version: 1, status: "PENDING" }))
+    });
+}
+/** Validate a model Planner result at the WorkGraph boundary and permit one compact correction. */
+export async function compilePlannerWorkGraphWithOneCorrection(input) {
+    try {
+        return { plan: input.plan, graph: compilePlannerWorkGraph(input.contract, input.plan), correctionAttempts: 0 };
+    }
+    catch (firstError) {
+        const firstIssues = plannerWorkGraphValidationIssues(firstError, input.plan);
+        if (!input.requestCorrection) {
+            throw new PlannerWorkGraphCorrectionError(`Planner WorkGraph rejected; corrective retry unavailable: ${firstIssues.join("; ")}`, firstIssues, 0);
+        }
+        const correctionPrompt = buildPlannerWorkGraphCorrectionPrompt(input.plan, firstIssues);
+        let corrected;
+        try {
+            corrected = plannerOutputSchema.parse(await input.requestCorrection(correctionPrompt));
+        }
+        catch (error) {
+            const issues = [`corrective Planner output did not satisfy plannerOutputSchema: ${errorMessage(error)}`];
+            throw new PlannerWorkGraphCorrectionError(`Planner WorkGraph correction failed closed: ${issues.join("; ")}`, issues, 1);
+        }
+        try {
+            return { plan: corrected, graph: compilePlannerWorkGraph(input.contract, corrected), correctionAttempts: 1 };
+        }
+        catch (secondError) {
+            const issues = plannerWorkGraphValidationIssues(secondError, corrected);
+            throw new PlannerWorkGraphCorrectionError(`Planner WorkGraph remained invalid after one corrective retry: ${issues.join("; ")}`, issues, 1);
+        }
+    }
+}
+export function plannerWorkGraphValidationIssues(error, plan) {
+    const issues = error && typeof error === "object" && Array.isArray(error.issues)
+        ? error.issues
+        : undefined;
+    if (!issues?.length)
+        return [errorMessage(error)];
+    return issues.map((issue) => {
+        const path = Array.isArray(issue.path) ? issue.path : [];
+        const unitIndex = path[0] === "units" && typeof path[1] === "number" ? path[1] : undefined;
+        if (unitIndex !== undefined && path[2] === "objective" && issue.maximum === 500) {
+            const unit = plan.workUnits[unitIndex];
+            const length = typeof unit?.objective === "string" ? unit.objective.length : undefined;
+            return `workUnits[${unitIndex}]${unit?.id ? ` (${unit.id})` : ""}.objective exceeds maximum 500 characters${length === undefined ? "" : ` (received ${length})`}.`;
+        }
+        const pathText = path.length ? path.join(".") : "root";
+        return `${pathText}: ${typeof issue.message === "string" ? issue.message : "invalid value"}`;
+    });
+}
+export function buildPlannerWorkGraphCorrectionPrompt(plan, issues) {
+    const prior = JSON.stringify(plan);
+    if (Buffer.byteLength(prior, "utf8") > MAX_CORRECTION_PAYLOAD_BYTES) {
+        throw new PlannerWorkGraphCorrectionError("Planner WorkGraph correction failed closed: prior structured result exceeds the 24000-byte correction bound.", ["prior structured result exceeds 24000 bytes"], 0);
+    }
+    return [
+        "Correct this structured Planner result. It passed plannerOutputSchema but deterministic WorkGraph validation rejected it.",
+        "Fix only the listed validation errors. Preserve all other fields, IDs, dependencies, requirement references, acceptance references, scope and meaning. Do not truncate strings, widen scope, add requirements, or select agents, tools, validators or commands.",
+        "Return the complete Planner object in the existing schema. No repository discovery or request context is needed.",
+        "Deterministic validation errors:",
+        ...issues.map((issue) => `- ${issue}`),
+        "Prior structured Planner result:",
+        prior,
+        "Final line: AEH_RESULT_JSON=<corrected planner object>"
+    ].join("\n\n");
+}
+function errorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+//# sourceMappingURL=plannerWorkGraphCorrection.js.map

package/dist/releases/release-1790896171560-15571-736bf3d2/agents/plannerWorkGraphCorrection.js.map

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

package/dist/releases/release-1790896171560-15571-736bf3d2/agents/waveExecutor.d.ts

@@ -0,0 +1,74 @@
+import type { AgentExecutionSelection } from "./types.js";
+import { type ParallelismPlan } from "./parallelism.js";
+import { type PlannerOutput, type WorkUnitOutput } from "./outputContracts.js";
+import type { ControlPlaneSnapshot } from "../core/controlPlane.js";
+import type { HarnessProjectConfig, TaskContract, ValidationReport, WorkerSession } from "../core/types.js";
+import { type ExecutionBlueprint, type ParticipantAssignmentV1 } from "../architecture/participantPlan.js";
+import type { ExecutionCatalogV1 } from "../architecture/executionCatalog.js";
+import type { CandidateImpactAssessmentRuntimeV1, CandidateImpactV1, ChangeSetV1 } from "../candidates/assembler.js";
+import type { CandidateRevisionV1 } from "../operations/v2Contracts.js";
+import { resolveKnowledgeGate, type KnowledgeCacheV1, type KnowledgeLookupResultV1, type KnowledgeModeV1, type KnowledgePackV1, type KnowledgeResolutionV1 } from "../knowledge/index.js";
+import type { ProjectStackProfileV1 } from "../participants/stack.js";
+export interface DelegationExecutionResult {
+    task: WorkUnitOutput;
+    session: WorkerSession;
+    changedFiles: string[];
+    patch: string;
+    status: "PASS" | "FAIL";
+    message?: string;
+    distributed?: boolean;
+    candidate?: CandidateRevisionV1;
+    impact?: CandidateImpactV1;
+    changeSet?: ChangeSetV1;
+}
+export interface WaveExecutionSummary {
+    wave: number;
+    taskIds: string[];
+    status: "PASS" | "FAIL";
+    results: DelegationExecutionResult[];
+    barrier?: ValidationReport;
+}
+export interface PlannerWaveResult {
+    used: boolean;
+    plan?: PlannerOutput;
+    blueprint?: ExecutionBlueprint;
+    schedule?: ParallelismPlan;
+    waves: WaveExecutionSummary[];
+    sessions: WorkerSession[];
+    aggregateSession?: WorkerSession;
+    report?: ValidationReport;
+    preExecutionFailure?: boolean;
+    correctionAttempts?: 0 | 1;
+}
+export declare function executePlannerWaves(input: {
+    root: string;
+    stateRoot: string;
+    config: HarnessProjectConfig;
+    contract: TaskContract;
+    plannerSelection?: AgentExecutionSelection;
+    librarianSelection?: AgentExecutionSelection;
+    implementationSelection: AgentExecutionSelection;
+    executionCatalog: ExecutionCatalogV1;
+    controller?: ControlPlaneSnapshot;
+    precomputedPlan?: PlannerOutput;
+    semanticAssessment?: CandidateImpactAssessmentRuntimeV1;
+    projectStack?: ProjectStackProfileV1;
+    knowledgeMode?: KnowledgeModeV1;
+    knowledgeCache?: KnowledgeCacheV1;
+    knowledgeResolutions?: readonly KnowledgeResolutionV1[];
+    knowledgeLookup?: (gap: Parameters<NonNullable<Parameters<typeof resolveKnowledgeGate>[0]["lookup"]>>[0]) => Promise<KnowledgePackV1 | KnowledgeLookupResultV1>;
+    revalidate: () => Promise<ValidationReport>;
+}): Promise<PlannerWaveResult>;
+export declare function resolvePlannerKnowledge(plan: PlannerOutput, input: Pick<Parameters<typeof executePlannerWaves>[0], "contract" | "root" | "config" | "librarianSelection" | "knowledgeMode" | "knowledgeCache" | "knowledgeResolutions" | "knowledgeLookup"> & Partial<Pick<Parameters<typeof executePlannerWaves>[0], "stateRoot">>): Promise<KnowledgeResolutionV1[]>;
+export declare function validatePlannerWavePlan(contract: TaskContract, plan: PlannerOutput): string[];
+export declare function selectionForParticipant(base: AgentExecutionSelection, assignment: ParticipantAssignmentV1, catalog: ExecutionCatalogV1): AgentExecutionSelection;
+/**
+ * AEH-V2-0129: `workflow.planning.worktreeIsolation` defaults to true and is honored by per-unit
+ * candidate worktrees. When it is explicitly disabled, same-workspace writers are serialized
+ * deterministically (one work unit at a time) instead of running parallel writers, because
+ * DELEGATED candidate assembly always captures one ChangeSet per unit.
+ */
+export declare function waveConcurrencyV1(planning: {
+    worktreeIsolation?: boolean;
+    maxWaveConcurrency?: number;
+} | undefined, taskCount: number): number;