import type { Loop, LoopRun, WorkflowSpec } from "../../types.js";
import type { Goal, GoalExecutionContext, GoalPlanNode } from "./types.js";
export interface GoalContextParts {
    loop?: Pick<Loop, "id" | "name">;
    loopRun?: Pick<LoopRun, "id" | "scheduledFor">;
    scheduledFor?: string;
    workflow?: Pick<WorkflowSpec, "id" | "name">;
    workflowRunId?: string;
    workflowStepId?: string;
}
/** Single source for the goal execution context previously copy-pasted across runners. */
export declare function goalExecutionContext(parts: GoalContextParts): GoalExecutionContext;
/** Executor metadata (LOOPS_* env) derived from a goal execution context; loopRunId maps to runId. */
export declare function executionMetadata(context: GoalExecutionContext | undefined, goal?: Pick<Goal, "goalId" | "objective">, node?: Pick<GoalPlanNode, "key">): Record<string, string | undefined>;
/** Exposes the executing plan node to child processes so command targets can honor node objectives. */
export declare function withGoalNodeEnv(env: NodeJS.ProcessEnv | undefined, node: Pick<GoalPlanNode, "key" | "objective">): NodeJS.ProcessEnv;