/** Flat CLI/MCP fields that map to AgentActionTraceability. */
export type AgentTraceabilityFields = {
    workflowId?: string;
    workflowExecutionId?: string;
    policyFile?: string;
    policyVersion?: string;
    gitSha?: string;
    actorType?: string;
    userId?: string;
    branchName?: string;
    agentModel?: string;
    skillVersion?: string;
    cliVersion?: string;
    /** Nested form (wins over flat when both present and non-empty). */
    agentTraceability?: Record<string, unknown>;
};
/**
 * Resolve skill / CLI versions for traceability payloads.
 * CLI version defaults to this package's version; skill version from flag/env only.
 */
export declare function resolveToolchainVersions(a: {
    skillVersion?: string;
    cliVersion?: string;
    nested?: Record<string, unknown> | null;
}): {
    skillVersion?: string;
    cliVersion?: string;
};
/**
 * Build camelCase AgentActionTraceability for MCP JSON bodies.
 * Returns undefined unless the caller supplied explicit traceability intent
 * **and** a non-empty workflowId (server requires workflow_id for inline Activity).
 * For Activity/timeline attachment the server also requires workflowExecutionId
 * (stable Plan ULID for the whole run) — omit it and the mutation still succeeds
 * but no workflow_executions / Activity row is recorded (server does not auto-mint).
 * Auto-fills gitSha / agentModel / userId / cliVersion only after the workflowId bar is met.
 * Non-empty nested `agentTraceability` wins over flat for overlapping keys.
 */
export declare function buildAgentTraceabilityPayload(a: AgentTraceabilityFields): Record<string, unknown> | undefined;